refactor: design产出拆两层——应用级(architecture+ui-design风格/主页/交互/弹窗规范),数据设计下沉到各模块(数据/CRUD/处理逻辑/skills)实现模块自包含复用

This commit is contained in:
yumoqing 2026-08-19 23:11:39 +08:00
parent 8d145ec1b0
commit 4939d7cb52

View File

@ -16,10 +16,8 @@ project-repo/
│ ├── 00-requirement/
│ │ └── requirement-spec.md # 需求规格说明书
│ ├── 01-design/
│ │ ├── architecture.md # 系统架构
│ │ ├── database-design.md # 数据库设计
│ │ ├── api-design.md # API 接口设计
│ │ └── ui-design.md # 前端设计
│ │ ├── architecture.md # 系统架构、模块划分、模块间依赖、开发顺序
│ │ └── ui-design.md # 视觉风格/主页面/用户交互模式/弹窗规范
│ ├── 02-develop/
│ │ └── dev-notes.md # 开发说明(引用了哪些模块仓库)
│ ├── 03-test/
@ -31,8 +29,11 @@ project-repo/
│ │ └── release-notes.md
│ └── 05-pm/
│ └── reviews/
├── modules/ # 模块说明(每个模块一个文件)
│ └── <模块名>.md
├── modules/ # 模块(自包含单元:清单 + 模块级设计)
│ ├── <模块名>.md # 模块清单:功能/仓库/依赖/开发顺序
│ └── <模块名>/ # 模块级设计(属于模块本身,可整体复用)
│ ├── design.md # 数据设计(表DDL) + CRUD + 处理逻辑(接口)
│ └── skill/SKILL.md # 模块技能文档
├── apps/ # 应用说明(每个应用一个文件)
│ └── <应用名>.md
├── config/ # 部署配置
@ -49,9 +50,22 @@ project-repo/
- **状态**: <规划中/开发中/已完成>
- **负责人**: <role>
- **依赖模块**: <列出依赖的其他模块>
- **开发顺序**: <拓扑序中的位置被依赖的先开发>
- **关联应用**: <属于哪个应用>
```
## 模块级设计 `modules/<模块名>/`
每个模块是自包含、可复用的单元,数据设计放模块内而非应用级:
```
modules/<模块名>/
├── design.md # 数据设计(表结构DDL) + CRUD 定义 + 处理逻辑(接口)
└── skill/SKILL.md # 模块技能文档develop agent 参考)
```
**原则**: 数据、CRUD、处理逻辑、skills 都属于模块本身,不放在应用级 design 里,这样模块可整体复用(换个应用直接带着自己的数据/逻辑/skills 一起加载)。
## 应用说明文件 `apps/<应用名>.md`
```markdown
@ -69,13 +83,15 @@ project-repo/
### requirement需求分析师
- **产出**: `docs/00-requirement/requirement-spec.md`
- **同时创建**: `apps/` 下至少一个应用说明文件,`modules/` 下至少一个模块(每个应用至少关联一个模块),标注状态为规划中、填写仓库 URL
- **同时创建**: `apps/` 下至少一个应用说明文件(应用 = 部署单元,含端口/环境)
- **不划分模块**: 模块划分是架构决策,由 design 阶段设计师完成
- **内容**: 项目概述、用户角色及权限、功能列表(含验收标准)、非功能需求、业务流程
### design系统设计师
- **产出**: `docs/01-design/architecture.md`, `database-design.md`, `api-design.md`, `ui-design.md`
- **更新**: `modules/` 下各模块的技术栈、依赖关系
- **内容**: 架构图及技术选型、ER 图/DDL、API 端点列表、页面结构
- **应用级产出**: `docs/01-design/architecture.md`(系统架构、模块划分、模块间依赖、开发顺序), `ui-design.md`(视觉风格/主页面/用户交互模式/弹窗规范)
- **模块级设计**: 每个模块在 `modules/<模块名>/` 下产出自己的设计——数据设计(表结构DDL)、CRUD 定义、处理逻辑(接口)、skills(技能文档)。数据/CRUD/逻辑/skills 属于模块本身,不放在应用级,保证模块可整体复用
- **更新**: `modules/` 下各模块的技术栈、依赖关系、开发顺序
- **内容**: 架构图及技术选型、模块清单与依赖图、视觉风格与交互规范
### develop开发工程师
- **产出**: `docs/02-develop/dev-notes.md`(开发说明,记录了哪些模块仓库、开发了什么功能)