admin
|
45dd470077
|
docs: 历史报告的平台路径重映射到平台仓 crates/*
- src/backend/src/platform/*.rs(技能仓已删的自研平台)→ ssw-platform:crates/{core,store,contract,compat-*}/*
- 27 处路径去行号(代码已重组,行号失效)并加顶部「路径口径」说明
- MIGRATION 的分层对位改成「平台=sspf 包 / 业务=packs + modules」,schema 表数 10 → 177
|
2026-11-04 23:00:39 +08:00 |
|
 adminandClaude Code
|
96594df72f
|
feat(repo): 平台层/业务层分离收尾 + 六道闸门(把「尺子」变成机器)
**影响**
后端从「平台层里塞业务知识」改成「装配根 + 业务层自带 spec/菜单/路由」;闸门 5 道 → 6 道,
契约尺子 2 条 → 3 条;两把尺子**默认自起隔离后端** ⇒ 不用先起后端就能冒烟(CI 可跑)。
单测 220 passed / 0 failed;静态闸门 93 + 11 + 10 + 4 全绿;面 A 32/32、面 B 18/18 全绿。
**改动**
- 后端:新增 `platform/guard.rs`(生产档弱口令守卫六条判据 + 配置级/库内级两道检查)、
`platform/menu.rs`(菜单 spec 的类型)、`bootstrap.rs`(装配根:唯一同时认识平台层与业务层的地方);
业务模块的菜单与路由下沉到 `modules/<app>.rs`,平台层只 `merge(modules::router())` 一次。
- 闸门:新增 `check-boundary.sh`(分层红线 CP1–CP6)、`check-contract.sh`(契约端点表 + 官方端点台账
↔ 代码真实路由,CC2–CC10)、`check-citations.sh`(文档引文 `路径:行号` 逐条核对);
`check-module.sh` 改为从契约期望值派生(63 → 93 条);三把尺子各带反自证用例。
- 契约:`docs/contract.md` 附录 A 扩成机器可读区段(`[ENDPOINT]` / `[FACE]` / `[OFFICIAL]` / `[RULER]` …)
⇒ 六把尺子的期望值只有一处;`[OFFICIAL]` 官方端点台账 53 行四态 ⇒ 覆盖 **8/47**(算出来的)。
- 尺子:`scripts/smoke_backend.sh` 让两把契约尺子默认自起隔离后端(显式给了 `B` ⇒ 不自起、不可达即退出码 2)。
- 文档:CLAUDE.md / SKILL.md / README.md / HANDOFF.md / HOWTO_MODULE.md / docs/* 同步到新结构与新闸门;
裁决 96 → 98 条(P91 尺子自起设计、P92 官方端点覆盖账本)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-27 11:33:25 +08:00 |
|
 adminandClaude Code
|
ab8833af28
|
refactor(backend): 平台层 / 业务层分离 —— 加业务模块只碰 modules/
后端从平铺(src/{config,db,cipher,…,entities}.rs)改两层,对齐 react 版的
common+auth+sys / demo+shop+books 与官方 JNPF 的 jnpf-common+jnpf-system / jnpf-admin。
- 平台层 src/platform/:契约实现(config·db·cipher·envelope·ids·session·state·
auth·permission·seed·sys·jnpf·entity·crud)—— 加业务模块不动
- 业务层 src/modules/:mod.rs + demo/shop/books,各自带 spec + 3 条路由 + 自己的 router()
- routes.rs 变成「平台路由 + 一次 merge(modules::router())」,业务路由不再登记在平台层
- 业务路由清单也搬到业务层(modules::ALL_ROUTES),平台层钉子测试遍历它
⇒ 原来「每加一模块要改 routes.rs 路由表」的口子被堵死
- 清掉平台层最后一个业务知识泄漏:S22 的 f_creator_user_id 规则原在引擎里写死
app_code == "demo",改为业务 spec 自己声明(EntitySpec.creator_fixed)
- check-module.sh 新增反向断言(平台层不得注册业务路由)+ 正向断言(业务层须登记)
⇒ 断言 57 → 69
- 文档同步(SKILL/CLAUDE/README/HANDOFF/PERMISSION/MIGRATION/HOWTO_MODULE/contract),
新增红线「平台层不许出现业务表名 / app_code」;decisions.md 补 P81
验证:cargo build --release 0 error 0 warning · cargo test 197 passed / 0 failed ·
check-module.sh PASS=69 FAIL=0 · 面 A PASS=32 FAIL=0 · 面 B PASS=18 FAIL=0 SKIP=0
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 17:26:21 +08:00 |
|
 adminandClaude Code
|
8b24bb1aea
|
refactor(name): 项目正式名称统一为 ssw-jnpf-lite-rust
**影响**:仓库/目录/二进制/契约里的项目标识全部换成 `ssw-jnpf-lite-rust`,
旧名 `tds-lite-rs`(曾误写 `tdc-lite-rs`)不再出现在任何代码、脚本或文档里。
**改动**
- Cargo:`package`/`[[bin]]` → `ssw-jnpf-lite-rust`,`[lib]` → `ssw_jnpf_lite_rust`;
`Cargo.lock` 随之重生成
- 运行期:`jnpf.rs` 的 `SYSTEM_ID`/`SYSTEM_CODE` → `ssw-jnpf-lite-rust`
(面 B 响应的 `currentSystemId`/`systemCode`/菜单 `systemId` 兜底值随之变化);
`main.rs` 的 `--help`/`--enc`/启动与停止日志文案
- 脚本:`run.sh` 二进制路径与 `pkill` 模式(**保留旧名兜底 pkill**,收掉改名前起的老进程);
`perm-smoke.sh`/`perm-smoke-jnpf.sh` 的 `ENC_BIN` 默认路径、`App-Code` 头、提示文案;
`check-module.sh`;`.env.example`
- 文档:`CLAUDE.md`/`README.md`/`HANDOFF.md`/`docs/*.md` 全文;
`HANDOFF.md` §1 第 5 条决策改为「正式名称,2026-10-26 改定」,原方案 `tds-lite-rs` 标为已推翻
**验收**:`cargo build --release` 0 error 0 warning · `cargo test` 195 passed / 0 failed ·
面 A 冒烟 PASS=32 FAIL=0 · 面 B 冒烟 PASS=18 FAIL=0 SKIP=0 · 静态自检 PASS=57 FAIL=0 ·
`--enc 123456` 输出与上游检验向量逐字一致
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 12:36:06 +08:00 |
|
 adminandClaude Code
|
1143238479
|
docs: 决策记录与已知限制从 SDD 过程草稿提升为受版本控制的正本
影响
- 交付物里多了两份「代码之外的为什么」:docs/decisions.md(实施期 88 条裁决:
什么 — 为什么 — 判错了的代价)与 docs/known-limitations.md(被接受/挂起的限制)。
这两份原本只存在于 .superpowers/sdd/<plan>/ 下的 git-ignored 过程草稿里,
草稿清理后就会消失;现在随仓库走。
- README / CLAUDE.md / HANDOFF.md 各自补上指向它们的入口。
改动
- docs/decisions.md(新增):从 ledger 抽出 88 条裁决正文(P1–P80 的实现期裁决 +
F1–F12 的最终整体评审裁决),去掉逐条验证输出与任务流水;按编号排序。
- docs/known-limitations.md(新增):分支级已知限制清单正本(A–G 分节,顺序已修正)。
- HANDOFF.md:§1 补「实施期 88 条裁决另见 docs/decisions.md」;已知限制摘要指向正本。
- README.md / CLAUDE.md:文档树与入口补齐。
设计
- 保留裁决正文而不是整份 ledger:ledger 混着大量一次性验证输出与任务流水,
对下一个读者是噪声;裁决本身才是「为什么这样写代码」的长期资产。
- 编号 P34/P35 在 ledger 里只有引用、没有独立条目,故正本中不出现。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-26 05:50:16 +08:00 |
|