Commit Graph
18 Commits
Author SHA1 Message Date
adminandClaude Code 3586333a7a fix(review): 整分支终审修 3 处 —— 密文契约外部锚点 / 相对数据目录分家 / 首启默认口令可覆盖
终审(就地执行)发现的 3 个问题:

1. 密文契约只在单元层被钉住(R1 未闭环):集成测试用本仓自己的
   encrypt_login_password 造密文 ⇒ 自证自洽 ⇒ CIPHER_KEY 改错时全绿。
   新增 login_accepts_the_upstream_literal_ciphertext:用上游仓库注释里的
   字面密文登录成功,篡一个字节必须失败。
   变异自证:换掉 CIPHER_KEY ⇒ 旧 7 例仍全绿、只有新用例红。

2. 相对 TDC_DATA_DIR 会让数据目录分家:pglite-rs 打开数据目录后会 chdir
   进去 ⇒ 之后 accounts.json 落到 data/tdc.pg/<相对路径>/ 下。
   Config::from_env 在 chdir 之前把数据目录钉成绝对路径(新增纯函数
   data_dir_from + 单测)。

3. 首启管理员口令是公开默认值 admin 且无覆盖机制(R2 未闭环):
   新增 TDC_BOOTSTRAP_ADMIN_ACCOUNT / TDC_BOOTSTRAP_ADMIN_PASSWORD;
   TDC_STRICT_SECRETS=1 时还有管理员在用默认口令 ⇒ 启动即失败。

验收:207 passed / 0 failed / 1 ignored;clippy --all-targets 干净。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 11:44:37 +08:00
adminandClaude Code e475137366 feat(auth): 本地账号层 + JNPF 兼容登录,上游完整控制台可登录
- cipher.rs:MD5 + AES-256-ECB,与上游前端 cipher.ts 逐字对齐(含上游自检向量)
- account.rs:本地账号库存 data/accounts.json(不建 tdc_* 表,30 表口径不变),首启引导 admin
- 新增 POST /api/oauth/Login(grant_type=password)与 /api/permission/Users*(仅管理员)
- AppState 增 accounts 字段与 with_accounts 构造器
- 账号登录走 SessionKind::Account,Auth/Me 返 accessAllowed + account
- README:订正「/api/oauth/Login 尚未实现」并补新端点表

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 11:23:12 +08:00
adminandClaude Code e75dcf9370 feat(auth): 声明式权限键 + 写操作二次校验
影响:写操作(新建 / 修改 / 逻辑删除)现在多一道**权限键**判定;
能力集来自 `tdc_identity.f_capability`,解析不出时 **fail-open 放行**
(对齐上游「菜单未映射即放行」口径)⇒ 存量连接器不受影响。

改动:
- `src/registry.rs`:新增 `PERMISSION_KEYS`(18 个实体 → 权限键)与 `permission_key()`,
  另加一条单测守住「每个实体都有权限键」。
- `src/domain/identity.rs`:新增 `capabilities()` —— 解析 `f_capability` 自由文本
  (`,` `;` 空白分隔)成 token 集合;解析不出返回 `None`。
- `src/crud.rs`:新增 `require_write_permission()`;`create` / `update` / `delete`
  改走它(读接口 `list` / `all` / `detail` / `detail_aggregate` **不动**,
  读不做权限键判定)。
- `tests/permission_gate.rs`:5 个用例(能力集解析 / fail-open / 命中与未命中 /
  通配符 / 内部令牌与无凭证),含一条**接线自证**——三个写路径未命中权限键时必须是 403。

设计:能力集解析不出 ⇒ 放行(fail-open);本地账号(无 `tdc_identity` 来源)同 footing。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:54:19 +08:00
adminandClaude Code 0828bcfbc1 fix(fallback): 内容级兜底连 Range 分段一起拦,别让 DDL 被分块拼回来
影响:改名(或任意换名)的 DDL 副本之前只能用「整份响应」判据拦住;
`Range: bytes=0-1000` 这类分块请求的响应体只有 1001 字节 ⇒ 逃过整份比对 ⇒
逐段请求能把整份 DDL **拼回来**(实测 206 吐出 DDL 开头 1001 字节)⇒ 等于完整泄露。

改动:
- `src/routes/fallback.rs`:内容级兜底改为「拿响应体的哪一段去比」——
  无 `Content-Range` 时比整份(`Content-Length` 正好等于 DDL 长度才比),
  有 `Content-Range` 时比**同偏移**的 DDL 片段(`DDL[start..=end]`)⇒ 分块下载同样被拦。
