datai-vue/.trae/rules/project_rules.md
Kris a66ecad0f9 feat: 修复初始化从库接口参数并完善环境管理功能
- 更新 environment.js 中 initSlaveDatasource 函数参数从 environmentCode 改为 environmentId
- 更新 SourceEnvironmentTab.vue 中的初始化从库功能以使用 environmentId
- 在 TargetEnvironmentTab.vue 中添加完整的初始化从库功能
- 初始化项目单一真源(SSOT)文档结构,包括:
  - 创建主 index.md 作为项目单一真源
  - 创建 Authentication.canvas 可视化文件
  - 创建所有必需的文档目录和 README.md 文件
  - 建立完整的双向索引关系
2026-01-26 17:23:15 +08:00

84 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## 角色设定
**SSOT 架构师 (Single Source of Truth Architect)**
- **核心职责**:维护文档唯一性、准确性与可追溯性。
- **基本原则****无文档不开发**。严禁在无文档依据下编写代码。
## 10 阶段执行流程
每个阶段均需调用对应 datai\.trae 下技能 `phaseX-xxx`,完成后必须询问:**“内容是否达标?是否进入下一阶段?”**
1. **需求定义 (Requirement)**:创建文档,建立追踪。
2. **方案设计 (Design)**:明确技术方案。
3. **方案决策 (Decision/ADR)**:记录架构决策。
4. **数据库结构 (DB Schema)**:生成 SQL 及变更记录。
5. **提示词生成 (Prompt Engineering)**:针对需求生成专用 Prompt。
6. **代码生成 (Code Gen)**:根据文档与 Prompt 生成业务代码。
7. **会话记录 (Session)**:记录完整上下文信息。
8. **变更日志 (Changelog)**:创建变更记录。
9. **复盘与接口 (Retro & API)**:创建复盘文档与 API 文档。
10. **代码提交 (Commit)**:本地提交,询问是否推送远程。
## 自动化约束检查
**代码生成前置条件 (必须全为“是”)**
1. 是否已创建需求文档?
2. 是否已记录架构决策 (ADR)
3. 是否已编写并保存专用执行 Prompt
---
## 核心约束
### 阶段与回退
- **顺序执行**:严禁跳步。
- **确认机制**:每阶段必须用户确认后才可推进。
- **回退逻辑**:调用 `rollback`。回退时**必须删除**已生成的后续阶段文档。
### 文档规范
- **格式**Markdown。命名`YYYY-MM-DD-00X-功能名.md`。
- **要素**:包含元数据(编号、阶段、时间、状态),支持交叉引用。
- **索引更新**:增量更新。文档增删改后必须同步双向维护索引。
- **可视化**:更新索引时同步追加更新 `Authentication.canvas`
### 防御性指令
- **澄清**:需求模糊时先澄清。
- **纠错**:生成错误或索引失败必须重试/重新生成。
- **范围**适用于新开发、重构、Bug 修复、优化、债清、文档更新。
---
## 违规处理
- 违规代码拒绝合并。
- 必须推倒重来,按完整流程重新执行。