# 仓库协作约定（全员）

本项目的 AI 辅助编码与协作约定以 **[`.cursor/rules/collaboration-scope.mdc`](.cursor/rules/collaboration-scope.mdc)** 为准；该规则在 Cursor 中已设为 **`alwaysApply: true`**。

**全体团队成员**在本仓库开发时均应遵守，包括但不限于：

- 动手改代码前先列改动清单，**经确认后再改** 
- 任何方案须从改动点**反向推演全部影响面**并写出「反向影响推演」小节，禁止只验证局部；详见 **[`.cursor/rules/impact-backtrace.mdc`](.cursor/rules/impact-backtrace.mdc)** 
- 断言「某能力已实现 / 未实现 / 已达成」前，须分**代码层 / 配置层 / 数据层**三层取证并附可重跑证据；**禁止**把任务清单里的「某任务未做」转述为「该能力不存在」，禁止以历史会话结论、带过滤条件的查询结果或配置表条数代替取证。详见 **[`.cursor/rules/capability-claims-evidence.mdc`](.cursor/rules/capability-claims-evidence.mdc)** 
- 默认交付**根治性最佳方案**，未经明文要求不得降级为临时/过渡/兜底方案；详见 **[`.cursor/rules/best-solution-default.mdc`](.cursor/rules/best-solution-default.mdc)** 
- 改动若**波及其他功能模块**，须单独写出跨模块影响并**等待决策** 
- 小问题**改动范围最小**，非必要不大重构（约束范围、不是让方案将就）；更大方案以**建议**形式交负责人决策 
- **发版必升号**；执行 Git 提交时，版本号只跟随**本次提交实际纳入的对应端代码/配置改动**递增：提交前端代码/配置才递增 `Web/package.json` 的 `version` patch，提交后端代码/配置才递增 `server/Admin.NET.Web.Entry/Admin.NET.Web.Entry.csproj` 的 `<Version>` / `<AssemblyVersion>` / `<FileVersion>` patch；某端未纳入本次提交则不升该端版本，**纯文档/规则提交不递增前后端版本号**。详见 **[`.cursor/rules/version-bump-on-commit.mdc`](.cursor/rules/version-bump-on-commit.mdc)**。
- 用户说 **「提交」** 时默认 **commit + push** 到跟踪远端，不得只 commit 不 push；详见 **[`.cursor/rules/git-submit-intent.mdc`](.cursor/rules/git-submit-intent.mdc)**。
- 新增 **Ai-DOP 功能菜单** 须登记 **`FUNC-Sn-nnn`** 并维护 [`Web/src/constants/aidopFuncCodes.ts`](Web/src/constants/aidopFuncCodes.ts)；导航展示用方案 A（侧栏短标、映射表注入），**勿**把编号写入 `sys_menu.Title`。详见 **[`.cursor/rules/aidop-func-code-menu.mdc`](.cursor/rules/aidop-func-code-menu.mdc)**。

说明与索引：[`.cursor/rules/README.md`](.cursor/rules/README.md)

**主库文档目录**：新增与维护说明类 Markdown、方案、附件请放在 **[`doc/`](doc/README.md)**（见 `doc/README.md` 中的目录约定）；**不要**在仓库根目录再使用并列的 `docs/`。