再次提交一下代码

This commit is contained in:
andy
2026-07-17 13:13:47 +07:00
parent f4d86248d4
commit 980a3a2535
41 changed files with 1699 additions and 187 deletions

View File

@@ -0,0 +1,40 @@
# ADR-编号 标题
| 项 | 内容 |
| --- | --- |
| 状态 | Proposed / Accepted / Superseded |
| 日期 | YYYY-MM-DD |
| 决策人 | 按实际填写 |
## 1. 背景
说明为什么需要做这个决策。
## 2. 约束
- 约束 1
- 约束 2
## 3. 备选方案
### 方案 A
说明优点和缺点。
### 方案 B
说明优点和缺点。
## 4. 最终选择
说明最终选择哪个方案。
## 5. 影响
- 正面影响:
- 负面影响:
- 后续动作:
## 6. 历史说明
ADR 只追加,不覆盖历史。如果未来决策变化,新建 ADR 或标记被替代。

View File

@@ -0,0 +1,39 @@
# 项目协作与开发规范
## 1. 文档入口
- 项目背景:`CONTEXT.md`
- 当前状态:`PROJECT_STATE.md`
- 项目文档索引:`docs/README.md` 或项目自定义索引
- 通用开发规范:按项目实际路径填写
## 2. 工作方式
- 先确认目标、边界和验收标准,再改代码或文档。
- 每次只做一个明确 checkpoint。
- 不修改与当前任务无关的用户变更。
- 不回滚用户自己的改动,除非用户明确要求。
- 遇到不确定的技术栈、接口契约、权限边界或数据模型,先确认再继续。
## 3. 文档更新原则
完成 Feature 后必须检查:
- Domain 是否需要更新。
- Architecture 是否需要更新。
- Workflow 是否需要更新。
- ADR 是否需要新增。
- Spec 是否需要更新状态。
- Project State 是否需要更新。
如果没有变化,明确说明:
```text
No documentation changes required.
```
## 4. 测试与验证
- 修改后运行对应模块已有检查命令。
- 如果检查命令尚未配置或因环境问题无法运行,必须明确说明原因。
- 不假装测试通过。

View File

@@ -0,0 +1,31 @@
# 架构说明
## 1. 系统目标
说明系统架构服务的产品目标和主要约束。
## 2. 模块边界
| 模块 | 职责 | 不负责 |
| --- | --- | --- |
| | | |
## 3. 依赖方向
说明模块之间的依赖方向,避免双向依赖和跨层直连。
## 4. 数据边界
说明数据库、缓存、文件存储、消息队列和外部系统的数据边界。
## 5. 安全边界
说明鉴权、授权、租户隔离、审计和敏感数据处理方式。
## 6. 关键决策
列出相关 ADR 链接。
## 7. 演进计划
说明后续可能调整的方向和触发条件。

View File

@@ -0,0 +1,50 @@
# 项目上下文
## 1. 项目目标
说明项目要解决什么问题、主要服务谁、成功后用户会得到什么价值。
## 2. 当前系统组成
| 模块 | 中文说明 |
| --- | --- |
| `frontend/``client/` | 前端应用,负责展示、交互和调用本项目后端。 |
| `backend/``server/` | 后端服务,负责业务规则、数据、权限、安全和外部系统适配。 |
| `docs/` | 项目文档、规范、需求和架构说明。 |
## 3. 技术栈
### 后端
- 语言:
- 框架:
- 数据库:
- 构建工具:
- 测试工具:
### 前端
- 框架:
- 构建工具:
- UI 组件:
- 测试工具:
## 4. 业务领域
列出核心业务对象,例如用户、订单、任务、酒店、邮件、支付、库存等。
## 5. 外部系统
列出外部系统、调用方向、鉴权方式和接口契约位置。
## 6. 当前开发方向
说明当前阶段最重要的开发目标和不做的事情。
## 7. 新 Agent 阅读顺序
1. `AGENTS.md`
2. `CONTEXT.md`
3. `PROJECT_STATE.md`
4. 项目文档索引
5. 与当前任务相关的 Domain、Workflow、Spec、ADR

