再次提交一下代码

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

@@ -5,15 +5,21 @@
本文件是当前项目的协作入口,供开发者和 coding agent 在动手前阅读。
- 可复用迁移规范统一位于 `docs/import/reusable/`
- AI-NSES 通用标准位于 `docs/import/reusable/ai-native-software-engineering-standard.md`
- AI-NSES 模板目录位于 `docs/import/reusable/ai-native-templates/`
- 通用可复用规范位于 `docs/import/reusable/general-development-guidelines.md`
- 前端细则参考 `docs/import/reusable/frontend-development-guidelines.md`
- 后端细则参考 `docs/import/reusable/backend-development-guidelines.md`
- 后端基础结构、ID、审计字段、分页和 Mapper 规范参考 `docs/import/reusable/backend-base-structure-pagination-guidelines.md`
- Java 代码规范参考 `docs/import/reusable/alibaba-java-coding-guidelines-summary.md`
- SuperAgent 与 AgentBus 可移植集成经验参考 `docs/import/reusable/integrations/superagent-agentbus-portable-integration-guide.md`
- 项目长期上下文入口位于 `CONTEXT.md`
- 当前项目状态入口位于 `PROJECT_STATE.md`
- 当前项目专属文档总索引位于 `docs/project/README.md`
- 当前项目 AI-NSES 落地说明位于 `docs/project/ai-native-adoption.md`
- 当前项目专属后端规范位于 `docs/project/backend-development-guidelines.md`
- 当前项目时间设计说明位于 `docs/project/backend-time-design.md`
- 当前项目接口暴露、权限和审计边界位于 `docs/project/security-access-control-boundary.md`
- 当前项目专属前端规范位于 `docs/project/frontend-development-guidelines.md`
- 当前项目前后端协作入口位于 `docs/project/frontend-backend/README.md`
- 当前项目 SuperAgent 与 AgentBus 接入记录位于 `docs/project/integrations/superagent-agentbus-project-integration-guide.md`
@@ -32,6 +38,7 @@
- 遇到不确定的技术栈、目录、接口契约或数据模型,先确认再继续。
- 新项目初始化或技术栈升级前,必须检查前端、后端、构建工具、测试工具和运行时版本兼容性。
- 输出分层结构、目录树、数据模型、字段映射或接口示例时,必须补充中文说明,不能只依赖英文命名表达业务含义。
- 完成 Feature 或 checkpoint 后,必须按 AI-NSES 检查 Domain、Architecture、Workflow、ADR、Spec、Project State 和安全边界文档是否需要更新;如果没有文档变化,明确说明 `No documentation changes required.`
## 3. 分支与提交
@@ -46,6 +53,8 @@
本项目是前后端都有的全栈项目,目录应保持职责清晰:
- `CONTEXT.md`:项目长期上下文入口。
- `PROJECT_STATE.md`:当前项目状态入口,允许高频更新。
- `client/`:前端应用。
- `server/`:后端服务。
- `mcp-server/`SuperAgent MCP 方案入口指针;当前不单独部署 MCP 服务,运行时代码内嵌在 `server/`,对外资料包位于 `docs/project/integrations/superagent-mcp/`
@@ -78,6 +87,7 @@
- 后端负责数据库、Secret、外部系统适配、业务规则、审计和安全脱敏。
- 接口字段使用稳定代码,不使用中文或英文显示文案做业务判断。
- 接口变更前先确认字段映射、前后端影响和测试范围。
- 新增或修改接口时,必须同步确认调用方类型、鉴权方式、权限码、酒店隔离、敏感数据返回和审计要求,并更新 `docs/project/security-access-control-boundary.md` 及相关前后端或第三方契约文档。
## 7. 后端架构边界
@@ -121,6 +131,7 @@
- 仓库只提交无真实值的 `.env.example`
- 禁止提交真实酒店凭证、客户数据、Token、Cookie、API Key、数据库密码或支付信息。
- 日志、错误响应和测试夹具不得暴露 Token、Secret、原始邮件正文、附件 URL 或个人敏感信息。
- Debug、Demo、Replay、Probe 等系统调试接口必须默认关闭或受控开放,不得因为前端页面存在就作为普通业务能力暴露。
- `.DS_Store`、构建产物、依赖目录、IDE 临时文件和本地样本目录应忽略。
## 10. 测试与验证
@@ -135,9 +146,14 @@
Coding agent 开始任务前应先读取:
1. `AGENTS.md`
2. `README.md`,如果存在
3. `docs/` 中与当前任务相关的文档
4. 当前代码结构和最近 Git 状态
2. `CONTEXT.md`
3. `PROJECT_STATE.md`
4. `README.md`,如果存在
5. `docs/project/README.md`
6. `docs/` 中与当前任务相关的文档
7. 当前代码结构和最近 Git 状态
涉及接口、权限、审计、酒店隔离或敏感数据返回的改动,开始前必须阅读 `docs/project/security-access-control-boundary.md`,完成后同步更新该文档和相关前后端或第三方契约。
改文件前要说明计划;完成后要说明改了什么、如何验证、还有哪些风险或未完成项。