kate522
ba8d4b1b90
此前卡密核销虽已建订单，但订单号硬编码 CARD{卡ID}、渠道交易号硬编码
card_pass_{卡ID}，均不受后台前缀控制；且核销产生的资金流水没有挂到
订单上（order_number 为 NULL），订单详情页的「支付流水号」恒为「—」。
ChargeCard：
- 新增 allocate_redeem_order_number()：走 OrderRepository 统一分配器，
消费后台「订单前缀」（payment_order_prefix）。
- 新增 card_pass_transaction_number()：BusinessNumber::candidate(flow_prefix)，
消费后台「流水号前缀」（payment_flow_prefix）。
- 两条兑换路径（redeem_asset_card / redeem_vip_card）替换硬编码取号；
create_redeem_order 接收调用方传入的交易号。
- 账本重放（replayed）时回取已落库订单号，不再把本次新分配的号回给前端。
FinancialFlowService：
- record_card_pass_payment()：会员卡（0 元、无账本参与）直接落一条
与订单关联、零分录的 order_payment 流水；record() 新增
allow_empty_entries 通道（prepare_entries 拒绝 delta=0，占位分录不可行）。
- record_order_event() 新增凭证结算模式：豁免「金额必须 > 0」与
「资产类订单不得记现金流水」两条门槛（卡密核销既无第三方现金流入，
订单还可能为 0 元或以积分计价）。
- attach_order_to_ledger_flow()：账本提交后把流水补挂到订单上，
event_type 归一为 order_payment，使「支付流水号」可反查。
- is_successful_order_payment() 认可 card_pass 凭证结算；
is_external_recharge() 把 card_pass 与 balance/points 一并列为平台内部
结算方式，不再为卡密充值伪造现金出账分录（现金在售卡时已确认）。
关键取舍：随机订单号不得进入 LedgerCommand 的 metadata —— payload_hash
覆盖 metadata，会破坏账本幂等重放（实测撞 uniq_operation_key 后报
aksrt_ledger_idempotency_conflict），因此订单关联改在账本提交后补挂。
测试：新增 tests/admin/card-pass-order-numbers.test.cjs 钉住上述约束；
容器内三类卡密实测通过（订单号/渠道交易号/支付流水号三项均带后台前缀，
流水行分别携带 balance:in / points:in / 零分录），重放幂等恢复正常。
103 lines
3.6 KiB
Plaintext
103 lines
3.6 KiB
Plaintext
# Repository metadata and local agent workspaces
|
|
/.git/
|
|
/.claude/
|
|
/.compare/
|
|
/.zcode/
|
|
/.mimosa/
|
|
|
|
# Project planning, internal docs, and local-only development files
|
|
/.aksrt-chrome-profile/
|
|
/.specs/
|
|
/docs/
|
|
/tools/*
|
|
!/tools/build-public-assets.mjs
|
|
/tests/*
|
|
!/tools/wp-cli-visual-fixtures.php
|
|
!/tests/fixtures/
|
|
!/tests/visual/
|
|
/tests/fixtures/*
|
|
!/tests/fixtures/page-visual-matrix-v1.json
|
|
!/tests/widget-system/
|
|
/tests/widget-system/*
|
|
!/tests/widget-system/post-editor-reference-contract.test.cjs
|
|
!/tests/widget-system/post-visual-contract.test.cjs
|
|
!/tests/widget-system/lazyload-contract.test.cjs
|
|
!/tests/widget-system/toast-contract.test.cjs
|
|
!/tests/widget-system/page-display-contract.test.cjs
|
|
!/tests/widget-system/icon-card-contract.test.cjs
|
|
!/tests/widget-system/page-display-save-harness.php
|
|
!/tests/widget-system/admin-ui-contract.test.cjs
|
|
!/tests/widget-system/email-system-contract.test.cjs
|
|
!/tests/widget-system/auth-source-contract.test.cjs
|
|
!/tests/widget-system/captcha-business-contract.test.cjs
|
|
!/tests/widget-system/captcha-security-harness.php
|
|
!/tests/widget-system/captcha-runtime-harness.test.cjs
|
|
!/tests/widget-system/oauth-security-contract.test.cjs
|
|
!/tests/widget-system/oauth-security-harness.php
|
|
!/tests/widget-system/user-badges-contract.test.cjs
|
|
!/tests/widget-system/user-features-contract.test.cjs
|
|
!/tests/widget-system/zibll-modern-widgets-contract.test.cjs
|
|
!/tests/widget-system/user-card-runtime-contract.test.cjs
|
|
!/tests/widget-system/user-card-runtime-harness.php
|
|
!/tests/widget-system/notification-preferences-contract.test.cjs
|
|
!/tests/widget-system/message-center-contract.test.cjs
|
|
!/tests/widget-system/message-center-url-harness.php
|
|
!/tests/widget-system/message-center-pagination-harness.php
|
|
!/tests/widget-system/asset-ledger-contract.test.cjs
|
|
!/tests/widget-system/financial-flow-contract.test.cjs
|
|
!/tests/widget-system/user-assets-layout-contract.test.cjs
|
|
!/tests/widget-system/pay-orders-filter-contract.test.cjs
|
|
!/tests/widget-system/front-submit-editor-contract.test.cjs
|
|
!/tests/widget-system/front-submit-attachment-contract.test.cjs
|
|
!/tests/widget-system/comment-smilies-removal-contract.test.cjs
|
|
!/tests/widget-system/comment-children-list-reset-contract.test.cjs
|
|
!/tests/widget-system/comment-image-upload-contract.test.cjs
|
|
!/tests/widget-system/pay-card-contract.test.cjs
|
|
!/tests/widget-system/circular-button-icon-margin-contract.test.cjs
|
|
!/tests/widget-system/single-cover-height-contract.test.cjs
|
|
!/tests/widget-system/frontend-lifecycle-contract.test.cjs
|
|
!/tests/admin/
|
|
/tests/admin/*
|
|
!/tests/admin/charge-cards-page-contract.test.cjs
|
|
!/tests/admin/charge-cards-dependency.test.cjs
|
|
!/tests/admin/charge-cards-pagination.test.cjs
|
|
!/tests/admin/charge-cards-form-constraints.test.cjs
|
|
!/tests/admin/card-pass-order-numbers.test.cjs
|
|
!/tests/front-submit/
|
|
/tests/front-submit/*
|
|
!/tests/front-submit/video-cover-contract.test.cjs
|
|
!/tests/front-submit/featured-buttons-contract.test.cjs
|
|
!/tests/front-submit/editor-fullscreen-contract.test.cjs
|
|
!/tests/asset-ledger/
|
|
!/tests/asset-ledger/*.php
|
|
!/tests/visual/docker-compose.zibll.yml
|
|
!/tests/visual/zibll-Caddyfile
|
|
!/tests/visual/README.md
|
|
/CLAUDE.md
|
|
/AGENTS.md
|
|
ask-*.md
|
|
!assets/css/routes/docs/
|
|
assets/css/routes/docs/*
|
|
!assets/css/routes/docs/toolbar-search-enhancements.css
|
|
|
|
# Frontend build output and installed dependencies.
|
|
# assets/admin/build is deploy-only: build it on the target with
|
|
# cd assets/admin && npm ci && npm run build
|
|
/assets/admin/node_modules/
|
|
/assets/admin/build/*
|
|
!/assets/admin/build/.gitkeep
|
|
assets/admin/.vite-temp/
|
|
|
|
# PHP installed dependencies
|
|
/vendor/*
|
|
!/vendor/.gitkeep
|
|
|
|
# Temporary / recovery helpers
|
|
restore-helper-monoliths.php
|
|
/.phpunit.cache/
|
|
|
|
# OS / editor noise
|
|
.DS_Store
|
|
Thumbs.db
|
|
*.log
|