- 新增 `parse_content_range`(只认 `bytes` 单位 + 闭区间,忽略 `total`)。
- `tests/spa_fallback.rs`:补 ④ 片段 Range ④⑤ 中段 Range ⇒ 404 JSON 且不含 DDL,
  ⑥ 片段 Range 打在等长不同内容的文件上 ⇒ 仍 206(证明比的是内容不是长度)。
- `src/main.rs` / `README.md`:兜底描述同步为「整份或 Range 分段」。

设计:`total` 段被忽略 ⇒ 「DDL + 一段尾巴」这类副本的前 N 字节同样被拦。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:45:35 +08:00
adminandClaude Code 5b0111e7a7 fix(fallback): DDL 守卫改两层——扩展名类规则 + 内容逐字节兜底
影响:DDL 不再能被任何路径拼法下载。旧守卫只比 ASCII 大小写,
`migrate.ſql`(APFS 上与 `migrate.sql` 是同一个文件)会漏网并吐出 99 KB DDL。
改后路径级判据是「任意一段的扩展名经 Unicode 大写折叠等于 SQL」
(覆盖 `migrate.sql` 的全部 1536 种 casefold 等价拼法),另加一层
「响应体与内嵌 DDL 逐字节相同 ⇒ 404」兜住改了名、但内容没变的副本。

改动:
- src/routes/fallback.rs:is_ddl_path 改为扩展名类规则(Unicode 大写折叠);
  新增 ddl_content_guard(只在 `Content-Length` 等于 DDL 长度时逐字节比对:
  长度缺失 / 片段响应不比,长度与实际不符 ⇒ fail-closed;
  整份 Range(`bytes=0-`)的长度等于整份 ⇒ 同样被拦);
  语义表改为「充分条件」表述,覆盖范围与边界按本机实测写入模块文档。
- src/main.rs:注释同步(守卫已不是「只认一个文件名」的单条规则)。
- tests/spa_fallback.rs:变体清单 36 → 44 条;新增两个用例——Unicode casefold
  一族、以及「改名但内容逐字节相同」的副本(含等长不同内容的反向护栏
  与整份 Range 的绕过口)。
- README.md:单段式动作端点按方法分述(GET 200 业务信封 / POST 405);
  DDL 的两道兜底写进说明。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 10:39:25 +08:00
adminandClaude Code 3f66cf2834 fix(fallback): DDL 守卫改「任一段命中」口径,注释只写可证明的规则
影响:
- `is_ddl_path` 从「只看末段」改为「路径中任意一段(去尾部空白、忽略大小写)
  等于 migrate.sql 即命中」。旧口径下 `/migrate.sql/.` 等 24 条变体绕过守卫,
  ServeDir 归一化时丢弃 `Component::CurDir` 后直接把 DDL 文件端出来。
- 变体清单从 4 条扩到 36 条,逐条断言 404 + application/json + 响应体无标记串;
  任何一条漏网即红。另加一条 `ddl_is_blocked_by_any_path_segment` 单独钉住
  「任一段」口径;`static_assets_are_still_served` 补 content-type 断言
  (原来对「ServeDir 根目录坏掉」零区分度)。
- README:系统列改 10 个 / 24 张带齐 / 6 张精简 / 21 个唯一索引含 14 个 partial;
  实体写入能力改「通用读取 + 按实体分档」;动作端点区分两段式 404 与单段式 200。

改动:
- src/routes/fallback.rs:is_ddl_path 改任一段口径;模块语义表、DDL 守卫说明、
  ddl_guard / is_ddl_path 注释按新口径重写,并写清守卫边界(只认这一个文件名,
  根因修复是「DDL 文件不在 web root」);补「只 decode 一层是刻意选择」。
- src/main.rs:装配处两处守卫注释同步为同一口径。
- tests/spa_fallback.rs:36 条变体循环 + 新增任一段用例 + 静态资源 content-type
  断言;临时目录名加进程内自增序号,消除同进程并发用例的目录名撞车。
- README.md:四处按代码实测对齐。

