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