 adminandClaude Code
|
15469ea635
|
docs(contract): §5.1 划清「两版后端可开同一个库」的适用范围(Ruling P47)
「两版后端可开同一个库」这句话原文只挂在 3 张业务表上;base_* 7 张是官方 DDL 逐字,
而 react 的 base_* entity 只是子集 ⇒ react 后端打不开本仓的库(synchronize 会 ALTER)。
补一段显式注解:写以官方 DDL 为准,读以 react entity 列集为准(§5.3)。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:38:45 +08:00 |
|
 adminandClaude Code
|
a77d8c1769
|
docs(spec): §7.2/§7.3/§7.4 回写「只 SET body 里出现的键」全局规则(Ruling P42)
§7.1 早已写明「只覆盖 body 里出现的键,undefined ⇒ 不动原值」,但 §7.2/§7.3/§7.4
只是没重复这句 ⇒ 逐字实现会把 f_url_address / f_icon / f_en_code / f_description
在 body 缺该键时写成 NULL/空。
🔴 承重之处:菜单的 f_url_address 是 §8.2 权限守卫的比对键 ⇒ 被清成 NULL ⇒
该菜单变成「未映射」⇒ 守卫走「未映射放行」⇒ 任何登录用户都能访问该模块(静默越权)。
本次回写:
- §7 开头加全局规则(react / TypeORM save 的 undefined 语义),并写明例外:
凡显式给出 `?? 原值` / `|| '0'` / `? 1 : 0` 兜底表达式的列,一律按表达式求值。
- §7.2 Role / §7.3 Organize / §7.4 Module 的更新条目统一标注「body 有才覆盖」。
- 标注 f_url_address 的越权风险。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:26:23 +08:00 |
|
 adminandClaude Code
|
aa45da8e29
|
docs(spec): §11 验收门① 的 release profile 去掉 panic="abort"(Ruling P19)
§6.5 要求 panic ⇒ HTTP 200 + code=400,而 panic="abort" 下 catch_unwind
抓不到 panic(进程直接 abort ⇒ 客户端连接重置)。Ruling P19 已决定保留默认
unwind,但 §11 的表格里仍写着 panic="abort",与 Cargo.toml 现状矛盾 ——
按契约写的实现者会把 panic="abort" 加回去。此处消除矛盾。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 21:11:11 +08:00 |
|
 adminandClaude Code
|
0fef2fbfb7
|
docs(spec): 投影别名改双引号(PG 折叠未加引号的标识符)
Task 3 实现者实测发现:PostgreSQL 把未加引号的别名折叠成小写 ——
`SELECT row_to_json(q)::text FROM (SELECT 1 AS realName) q` ⇒ {"realname":1},
写 AS "realName" 才是 {"realName":1}。规格原先给的示例(§R1.4 / §5.2 / §5.3)
照抄会**静默**产出小写 JSON 键 ⇒ 前端读不到字段。
- §R1.4 / §4 / §5.2 / §5.3:规范写法改为 `f_xxx AS "<JSON键>"`(带双引号)。
- §5.4:登记 db.rs 的键归一为**安全网**(能兜住漏引号的写法),但规范写法不依赖它。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 18:07:45 +08:00 |
|
 adminandClaude Code
|
349aeef06f
|
docs(spec): 规格 §9 对齐 pglite::Error 与 state.rs;release 去掉 panic=abort
- §9 crud.rs 三个签名统一成 `pglite::Error`(原写的 `DbError` 未定义)
- §9 lib.rs 清单补 `pub mod state;`(Ruling P14:AppState 归 state.rs,Task 4 是 lib.rs 唯一写入者)
- 根 Cargo.toml 去掉 `[profile.release] panic = "abort"`:
规格 §6.5 要求 panic ⇒ HTTP 200 + code=400,而 abort 下 catch_unwind 抓不到
panic(进程直接死 ⇒ 客户端连接重置)。catch-all 中间件依赖默认 unwind。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:50:06 +08:00 |
|
 adminandClaude Code
|
28de290be5
|
docs: 业务表 DDL 逐字对齐 react entity(列宽 + f_stock 默认值)
读 react 三个 business entity 源码后发现原 DDL 描述有 3 处偏差:
- demo_item.f_status 实际 varchar(32)(原写 50)
- book_shop_book.f_isbn 实际 varchar(32)(原写 50)
- book_shop_book.f_stock 实际带 default: 0(原写「只有 f_delete_mark 有默认值」)
第三处是真契约分歧:§7.6 路径 2(带 id 但行不存在)在 react 里 f_stock 得 0,
按原描述实现会得 NULL。已同步修正 §5.1 与 §7.6。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:42:45 +08:00 |
|
 adminandClaude Code
