Chengdong Zhang
a7cd392bd4
- payment domain: payments/memberships/attempts/receipts/refunds/commands/events, legacy-demo provenance (0024), checkout header-hash idempotency (0025) - wallet collection all-or-none across shop orders; group-wide cancellation; checkout cutover, status-only payOrder removed - Stripe crypto-only Checkout adapter, raw-body HMAC webhooks, durable command worker with leases - original-method refunds with receipt/allocation budgets; refund_pending/refund_failed aftersale states - admin channel CRUD/revisions/audit/verify + operations list/detail/reconcile; secret-ref allowlist (VMALL_PAYMENT_*), env-fixed demo/sandbox/live - mall/mobile checkout pay surfaces, admin console pages; shared contract updated - pre-launch leftovers recorded in docs/TBD-payments.md cargo test -p vmall-api green twice; four frontend builds green; browser smoke: mall wallet checkout paid, admin channels/operations verified
3.3 KiB
3.3 KiB
Index: Order & Freight
Domain design: docs/domains/orders.md. Specs: openspec/specs/order/,
shipment/, shipping/, payment/ (change add-configurable-payments).
Backend (apps/api)
| File | Holds |
|---|---|
src/modules/order/service.rs |
checkout transaction (payment membership + header-hash idempotency), cancel, shipping quote |
src/modules/order/repo.rs |
ORDER_COLS/ORDER_ITEM_COLS, insert_order/insert_item, locks, status transitions |
src/modules/order/handlers.rs |
/orders* customer routes, /shop/orders*, /admin/orders |
src/modules/order/dto.rs |
OrderView, AddressBody, ShippingQuoteView |
src/modules/payment/service.rs |
payment resolution, eligible methods, attempts, wallet collection, group cancellation |
src/modules/payment/repo.rs |
payments/memberships/checkout_requests/attempts/receipts/refunds/commands/events rows |
src/modules/payment/adapters.rs |
wallet + Stripe crypto-only Checkout adapter boundary, capabilities |
src/modules/payment/worker.rs |
durable command lease/execute/recovery, supervised worker |
src/modules/payment/webhooks.rs |
raw-body Stripe signature/timestamp verification, dedup inbox |
src/modules/payment/refunds.rs |
original-method refund budgets, wallet/Stripe refund submission |
src/modules/payment/admin.rs |
channel CRUD/revisions/audit/verify, operations list/detail, reconcile |
src/modules/payment/handlers.rs |
/payments* owner routes, /admin/payments*, /payments/webhooks/stripe/{id} |
src/modules/payment/dto.rs |
payment DTOs, text enums, config shapes |
src/modules/fulfillment/ |
shipments: create (company-validated), ship, confirm-delivered |
src/modules/freight/service.rs |
template CRUD, region rules, shop_fee() calculation, company dictionary |
src/modules/freight/handlers.rs |
/shop/freight-templates*, /shipping/companies |
migrations/0004_orders.sql |
orders/order_items/shipments base schema |
migrations/0017_freight_templates.sql |
freight tables, orders.shipping_fee_minor, item snapshots, skus.weight_grams |
migrations/0024_payments.sql |
payments domain, legacy-demo provenance, aftersale refund states |
migrations/0025_checkout_request_header_hash.sql |
cart-independent header hash for checkout idempotency |
tests/orders.rs, tests/freight.rs, tests/payments.rs |
integration coverage |
Shared contract (packages/shared/src)
types.ts: Order, OrderItem, Shipment, FreightTemplate*,
ShippingCompany, ShippingQuote, Payment, CheckoutResult,
PaymentAttemptResult, EligibleMethod, NextAction, PaymentChannel*,
PaymentOperation*, RefundOperation. api.ts: checkout,
resolvePayment, getPayment, listPaymentMethods, createPaymentAttempt,
cancelPayment, quoteShipping, listShippingCompanies, shop freight CRUD,
createShipment, admin channel/operations/reconcile methods.
Frontends
- Mall:
pages/checkout/{index,pay,success}.vue,pages/user/orders/,pages/user/addresses.vue - Mobile:
pages/checkout/,pages/orders/(configured payment + return handling) - Shop-admin:
pages/orders/,pages/shipments.vue,pages/freight-templates.vue,components/ProductForm.vue(freight template + SKU weight) - Admin:
pages/orders.vue(read-only),pages/payment-channels.vue,pages/payments.vue(operations list/detail/reconcile)