heqiapp/platforms
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix docs

Browse Source
This commit is contained in:
yanweidong
2026-07-30 11:09:07 +08:00
parent 2e6df1d18d
commit 4c9cd3fc2c
2 changed files with 15 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
docs/06-气站管理系统需求.md
View File

@@ -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` 的分层。

13
docs/07-配送点管理系统需求.md
View File

@@ -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` 的分层。