docs: 补充项目分析并更新 README 目录结构

- 新增 docs/项目分析.md:项目定位、架构、数据模型、业务流、工程质量、
  两轮优化记录(含验证证据)与遗留问题清单
- README 目录结构同步现有包(cmd/*、internal/database、testdb、store 等),
  并说明 service 包按 delivery_*/rock_*/merchant_*/provider_* 前缀成组
This commit is contained in:
yml2213
2026-10-06 19:43:51 +08:00
parent 44ec142395
commit 14d297a591
2 changed files with 372 additions and 15 deletions
+33 -15
View File
@@ -194,21 +194,39 @@ POST /api/open/v1/orders/ship-notify
```
├── backend/
│ ├── cmd/server/main.go # 入口
│ ├── cmd/
│ │ ├── server/ # 服务入口
│ │ ├── reencrypt_secrets/ # 密钥轮换:重加密落库密文
│ │ ├── cache_images/ # 商品图本地缓存工具
│ │ └── sync_product_images/ # 商品图同步工具
│ └── internal/
│ ├── config/ # 配置加载
│ ├── handler/ # HTTP 处理器
│ ├── middleware/ # JWT 认证、签名验证
│ ├── model/ # 数据模型
│ ├── pkg/ # 工具包
│ ├── router/ # 路由
│ └── service/ # 业务逻辑
│ ├── config/ # 配置加载 + 启动安全体检
│ ├── database/ # 显式 SQL 迁移(embed + checksum)
│ │ └── migrations/ # 001~012 迁移脚本,已执行版本不可修改
│ ├── handler/ # HTTP 处理器:merchant_* / open_* / recharge / rock …
│ ├── middleware/ # JWT / 商户签名 / 源头签名 / 功能与权限门禁
│ ├── model/ # 数据模型:merchant / recharge / rock / models
│ ├── pkg/ # 工具包:applog / openlog / jwt / response / timeutil / lewan
│ ├── router/ # 路由注册与请求日志
│ ├── service/ # 业务逻辑
│ │ ├── fulfillment* # 订单状态机、下单幂等、超时巡检
│ │ ├── delivery* # 提货页 BFF:查询 / 绑定 / 提交 / 链接
│ │ ├── provider* # 履约渠道接口与路由(DLC / 乐玩 / Rock)
│ │ ├── rock_* # Rock 库存池、UID 强一致门禁、绑错追溯
│ │ ├── merchant* # 商户、商品目录、成员与角色
│ │ └── recharge / callback / user / tenant
│ └── testdb/ # 集成测试用 PostgreSQL 临时 schema
├── frontend/src/
│ ├── api/ # API 调用
│ ├── pages/ # 页面组件
│ ├── layouts/ # 布局
│ └── types/ # 类型定义
├── docker-compose.yml # 容器编排
├── Makefile # 常用命令
└── start.sh # 开发一键启动
│ ├── api/ # API 调用
│ ├── pages/ # 页面组件(platformRock/ 为 Rock 大屏拆出的子组件)
│ ├── layouts/ # 布局
│ ├── store/ # 登录态与租户上下文
│ └── types/ # 类型定义
├── docs/ # 对接文档、实施方案与项目分析
├── docker-compose.yml # 容器编排
├── Makefile # 常用命令(dev / test / lint / fmt / docker-*)
└── start.sh # 开发一键启动
```
> `service` 包按 `delivery_*` / `rock_*` / `merchant_*` / `provider_*` 前缀成组,
> 单个文件保持在 300 行以内,便于按业务域定位。