world_sync/wwwroot/api/README-N-A-M11b2.md
2026-09-22 14:02:41 +08:00

2.1 KiB
Raw Blame History

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