51 lines
4.3 KiB
Markdown
51 lines
4.3 KiB
Markdown
# 项目文件治理计划
|
||
|
||
## 当前任务：收敛 Planning with Files 大小（已完成）
|
||
|
||
- **目标：** 在根 `task_plan.md` 达到治理上限前完成可恢复轮转，使活动计划重新只保留当前目标、有效决策、待处理项和安全边界。
|
||
- **触发原因：** 处理前 `task_plan.md` 为 15,640 字节，占 16 KiB 上限的 95.5%，尚未超限但只剩 744 字节；`findings.md` 与 `progress.md` 均远低于各自 32 KiB 上限。
|
||
- **安全边界：** 只调整 Planning with Files 与对应历史索引；不修改业务源码、Schema、mapping、Skill 或发布物，不访问 ERP，不变更任务或服务运行态，不部署或外发。
|
||
|
||
### 阶段
|
||
|
||
- [x] 恢复 README、三份 Planning with Files、工作区状态和业务登记，确认这是跨业务文件治理。
|
||
- [x] 在修改活动计划前，将原文完整冻结到日期化历史目录并完成 SHA-256、逐字节一致性校验。
|
||
- [x] 语义压缩活动 `task_plan.md`，保留当前任务、最近有效里程碑、相邻待处理项和持续边界。
|
||
- [x] 更新归档索引与 `progress.md`，运行规定的五道门禁及 diff/大小检查。
|
||
|
||
### 已确定的治理决策
|
||
|
||
- 本轮只压缩接近上限的 `task_plan.md`；处理前 `findings.md` 为 4,885 字节、`progress.md` 为 5,487 字节，无需无意义轮转。
|
||
- 压缩前原文已冻结到 [AgentBus 重连后完整计划](archive/project-history/2026-08-28/task_plan-pre-compression-agentbus-reconnect.md)，SHA-256 为 `e8e288166f3bf4ad848fb37b985651320e9a9d3213b091fdcd2d13153d7d86ee`，与原活动文件逐字节一致。
|
||
- 归档只供追溯，不反向定义当前规则；活动事实继续以源码、契约、业务登记、`findings.md`、`progress.md` 和发布清单为准。
|
||
|
||
## 最近有效里程碑
|
||
|
||
- 当前发布基线为 Chrome 扩展 `0.5.157`、Program parser `v1.0.6`、输入契约/DOCX `0.5.123`、五个业务 Skill `0.5.125`；版本、文件名和哈希只以 [发布清单](dist/release-manifest.json) 为准。
|
||
- `confirmation_export` 已接入散拼母团“整团游客信息”：固定 `shared_plan + visitor-list`，只允许 `orders_Visitor.asp?tid=<tid>`；独立团/散拼具体子单“游客名单”继续使用 `did+tid`，范围不得混用。
|
||
- `passenger_list_import` 固定 Program-only；未确认的占用游客位要求覆盖确认，确认后附件指定序号全部覆写，同值也写；ERP 原生游客位不足时在保存前返回名单人数与可录入上限。
|
||
- 名单唯一严格“领队”行投影为父表单联系人；父表单 ERP 明确成功即完成名单任务，不执行写后逐行名单回查，其他生命周期 action 仍要求 action-specific 完成凭据。
|
||
- 8786 控制面和本地 Chrome 扩展已切换到上述基线；最近一次授权重启后，数据库、Schema、迁移 014 和 AgentBus 4/4 渠道连续采样正常。
|
||
|
||
## 相邻待处理项
|
||
|
||
- 散拼母团整团游客 `tid-only` 新分支仍需另行授权后做运行态 ERP 只读复测。
|
||
- 独立团 SGL/TWN 与成人、占床儿童、不占床儿童、领队人数映射仍需另行授权 ERP 实写复测。
|
||
- AgentBus OSS 附件曾因本机 DNS 返回私网/保留地址而被 SSRF 门禁拒绝；后续应采用受控公有 DNS 或主机白名单回退，不能全局放宽私网阻断。
|
||
|
||
## 错误记录
|
||
|
||
- 本轮尚无文件处理或校验错误。
|
||
|
||
## 完成结论
|
||
|
||
- 活动 `task_plan.md` 已从 15,640 字节压缩到远低于 16 KiB 的安全区间；完整原文、哈希和归档索引均已保留。
|
||
- 规定门禁通过：仓库治理 9/9、TypeScript、控制面 127/127、legacy 248/248、build；`git diff --check` 通过。
|
||
- 本轮仅修改三份治理记录：活动计划、项目进度和同日归档索引，并新增一个完整计划快照；没有业务、发布物或运行态变更。
|
||
|
||
## 历史与持续边界
|
||
|
||
- 本轮压缩前完整计划见 [2026-08-28 快照](archive/project-history/2026-08-28/task_plan-pre-compression-agentbus-reconnect.md)；更早快照见同目录 README 和 `archive/project-history/`。
|
||
- 详细业务发现与运行结果分别见 [findings.md](findings.md) 和 [progress.md](progress.md)，避免在计划中重复堆叠已完成过程。
|
||
- 真实 ERP 访问或写入、任务 mutation、扩展重载、服务重启、部署和外部发送仍需用户另行明确授权。
|