docs: 补充项目分析并更新 README 目录结构
- 新增 docs/项目分析.md:项目定位、架构、数据模型、业务流、工程质量、 两轮优化记录(含验证证据)与遗留问题清单 - README 目录结构同步现有包(cmd/*、internal/database、testdb、store 等), 并说明 service 包按 delivery_*/rock_*/merchant_*/provider_* 前缀成组
This commit is contained in:
@@ -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 行以内,便于按业务域定位。
|
||||
|
||||
Reference in New Issue
Block a user