View File

@@ -0,0 +1,27 @@
# 业务对象名称
## 1. 定义
说明这个业务对象是什么,不是什么。
## 2. 生命周期
说明对象从创建到结束的主要状态。
## 3. 业务规则
- 规则 1
- 规则 2
- 规则 3
## 4. 关系
说明它和其他业务对象的关系。
## 5. 禁止混淆
列出容易和它混淆的概念。
## 6. 非目标
说明本文不记录实现细节、表结构或接口字段。实现细节应放在 Architecture、Spec 或代码中。

View File

@@ -0,0 +1,39 @@
# 项目当前状态
| 项 | 内容 |
| --- | --- |
| 最近更新 | YYYY-MM-DD |
| 当前分支 | 按实际填写 |
| 当前阶段 | 按实际填写 |
| 当前重点 | 按实际填写 |
## 1. 当前 Feature 或 Checkpoint
- 名称:
- 状态Draft / In Progress / Blocked / Ready for Review / Done
- 目标:
- 验收标准:
## 2. 当前优先级
1. 第一优先级:
2. 第二优先级:
3. 第三优先级:
## 3. 已确认事实
- 记录对后续开发有影响的当前事实。
- 只写仍然有效的事实,不写长篇历史。
## 4. Known Issues
- 记录当前已知问题、风险和待验证点。
## 5. Next Steps
- 下一步最小动作。
- 下一个建议 checkpoint。
## 6. 文档同步提醒
完成 Feature 后检查 Domain、Architecture、Workflow、ADR、Spec、Project State 是否需要更新。

View File

@@ -0,0 +1,21 @@
# AI-NSES 模板目录
本目录保存可复制到新项目的 AI-NSES 文档模板。
使用方式:
1. 复制需要的模板到新项目对应位置。
2. 删除模板中的示例说明。
3. 补充项目真实信息。
4. 在项目 `AGENTS.md` 和项目文档索引中加入入口。
模板清单:
- `AGENTS.template.md`AI Agent 协作入口模板。
- `CONTEXT.template.md`:项目背景入口模板。
- `PROJECT_STATE.template.md`:项目当前状态模板。
- `DOMAIN_OBJECT.template.md`:业务对象文档模板。
- `WORKFLOW.template.md`:业务流程文档模板。
- `ADR.template.md`:架构决策记录模板。
- `SPEC.template.md`:功能规格模板。
- `ARCHITECTURE.template.md`:架构说明模板。

View File

@@ -0,0 +1,49 @@
# Feature Spec 标题
| 项 | 内容 |
| --- | --- |
| 状态 | Draft / Approved / Implemented / Archived |
| 日期 | YYYY-MM-DD |
| 负责人 | 按实际填写 |
## 1. 背景
说明为什么要做这个功能。
## 2. 目标
- 目标 1
- 目标 2
## 3. 非目标
- 不做事项 1
- 不做事项 2
## 4. 用户与场景
说明谁会使用这个能力,在哪些场景使用。
## 5. 业务规则
- 规则 1
- 规则 2
## 6. 接口或交互契约
说明请求、响应、权限、安全、审计和兼容性要求。
## 7. 验收标准
- Given / When / Then
- Given / When / Then
## 8. 测试范围
- 单元测试:
- 集成测试:
- 手工验证:
## 9. 文档更新
完成后检查 Domain、Architecture、Workflow、ADR、Project State 是否需要更新。

View File

@@ -0,0 +1,37 @@
# 业务流程名称
## 1. 目标
说明这个流程要完成什么业务目标。
## 2. 触发条件
说明流程从哪里开始。
## 3. 输入
| 输入 | 中文说明 | 来源 |
| --- | --- | --- |
| | | |
## 4. 输出
| 输出 | 中文说明 | 去向 |
| --- | --- | --- |
| | | |
## 5. 正常流程
1. 步骤一。
2. 步骤二。
3. 步骤三。
## 6. 异常与补偿
- 异常:
- 补偿:
- 审计:
## 7. 边界
说明哪些事情属于本流程,哪些事情不属于本流程。