docs: distinguish tracked vs untracked files in layout spec

This commit is contained in:
Yuuuu 2026-10-02 17:58:32 +08:00
parent e4875c58e5
commit ec3ae342fc
1 changed files with 25 additions and 7 deletions

View File

@ -153,32 +153,46 @@ default = true
`docs/` 已有 `superpowers/`。不要新建第二套文档根。`资料/` 拆开并入后删除空目录。 `docs/` 已有 `superpowers/`。不要新建第二套文档根。`资料/` 拆开并入后删除空目录。
已跟踪的用 `git mv`;未跟踪的用普通 `mv`,改完再 `git add`。不要对未跟踪文件跑 `git mv`。
仓库根 `README.md` 当前未跟踪。本轮按第 5.3 节写好后 `git add README.md`。
`选品流程/output/结果/.gitkeep` 已跟踪,随父目录 `git mv` 进入 `rpa_selection/output/结果/.gitkeep`。目录名保持 `结果`。
### 6.1 现行(`docs/` 根下) ### 6.1 现行(`docs/` 根下)
已跟踪(`git mv`):
| 来源 | 去向 |
| --- | --- |
| `资料/RPA订单中心接口开发口径_20260930.md` | `docs/` 同名 |
| `资料/采购平台选品条件优先项_20260902.txt` | `docs/` 同名 |
未跟踪(`mv` + `git add`):
| 来源 | 去向 | | 来源 | 去向 |
| --- | --- | | --- | --- |
| `资料/README.md` | `docs/README.md`(重写路径,去掉「路径先不动」) | | `资料/README.md` | `docs/README.md`(重写路径,去掉「路径先不动」) |
| `资料/RPA订单中心接口开发口径_20260930.md` | `docs/` 同名 |
| `资料/RPA订单中心接口口径讨论纪要_20260929.md` | `docs/` 同名 | | `资料/RPA订单中心接口口径讨论纪要_20260929.md` | `docs/` 同名 |
| `资料/ddl/` | `docs/ddl/` | | `资料/ddl/` | `docs/ddl/` |
| `资料/API鉴权.doc` | `docs/` | | `资料/API鉴权.doc` | `docs/` |
| `资料/下一会话任务_建表.md` | `docs/` | | `资料/下一会话任务_建表.md` | `docs/` |
| `资料/合同系统录入流程.md` | `docs/` | | `资料/合同系统录入流程.md` | `docs/` |
| `资料/合同返利系统字段映射_20260911.xlsx` | `docs/` | | `资料/合同返利系统字段映射_20260911.xlsx` | `docs/` |
| `资料/采购平台选品条件优先项_20260902.txt` | `docs/` |
| `资料/【项目方案】福建洁达采购合同RPA自动化录入需求_v20260924.docx` | `docs/` | | `资料/【项目方案】福建洁达采购合同RPA自动化录入需求_v20260924.docx` | `docs/` |
口径正文里的 `` `资料/...` `` 改成 `` `docs/...` ``;`` `选品流程/` `` 改成 `` `rpa_selection/` ``。`合同系统录入流程.md` 里指向 `rpa_yisaiqi` 的句子保留。 口径正文里的 `` `资料/...` `` 改成 `` `docs/...` ``;`` `选品流程/` `` 改成 `` `rpa_selection/` ``。`合同系统录入流程.md` 里指向 `rpa_yisaiqi` 的句子保留。
### 6.2 归档(`docs/archive/`) ### 6.2 归档(`docs/archive/`)
一期 13 节点主链,以及未列入现行表的旧设计说明: 一期 13 节点主链,以及未列入现行表的旧设计说明。
已跟踪(`git mv` 进 `docs/archive/`):
- `PLAN.md` - `PLAN.md`
- `一期开发任务清单_表结构_API草案.md` - `一期开发任务清单_表结构_API草案.md`
- `一期需求简版说明_业务版.md` - `一期需求简版说明_业务版.md`
- `界面截图证据记录.md` - `界面截图证据记录.md`
- `福建洁达采购合同自动化设计说明.md`
- `采购业务RPA思路20260625.docx` - `采购业务RPA思路20260625.docx`
- `采购主链RPA一期实施与验收规范.md` - `采购主链RPA一期实施与验收规范.md`
- `采购主链RPA一期开发规划.md` - `采购主链RPA一期开发规划.md`
@ -186,6 +200,10 @@ default = true
- `采购主链RPA一期需求文档_三方会审版.md` - `采购主链RPA一期需求文档_三方会审版.md`
- `采购主链RPA一期需求文档_会议整理版.md` - `采购主链RPA一期需求文档_会议整理版.md`
未跟踪(`mv` + `git add` 进 `docs/archive/`):
- `福建洁达采购合同自动化设计说明.md`
这些文件内部的 `资料/` 链接不改。`docs/README.md` 的历史节指向 `docs/archive/`,并保留原警告:那套模型是「一单合同走状态机」,不要用来解释接口 1 收件箱。 这些文件内部的 `资料/` 链接不改。`docs/README.md` 的历史节指向 `docs/archive/`,并保留原警告:那套模型是「一单合同走状态机」,不要用来解释接口 1 收件箱。
### 6.3 必须改路径的现行文件 ### 6.3 必须改路径的现行文件
@ -249,8 +267,8 @@ cd rpa_selection && uv run pytest -v
## 9. 实施顺序 ## 9. 实施顺序
1. `git mv 选品流程 rpa_selection`,改该包 `pyproject.toml` 与 README 1. `git mv 选品流程 rpa_selection`,改该包 `pyproject.toml` 与 README
2. 建三个占位包 2. 建三个占位包并 `git add`
3. 把 `资料/` 按第 6 节拆进 `docs/` 与 `docs/archive/`,重写 `docs/README.md` 3. 按第 6 节:已跟踪文件 `git mv`,未跟踪文件 `mv` 后 `git add`;重写 `docs/README.md`
4. 改根 README、`rpa_oms/README.md`、`rpa_yisaiqi/README.md`、`.gitignore`、搬过来的现行口径 4. 写根 `README.md` 并 `git add`(该文件当前未跟踪);改 `rpa_oms/README.md`、`rpa_yisaiqi/README.md`、`.gitignore`、搬过来的现行口径
5. 跑第 8 节两条 pytest 5. 跑第 8 节两条 pytest
6. 确认根上没有 `选品流程/`、`资料/` 6. 确认根上没有 `选品流程/`、`资料/`