设计:
- 判据取「任一段命中」而不是复刻 ServeDir 的归一化,避免两边口径再对不齐。
- 注释只写能被证明的规则,删掉「任何路径变体都拦」这类全称量词。

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 08:45:57 +08:00
adminandClaude Code 1af08c1db7 fix(fallback): DDL 前置守卫跑在 ServeDir 之前,README 与代码对齐
- src/routes/fallback.rs: spa_fallback 返回 Router 并挂 from_fn(ddl_guard)
  前置守卫(axum 0.8.9 的 Router::layer 同时包住 fallback_router 与
  catch_all_fallback ⇒ 守卫必然先于 ServeDir);决策层的 DDL 判定移除(死代码),
  is_api_path/is_ddl_path 统一改用 percent-decode 之后的路径
- src/main.rs: 注释改成事实——真正的守卫是 ddl_guard,不是那条字面路由
- tests/spa_fallback.rs: 新增 ddl_in_web_root_is_still_not_downloadable
  (临时 web root 里放 migrate.sql ⇒ 仍须 404 + JSON 且不含 CREATE TABLE),
  并在既有用例里追加 /api%2Ffoo ⇒ 404 JSON、/apifoo ⇒ 不被误吞
- README.md: 删虚构的「契约网关」与「6 条脱敏规则 + 默认环境空间」,
  换成真实的 30 张表,并把已删除的旧控制台生命周期能力改成现状说明
  (动作端点属后续分期、尚未实现 ⇒ 前端点这些按钮会 404)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 07:40:47 +08:00
adminandClaude Sonnet 5.5 e72345a958 fix(console): schema DDL 移出 web root,兜底行为抽进 lib 并锁进 CI
- static/migrate.sql ⇒ schema/migrate.sql(编译期内嵌不变,运行期不在 web root)
  ⇒ 大小写 / %2E / 尾斜杠 / 双斜杠等路径变体全部拿不到 DDL
- 404 与 SPA 兜底从二进制 crate 抽进 lib(src/routes/fallback.rs)
  ⇒ /api 与 /api/ 统一回 404 JSON,SPA 深链回 index.html
