diff --git a/docs/06-气站管理系统需求.md b/docs/06-气站管理系统需求.md index d05a71a..862c0de 100644 --- a/docs/06-气站管理系统需求.md +++ b/docs/06-气站管理系统需求.md @@ -4,7 +4,9 @@ 本文按照 `docs/05-平台总后台需求.md` 的章节、资源模式、权限和验收口径,定义气站管理系统的规划基线。 -当前仓库尚未创建 `frontend/gas_admin`,也没有气站管理系统独立后端、资源契约和实际路由。本文描述的是待实现能力,不得认定为已交付,不得为了完成本文而在平台总后台中增加气站日常操作。 +前端工作目录: `frontend/gas_admin` +后端工作目录:`backend/api` 与总平台复用一个API目录 +后端API的URL前缀:/heqi/gas/v1 后续实现事实按以下顺序核对并回写本文: @@ -41,10 +43,10 @@ | 资源定义 | `frontend/gas_admin/src/api` | 字段、关系、页面模式和业务动作 | | 前端契约 | `frontend/gas_admin/src/contracts` | 后端资源与路由生成清单 | | 前端路由 | `frontend/gas_admin/src/router` | 菜单、受控本地路由和隐藏详情资源 | -| 后端 API | 待技术设计确认 | 气站同步业务事务、鉴权和统一响应 | -| 业务逻辑 | 待技术设计确认 | 本站库存、订单、邀请、协同和对账规则 | -| 模型 | 待技术设计确认 | 气站主责事实模型与中文注释 | -| 初始化 | 待技术设计确认 | 系统必需角色与菜单,不包含演示数据 | +| 后端 API | `backend/api` | Gin HTTP API、JWT、事务和统一响应 | +| 路由 | `backend/api/internal/routers/gas.go` | 平台 API 唯一路由注册入口 | +| 业务逻辑 | `backend/api/internal/logic/gas` | 各领域查询、动作、权限和状态流转 | +| 模型 | `backend/api/internal/models` | 复用现在的,没特殊要求不可新增 | 以上目录均为规划归属,任务未明确要求前不得提前创建空壳工程。新管理端须复用 `sample/front` 的公共机制,新 Go 进程须遵循 `sample/server` 的分层。 diff --git a/docs/07-配送点管理系统需求.md b/docs/07-配送点管理系统需求.md index d190beb..e7d90e9 100644 --- a/docs/07-配送点管理系统需求.md +++ b/docs/07-配送点管理系统需求.md @@ -4,7 +4,10 @@ 本文按照 `docs/05-平台总后台需求.md` 的章节、资源模式、权限和验收口径,定义配送点管理系统的规划基线。 -当前仓库尚未创建 `frontend/delivery_admin`,也没有配送点管理系统独立后端、资源契约和实际路由。本文描述的是待实现能力,不得认定为已交付,不得为了完成本文而在平台总后台中增加配送点日常操作。 +前端工作目录: `frontend/delivery_admin` +后端工作目录:`backend/api` 与总平台复用一个API目录 +后端API的URL前缀:/heqi/delivery/v1 + 后续实现事实按以下顺序核对并回写本文: @@ -41,10 +44,10 @@ | 资源定义 | `frontend/delivery_admin/src/api` | 字段、关系、页面模式和业务动作 | | 前端契约 | `frontend/delivery_admin/src/contracts` | 后端资源与路由生成清单 | | 前端路由 | `frontend/delivery_admin/src/router` | 菜单、受控本地路由和隐藏详情资源 | -| 后端 API | 待技术设计确认 | 配送点同步业务事务、鉴权和统一响应 | -| 业务逻辑 | 待技术设计确认 | 本点调度、配送仓、质控、邀请和对账规则 | -| 模型 | 待技术设计确认 | 配送点主责事实模型与中文注释 | -| 初始化 | 待技术设计确认 | 系统必需角色与菜单,不包含演示数据 | +| 后端 API | `backend/api` | Gin HTTP API、JWT、事务和统一响应 | +| 路由 | `backend/api/internal/routers/delivery.go` | 平台 API 唯一路由注册入口 | +| 业务逻辑 | `backend/api/internal/logic/delivery` | 各领域查询、动作、权限和状态流转 | +| 模型 | `backend/api/internal/models` | 复用现在的,没特殊要求不可新增 | 以上目录均为规划归属,任务未明确要求前不得提前创建空壳工程。新管理端须复用 `sample/front` 的公共机制,新 Go 进程须遵循 `sample/server` 的分层。