43 lines
2.1 KiB
Markdown
43 lines
2.1 KiB
Markdown
# M11b-2 无新增 API 路径声明（N/A）
|
||
|
||
> 本文件是 **正式声明文件**，不是占位符。它存在的唯一目的：让「`wwwroot/api/` 下
|
||
> 本里程碑没有新增 `.dspy`」这件事在文件系统里可被 grep / 可被 QC 核对，
|
||
> 而不是靠口头说明。
|
||
|
||
## 声明
|
||
|
||
**M11b-2 里程碑（含子任务 T1 / T2 / T3）未在 `modules/world_sync/wwwroot/api/`
|
||
下新增任何 `.dspy` 接口文件。**
|
||
|
||
理由：M11b-2 的交付物是 **Python 库函数**，由宿主应用（`apps/pbls`）进程内调用，
|
||
不经过 ahserver 的 HTTP 文件路由，因此：
|
||
|
||
- 不产生新的 Web 可访问 URL；
|
||
- 不需要在 RBAC `permission` 表中新增条目；
|
||
- 不需要在 `scripts/load_path.py`（模块层）或 `apps/pbls/scripts/load_path.py`
|
||
（中央层）中登记新路径。
|
||
|
||
## 本里程碑的实际交付面（供核对）
|
||
|
||
| 交付物 | 位置 | 是否 HTTP 可访问 | 是否需 RBAC 登记 |
|
||
|---|---|---|---|
|
||
| world_sync 列级差异比对库函数 | `modules/world_sync/world_sync/*.py` | 否（进程内调用） | 否 |
|
||
| pbl_runtime_ext 单事务事件/状态写入 | `modules/pbl_runtime_ext/pbl_runtime_ext/*.py` | 否（进程内调用） | 否 |
|
||
| 表定义 | `modules/world_sync/models/*.json` | 否 | 否 |
|
||
| 自检脚本 | `modules/world_sync/scripts/m11b2*.py` | 否（命令行） | 否 |
|
||
| RBAC 路径声明脚本 | `modules/world_sync/scripts/load_path.py` | 否（命令行） | 本身即登记入口 |
|
||
|
||
## 既有 api/ 目录内容（M11b-2 之前存量，本次未增删）
|
||
|
||
`modules/world_sync/wwwroot/api/` 下既有 `.dspy` 与
|
||
`modules/world_sync/scripts/load_path.py` 中 `PATHS_LOGINED` 的
|
||
`/{world_sync}/api/*.dspy` 条目一一对应，已由中央层聚合登记。
|
||
|
||
## 交叉引用
|
||
|
||
- 模块层声明台账：`modules/world_sync/scripts/load_path.py`（文件头
|
||
「里程碑 RBAC 声明台账」+ `MILESTONE_DECLARATIONS`，可 `grep M11b-2`）
|
||
- 中央层双写声明：`apps/pbls/scripts/load_path.py`（同名台账）
|
||
- 本里程碑 RBAC/路径声明正式文档：
|
||
`projects/pbls/docs/02-develop/m11b2c-rbac-path-declaration.md`
|