|
f44b3000a0
|
docs: 定死 lib.rs 归属、schema 幂等口径、cipher 失败文案
- §9:AppState 落独立 state.rs,lib.rs 的唯一 owner 是 Task 4(只加一行 pub mod state;)
- §5.5:schema.sql 只在 base_user 不存在时整体执行一次;索引带 IF NOT EXISTS
- §3 / §6.1:decrypt_to_md5 返回 None ⇒ 登录回 400 '账号或密码错误'(与 react 同形,不另造文案)
- §3:明确不加「解密结果长度 == 32」的额外校验(react 没有)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:34:35 +08:00 |
|
 adminandClaude Code
|
0de161ddef
|
docs: 补 panic 兜底信封与 405 传输层状态码
- R1.2 / §6.5 / §10:未捕获异常(panic / DB 报错)⇒ HTTP 200 + code=400
+ msg='系统异常,请联系管理员'(对齐 react 全局 ActionResultFilter 兜底)
- §6.5:405 定死为 HTTP 405 + {code:405,...},保留 Allow 头;
未知路由仍是唯一的 404 传输层例外
- §10 第 6 步:链尾加 catch-all 中间件(不能漏出 axum 默认 500 空 body)
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:31:49 +08:00 |
|
 adminandClaude Code
|
1db2f0a1db
|
docs: 修正投影别名铁律(AS 必须用 camelCase JSON 键)
row_to_json 用列的输出名当 JSON 键。原 §5.2 示例写的是 `AS creator_time`,
照抄会得到 `"creator_time"` 而 react 是 `"creatorTime"` ⇒ 前端字段全读不到。
§5.2/§5.3/R1.4 补上「每列显式 AS <JSON键>」并给出正确示例。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:21:08 +08:00 |
|
 adminandClaude Code
|
c927632dd9
|
docs: 规格 §7 按 react 源码逐字重写(9 处修正 + 1 处刻意偏离)
- §7.1–§7.6 逐条核对 react 源码后重写:User 更新也查重 / 总是覆盖
isAdministrator·organizeId;Role 更新不查重不碰 sortCode;Role 删除不带
itemType 过滤;Module 删除不带 objectType 过滤;Organize·Module 不写
creatorUserId;业务模块保存有三条路径;roleNames 查不到就跳过。
- §7.7 记录唯一刻意偏离:User Save 响应剥掉 password(react 泄露 md5 摘要,
可被重新加密成合法登录密文)——R1.6 优先于逐字一致。
- §6.3 授权端点:objectType 被忽略(一律落 f_object_type='role'),与 react 一致。
- §5.1 业务表只有 f_delete_mark 带 DEFAULT 0(§7.6 路径 2 依赖它)。
- §13 冒烟脚本:cipher 用后端 --enc、JSON 用 jq/python3、菜单树写字面量、
后端地址默认 127.0.0.1:30010。
Co-Authored-By: Claude Code <[email protected]>
|
2026-10-25 17:17:22 +08:00 |
|
 adminandClaude
|
4a7805ad65
|
docs: cipher 向量独立验算通过,修正长度断言(96 hex 字符,非 64)
Co-Authored-By: Claude <[email protected]>
|
2026-10-25 17:09:34 +08:00 |
|
 adminandClaude
|
6b8c30ebb3
|
docs: 规格补齐 LoginForm 定义与登录端点原始 body 解析注记
Co-Authored-By: Claude <[email protected]>
|
2026-10-25 17:05:49 +08:00 |
|
 adminandClaude
|
0aed12a102
|
docs: 契约规格 + 实施计划 + 官方 base_* DDL 原文
- docs/contract.md: 唯一规格来源(信封/cipher/端点/权限/种子/验收门)
- docs/ddl/base_ddl_raw.sql: 从官方 JNPF dump 逐字提取的 7 张 base_* DDL
- CLAUDE.md / HANDOFF.md: 项目级 agent 指引与交接文档
Co-Authored-By: Claude <[email protected]>
|
2026-10-25 17:05:00 +08:00 |
|