# 记录与留档

用于建立资料目录、更新任务、阶段与项目进度。记录写在实际目标项目，仓库只提供规则与模板。先沿用已有资料结构；新项目可使用以下结构，阶段目录按实际工作需要建立，不预造任务或空成果。

```text
项目资料/
├── 00-项目管理/
│   ├── 项目概览.md
│   ├── 项目进度.md
│   └── 成果索引.md
├── 01-业务需求/
├── 02-产品定义/
├── 03-方案设计/
├── 04-项目规划/
├── 05-嵌入式软硬件实现/
├── 06-测试验证/
├── 07-内部外部验收/
└── 08-复盘结项/
```

每个启用阶段包含：

```text
阶段目录/
├── 阶段记录.md
├── 正式成果/
└── 过程记录/
    ├── 任务记录/       # 每项任务或任务包一份 Markdown，使用明确的任务名称
    └── 历史资料/       # 按实际需要保存草稿、旧版和历史确认
```

阶段决定记在阶段记录的过程栏目，任务决定记在原任务；范围较大时可引用已有变更记录。无需为一次确认另建审批文件。角色子目录仅在资料量确有需要时使用。

## 各层分别记录什么

### 项目概览

记录稳定信息：项目目标与范围、有效流程基线、中心及相关真人分工、资料入口、适用验收范围和已确认的通信方式。人员变化保留交接事实，不把固定示例姓名或 Etunel 技术编号当成必填表。

使用 [项目概览模板](../assets/templates/项目概览.md)。

### 项目进度

作为项目当前情况的统一入口，每次相关事实变化后同步维护：

- **当前阶段与整体进度**：已完成、当前、后续阶段，关键成果与下一步。阶段完成依据真人决定；有跳转时如实标记，不将经过阶段等同于完成。
- **当前待处理事项**：逐项写事项、所属阶段、负责人、当前情况、下一步与需要谁决定。
- **时间**：原计划完成时间、当前有效计划完成时间；实际完成后记录真人确认完成时间。已约定起始时间也保留。
- **未完成及影响**：未完成内容、原因、影响的成果／任务／后续阶段／对外节点，必须完成的阶段，必要真人决定及来源。
- **原记录入口**：链接所属阶段的任务记录；事项详情以该记录为准，项目层维护必要摘要，不复制所有历史。

所有当前需处理事项都列出，逾期事项重点显示。跨阶段未完成事项持续可见；对 Bug 等已有系统引用原条目，不重复分配已明确责任、期限或另造缺陷清单。尚未约定期限或完成阶段时写“待确认”并列为需决定事项，不擅自指定。

完成或获得无需继续跟进的明确处置后，从当前事项移到“已完成或已处置”简要历史入口；仍有承接或跟进动作时继续显示。取消、豁免不写已交付，结项承接不自动移除未完成事项。

整体进度默认用阶段和关键成果说明。只有项目已有真人确认的计算规则才用百分比，保留依据；不按阶段序号除以八估算。

使用 [项目进度模板](../assets/templates/项目进度.md)。

### 阶段记录

顶部列阶段状态、时间和一句话进展。正文固定分为两类：

1. **正式成果及确认记录**：每项最终成果单列名称、版本、位置或链接；对应真人确认逐项列确认人、时间、对象和版本、结论、范围与条件。历史确认留在过程区。
2. **过程记录**：逐项汇总本阶段每个任务的负责人、应交／已交成果、完成情况、确认情况、原计划／当前计划／实际完成时间、缺口、影响、下一步及原任务入口。这里也列跨阶段引用、待确认成果、阶段决定、延期和历史资料入口。

每个任务都要覆盖成果、完成和确认三方面，不能只给过程文件链接。阶段已结束仍有未完成事项时，继续更新该阶段任务摘要并在项目层跟进；不因跨阶段复制任务。

阶段结束的正式小结只含最终成果与确认，未决项和后续安排放过程栏目。使用 [阶段记录模板](../assets/templates/阶段记录.md)。

### 任务记录

每项独立结果或同一负责人的内聚任务包一份 Markdown；首次创建后沿用稳定文件位置，退回、改期、跨阶段继续维护原记录。

- **前部维护现状**：任务目标、主责真人、阶段、输入版本与位置、范围、应交结果、完成条件、依赖、三类时间、成果、确认、影响和下一步。
- **后部追加历史**：实际接收、提交、退回、补充、确认、改期、变更、重开、取消等影响交付的事件。每次写时间、人物、内容、依据和影响，不抄录聊天全文或角色内部操作。
- **状态按事实填写**：待接收、进行中、部分完成、待确认、已完成；退回补充、暂缓、已取消等如实说明。逾期和阻塞另列原因，不用它们掩盖已经完成的部分。
- **时间口径**：原计划保留首次确认值；当前计划保留最新经确认值，没有改期就与原计划相同；实际完成只取提交后真人明确确认完成的时间。提交、成果确认、补录和重开各自保留。详见 [成果与确认](artifacts-and-confirmation.md)。

延期时写明超过原计划与当前计划的情况，保留每次改期的旧值、新值、原因与真人决定。任务获得部分成果确认不等于整项完成；完成条件有多项确认时核对全部适用确认。

使用 [任务记录模板](../assets/templates/任务记录.md)。

### 成果索引

按阶段列当前有效的最终成果名称、版本、位置及确认入口。确认详情只在对应阶段正式栏目维护，索引链接过去。任务状态、延期、草稿和旧版不混入当前成果索引。

使用 [成果索引模板](../assets/templates/成果索引.md)。原本就在外部系统的成果只记真实链接，不复制内容；外部系统旧版地址与历史情况放过程记录。

## 更新顺序与避免重复

1. 在原任务中记录新事实与来源，更新现状，追加必要历史。
2. 若涉及正式版本变化，按 [成果与确认](artifacts-and-confirmation.md) 保留旧版及旧确认，再登记新最终版。
3. 更新所属阶段的逐任务摘要；涉及后续阶段时只添加原任务引用。
4. 同步项目进度的当前事项、影响与时间；正式成果变化时更新成果索引。
5. 取得必要真人推进决定并留档后再推进；需要通知时从这些记录生成摘要。

若更新中断，继续前核对原记录、阶段和项目摘要是否一致，以真实事实和确认依据为准补齐，不凭较新的文件时间覆盖业务结论。中心不新增一套任务数据库、通知队列或同步服务。

## 排版约定

- 一级标题写项目／阶段／任务名称，紧接一句当前情况；二级标题划分现状、要求、成果确认、影响和历史。
- 每个事项单列，字段用子条目；短标签加粗，栏目之间留空行。比较固定字段时可用短表格，避免塞入多段说明形成宽表。
- 时间写明确日期，需要时注明时刻和时区；只有日期的确认不补造时分秒。未知、尚未确认、不适用、无分别使用。
- 链接使用可读名称，关联真实路径。生成文件时核对相对链接，不保留模板指引为项目事实，不创建虚假文件链接。
- 模板提供版式与字段，生成时替换填写说明，按真实内容展开条目；不为填满模板创造任务、确认、负责人或成果。