技术文档 · 模块
镜像 internal/ 的模块视图：每模块一节（数据模型 / 接口 / 时序），粒度细于 DESIGN 总览，与实现一一对应。
| 模块 | 定位 | 领域 |
|---|---|---|
| user | 注册/登录/鉴权 + 地址簿 | 基础 |
| product | 类目 / 商品（SPU）/ SKU 与库存 | 商品域 |
| cart | 购物车（条目引用 SKU） | 商品域 |
| order | 下单/订单状态机/超时取消 | 交易域 |
| flashsale | 秒杀活动/预扣/异步落单/对账 | 交易域 + 运营域 |
| payment | 模拟支付回调驱动状态流转 | 交易域 |
| coupon | 券模板/领券防超发/核销与回退 | 交易域 |
| social | 好友关系 + 好友圈动态 | 社交域 |
| chat | 会话/消息/实时推送（WS） | 通信域 |
| platform | 共享基础设施（config/logger/metrics/auth/limiter/cors/cron/mq/cache/ws/file） | 基础 |
模块化单体约定
- 模块间经 service 接口进程内调用（面向接口，非 HTTP），依赖方向无环（DAG，见 DESIGN 依赖图；仅秒杀落单走 MQ 异步）
- 跨模块写经 tx 参数汇入同一事务（下单事务 = 订单 + 订单项 + 库存 + 地址快照 + 券核销 + 清购物车）
- 跨模块端口按"调用方声明最小接口"组织；跨模块事务由依赖上游编排，例如 flashsale 持有 order 的事务内最小接口来组合订单写入与活动库存变更，order 不反向持有 flashsale（单向依赖，无环）
- admin 管理入口按模块内嵌（product/order/flashsale/coupon 的 admin 路由 + role 鉴权），不单独成模块
- 权威源：
docs/DESIGN.md与各模块实现（internal/），本目录只放摘要与链接 - 部署（本地 Nginx SSL / Cloudflare Pages / 后端平台选型）见 docs/DEPLOYMENT.md 与 ADR-0005