feat: 根目录文档、脚本、gitignore

tmp/withdrawn-tgassist-session/zentao-20260722-1638/01_input/requirements.md

@@ -0,0 +1,55 @@
+# Requirements
+
+## 背景与目标
+
+信息技术部推行「AI 下的开发 SOP」与配套绩效考核方案：以 AI 辅助完成 PRD 生成、工作量评估、任务拆分、代码审查、测试与文档沉淀，并以「工作量指数」为核心度量，对 9 个岗位进行月度绩效考核。[SRC-001][SRC-002]
+
+本项目（zentao / IT 工作台）被普遍预期为承载该 SOP 流程流转与绩效数据统计的平台，但**具体交付物与范围尚未确认**（见 questions/round_1.yaml Q1-1）。[ASSUMPTION]
+
+## 需求概述
+
+### 一、开发 SOP 流程（SRC-001，流程图）
+
+1. 业务部门提出用户需求 → 评审用户需求、激活
+2. 初次讨论明确用户需求（正式会议需产出会议纪要）
+3. AI 生成初版 PRD 和原型图
+4. 评审讨论初版 PRD，进一步细化需求（向 IT 工作台提交会议纪要、讨论的 PRD 文档）
+5. 文档与真实需求有较大偏差 → 返回 3；无偏差 → 生成最终版 PRD 和原型图
+6. AI 评估 PRD 工作量指标，并生成研发需求、指定完成时间（IT 工作台生成研发需求：工作量指标、完成时间、PRD 文档）
+7. AI 辅助生成架构设计文档、需求成功验收指标、需求测试用例文档
+8. 评审确认各文档（向 IT 服务台提交验收指标、测试用例文档）
+9. AI 拆分任务，按工作量指标评估每个任务的工时并分配（向 IT 服务台提交研发任务）
+10. 开发人员开发实施
+11. 开发任务全部完成后，AI 进行代码审查；审查不通过 → 返回 10
+12. 提交测试人员（向 IT 服务台提交代码审查报告）
+13. 按测试用例实施测试并提交 BUG → 开发修复 → 测试复测 → 提交测试报告（向 IT 服务台提交）
+14. 完成需求研发，更新系统 AI 文档；AI 提交工作日志（向 IT 服务台提交需求的工作日志）→ 结束
+
+### 二、需求全生命周期数据模型（SRC-001，思维导图）
+
+- **用户需求**：需求内容、创建人、创建时间、审批时间、激活时间；需求讨论会（一次/二次）：会议时间、参与人、会议纪要、讨论的 PRD 附件
+- **研发需求**：最终版 PRD 文档；AI 评估工作量指标（功能单元数量、功能单元复杂度、AI 参与率、工作量指数）；需求完成时间、成功验收标准、测试用例文档
+  - **研发任务**：开发人员、AI 评估的任务工作量指数、开始时间、完成时间、实际工时
+  - **测试任务**：测试人员、测试开始/结束时间；BUG（提交人、责任人、修复状态）；测试报告
+- **AI 代码审查报告**：审查事项、审查结果
+- **AI 工作日志**：PRD 各版本生成时间、PRD 工作量指标评估时间与结果、架构设计时间/评审时间/评审结果、任务拆分时间、AI 门禁检查时间与结果、AI 代码审查时间与结果、文档更新时间
+
+### 三、绩效考核方案（SRC-002，9 个岗位 sheet）
+
+跨岗位核心指标：
+
+- **工作量指标完成率** = Σ(月度需求/PRD 工作量指数) ÷ (团队可用工作天数 × 5)（项目经理 0.3、产品经理 0.2、产品助理 0.5 等权重）；=100% 满分，按缺口扣分
+- **版本计划完成率** = Σ(按时发布需求工时) ÷ Σ(所有需求工时) ≥95%
+- **线上 Bug 率** = Σ(当月上线需求线上 Bug 数) ÷ Σ(上线需求开发工时) ≤5‰；普通 Bug / 重大 Bug 分级扣分（重大 Bug 定义：影响上游回传数据、财务数据、大面积影响）
+- **开发岗**：任务及时完成率（0.25）、Bug 密度 ≤15%（0.3，连续 3 个月达标可返还半年扣分）、代码质量（AI 审查：严重问题 1 处扣 3 分；复审严重问题 1 处扣 5 分）、工作量饱和度（月度达标工时 = 团队总工作天数×5 ÷ 开发人员数）
+- **测试岗**：测试计划及时率、测试文档齐备、缺陷检出率 >20%（普通 Bug×1 + 重大 Bug×5 ÷ 测试需求开发工时）、线上 Bug
+- **文档齐备考核**：大型需求（AI 评估工作量指数 >20）必须产出《需求测试用例》《需求测试报告》《AI 项目文档更新记录》《AI 代码审查报告》《AI 工作日志》，缺失扣分
+
+## 证据/参考
+
+| ID | 资料 | 说明 |
+|---|---|---|
+| SRC-001 | `01_input/references/AI下的开发SOP流程（新版）.pdf` | 5 页：开发 SOP 流程图 + 需求全生命周期数据模型 |
+| SRC-002 | `01_input/references/信息技术部绩效考核标准-新版 - AI下的考核方案.xlsx` | 9 个岗位 sheet：项目经理、项目经理(王宇航)、产品经理、产品助理、后端开发、前端开发、测试、UI、运维 |
+
+补充观察：codes/zentao 根目录已存在多份绩效相关 xlsx（2026-04-01绩效.xlsx、各岗位考核表），与 SRC-002 体系一致 [ASSUMPTION: 现行考核已在线下执行]。assets/codemap、assets/domainmap 现有资产描述的是订单/卡券/调度等业务系统（被管理系统），与本需求的 IT 工作台平台相关性待确认 [ASSUMPTION]。