- 新增 tests/spa_fallback.rs:6 条断言锁住兜底行为
- README 整段重写为现行 18 实体 CRUD + 鉴权面 + 上游 SPA 托管
- build-frontend.sh 可执行;产物目录缺失时回落 npm 构建路径
- registry::validate() 挪到 PGlite::open 之前,注册表写坏即秒退
- mw.rs 注释点明两套 4xx 形状并存是刻意分歧

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
2026-10-25 05:58:20 +08:00
adminandClaude Code 079dcff986 feat(console): 下线旧 API,托管上游完整前端构建产物
- 移除 /api/db/*、/api/ssw/tdc/node/identity*、/api/ssw/tdc/tds/* 及其旧 handler
- 静态托管改根挂载 + SPA fallback(深链回 index.html,vite base=/)
- /api/** 未命中回 404 + JSON(不吞成 SPA 的 HTML),/migrate.sql 同样 404
- 空体 405 改由响应改写中间件统一改写成业务信封,并保留 Allow 头
- 启动流程接入 registry::validate() fail-fast
- 交付 scripts/build-frontend.sh 作为可重放的前端构建入口

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 04:09:10 +08:00
adminandClaude Code 2cdbfcbcdc fix(routes): 空 body 的写请求回业务失败,不再建出全 null 的垃圾行
- JsonBody 去掉 Option:空 body 与畸形 JSON 走同一拒因(上游必填 @RequestBody
  ⇒ HttpMessageNotReadableException ⇒ 「请求体格式有误,请检查 JSON 结构与字段类型」)
- POST/PUT 的 body 取值改为 b.0(不再是 Option)
- 补 HTTP 级用例:空 body ⇒ HTTP 200 + code 400 + 上游原文,且不建出行
- detail_aggregate 查无分支改回 rustfmt 单行形态(仅此一处,其余历史违规不动)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 02:02:34 +08:00
adminandClaude Code 5d74354944 fix(routes): 请求体解析失败与方法不允许都回到业务信封
- 新增宽松 JSON 抽取器:畸形 body 不再返回 axum 默认的 text/plain 400,
  改为 HTTP 200 + code 400 + 上游原文「请求体格式有误,请检查 JSON 结构与字段类型」
- 方法不允许返回 JSON(405 + code/msg),不再是空体
- /Detail 的查无文案逐实体对齐上游:Dataset 与 Resource 文案不同
- /Detail 路径改从注册表取,不再硬编码
- 补 HTTP 级用例覆盖 GET {id} / POST / PUT / DELETE 与聚合体子表

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 01:41:27 +08:00
adminandClaude Code 0f84fbdb83 feat(routes): 18 实体 CRUD 路由装配 + 全链路冒烟
- 每个实体 6 条路由(列表/All/详情/新增/修改/删除),路径参数用 axum 0.8 的 {id}
- 冒烟覆盖:无凭证 401 裸三字段、内部令牌业务信封、/All 裸数组、协议版本不兼容 401
- 补资源侧只读聚合路由 /Resource/{id}/Detail 与 /Dataset/{id}/Detail(上游前端在用)

Co-Authored-By: Claude Code <[email protected]>
2026-10-25 00:06:23 +08:00
adminandClaude Code 0a3811585c fix(crud): 对齐评审发现的上游默认值、序号口径与错误脱敏
- 新建 Product/Resource 默认停用、Datasource 默认未测试(上游逐字,create_defaults 钩子)
- 补序号基线 used+1+i 的护栏测试;显式 null 不再抑制服务端默认值
- creator/last-modify 用户列改写操作人 id(对齐上游 safeUserId)
- delete 的「不存在」判定前置于禁删守卫;500 错误不再回显数据库原文
- DataInterface 的当日同前缀基线补 ALIVE 谓词(上游逐实体不同)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:41:56 +08:00
adminandClaude Code 8b73397d66 fix(crud): 编码重试次数与失败文案逐实体对齐上游
- Product/Resource 重试 5 次,DataInterface/Datasource 重试 3 次(上游逐实体不同)
- 失败文案取上游原文,不再统一用「接口编码生成失败」
- 补注 Datasource 查重口径的有意分歧(本仓更严,唯一索引为部分索引,不会插入冲突)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:09:03 +08:00
adminandClaude Code b4edff79c4 fix(crud): 写路径对齐上游(编码服务端生成 + 审计 actor + 约束失败转业务失败)
- 4 个编码列改为服务端生成,格式逐字对齐上游两套生成器(TdcCodeUtil / BizCodeUtil)
- 审计 actor 由登录主体推导,不再恒为「系统(自动)」
- DB 约束失败按 SQLSTATE 映射为业务失败(400),不再一律 500
- Contract 恒拒删;validate() 覆盖范围补齐

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 23:01:14 +08:00
adminandClaude Code 88464aaff9 feat(crud): 表无关的通用 CRUD 引擎
- list/all/detail/create/update/delete 六件套,行为逐条对齐上游 TdcCrudController
- 出参 camelCase、入参反查 f_ 列;null 值跳过;未知键静默忽略
- 过滤统一 CAST(col AS TEXT)=,规避上游 varchar 绑 smallint 的缺陷
- 冻结列只拒「值真的变化」,避免误伤整行回传的编辑弹窗
- 增补资源侧只读聚合体 detail_aggregate(fieldRules + maskRules),供上游前端 /{id}/Detail

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 22:50:07 +08:00
adminandClaude Code 17cfc505e9 fix(auth): 引导失败不得回传密钥 + 键集合测试对着生产函数断言 + 锁改为进程级
- bootstrap INSERT 失败时不再回传/打印密钥(否则会打印一个永远登不上的死凭证),
  且 main.rs 因「没有身份」直接退出进程
- me_payload_key_set_is_stable 改为走生产函数 me_payload 比对精确键集合(原先是字面量自证)
- db_lock 改为进程级单例(pglite-rs 每进程只允许一个 PGlite ⇒ 一个进程只需要一把锁),
  main.rs 只造一个 AppState
- 启动时每次回显生效的身份 id/identityCode;配置码与库中已有身份码不一致时明确告警
- 随机密钥挪到「确定要建身份」之后生成(签发即落库变成结构上的不变量)

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 19:42:35 +08:00
adminandClaude Code c29e12184b feat(auth): 应用状态 + 身份域(登录/Me/SsoConfig/Spaces)+ 首次启动身份引导
- state: AppState 持有 Arc<PGlite> + db_lock + 会话存储 + 配置
- identity: 登录逐字对齐上游 AuthController(5 条失败文案 + 常量时间比较密钥)
- bootstrap: 首次启动建本地身份并把随机密钥打印一次;已有身份则幂等跳过
- routes: build_router 装配 health/auth/crud 三段路由

Co-Authored-By: Claude Code <[email protected]>
2026-10-24 18:55:28 +08:00