fix(task12): run.sh 收窄 pkill + dev 就绪校验 + PORT 硬约定;HANDOFF §4/§5 对齐事实;check-module api 期望表
- run.sh stop:pkill 模式收窄到 target/release/tds-lite-rs,删掉 pkill -f "vite" (vite 交给 kill_ports 5173 按端口收);dev/backend 的二进制存在性检查提到 kill_ports 之前;dev 起完轮询 /api/health(最长 30s),不通则打印 backend.log 尾部并 exit 1;PORT ≠ 30010 明确报错 exit 2;mkdir 从文件顶部挪进 dev/stop/logs。 - scripts/check-module.sh:期望值表新增「前端 api 文件该有没有」(demo=无, shop/books=有)⇒ 期望有而文件缺失直接 ❌,不再打误导性绿灯;补 set -u 取舍注释 与「新增模块须同步期望表」注释。 - HANDOFF.md §4:去掉把 abort 型 panic 写成 release 配置的错误表述,②③ 门改成 实测值(177 passed / 0 failed、32 条断言);§5 step 11/12 对齐事实;§9 补记 exec 退出码透传与 stop 的实际停止路径。 - .gitignore 追加 src/backend/data.bak-*/;docs/runbook.md 同步本轮口径与记档项。 Co-Authored-By: Claude Code <[email protected]>
This commit is contained in:
1 parent
8edcd3507d
commit
c249f4167f
5 files changed
+152
-51
No files matched your search
+47
-24
@@ -18,6 +18,11 @@
|
||||
#
|
||||
# 退出码:0 全过 / 1 有 ❌ 项 / 2 用法错
|
||||
|
||||
# 🔴 **故意只用 `set -u`,不加 `-e` / `pipefail`** —— 这是有意的取舍,不是漏写:
|
||||
# 本脚本的判定**依赖 grep 的返回码**(grep 命中 ⇒ 记一条 ✅,不命中 ⇒ 记一条 ❌)。
|
||||
# 若加 `-e`,**第一条没命中的 grep 就会中止整个脚本** ⇒ 闸门只跑了一半就“静默变绿/变红”,
|
||||
# 反而把闸门弄坏。加 `pipefail` 同理(管道里任一段非 0 都会中止)。
|
||||
# ⇒ 想要「失败即停」请自己看末尾的 `PASS=` / `FAIL=` 与退出码。
|
||||
set -u
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
@@ -69,8 +74,12 @@ fi
|
||||
|
||||
# ---- 期望值表(逐字,来自契约 §8.4 + 契约 §5.3)----
|
||||
# 每个目标:表名 / ROUTE(= urlAddress = module_key)/ 种子 id / module_key(None = 仅登录)
|
||||
# / **前端 api 文件该有没有**(有 = 有 / 无 = 走 view 直连分支)
|
||||
#
|
||||
# 🔴 **新增业务模块时须同步改这张期望表**(app_code:Entity 的分支、目标清单 TARGETS、
|
||||
# 以及下面的 T_API 期望)—— 否则新模块会被判成「未知 app_code/Entity」退出 2。
|
||||
T_COUNT=${#TARGETS[@]}
|
||||
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=()
|
||||
T_APP=(); T_ENT=(); T_TABLE=(); T_ROUTE=(); T_SEED=(); T_MK=(); T_API=()
|
||||
for T in "${TARGETS[@]}"; do
|
||||
A="${T%%:*}"
|
||||
E="${T##*:}"
|
||||
@@ -78,14 +87,18 @@ for T in "${TARGETS[@]}"; do
|
||||
demo:DemoItem)
|
||||
T_TABLE+=("demo_item"); T_ROUTE+=("demo-item")
|
||||
T_SEED+=("m_demo"); T_MK+=("None")
|
||||
# demo **没有** api 文件:views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List')
|
||||
T_API+=("无")
|
||||
;;
|
||||
shop:Product)
|
||||
T_TABLE+=("shop_product"); T_ROUTE+=("shop/Product")
|
||||
T_SEED+=("m_product"); T_MK+=("shop/Product")
|
||||
T_API+=("有")
|
||||
;;
|
||||
books:Book)
|
||||
T_TABLE+=("book_shop_book"); T_ROUTE+=("books/Book")
|
||||
T_SEED+=("m_book"); T_MK+=("books/Book")
|
||||
T_API+=("有")
|
||||
;;
|
||||
*)
|
||||
echo "❌ 未知 app_code/Entity: ${A}/${E}"
|
||||
@@ -166,6 +179,7 @@ for i in $(seq 0 $((T_COUNT - 1))); do
|
||||
ROUTE="${T_ROUTE[$i]}"
|
||||
SEED_ID="${T_SEED[$i]}"
|
||||
MK="${T_MK[$i]}"
|
||||
API_EXP="${T_API[$i]}"
|
||||
LC="$(lower "$ENT")"
|
||||
URL="${APP}/${ENT}"
|
||||
|
||||
@@ -206,35 +220,44 @@ for i in $(seq 0 $((T_COUNT - 1))); do
|
||||
no "spec.module_key = ${SPEC_MK:-(没取到)},期望 ${MK}"
|
||||
fi
|
||||
|
||||
hdr "[${ENT}] 5) 前端 api 文件:api/${LC}.ts 含 list/save/delete 三导出"
|
||||
hdr "[${ENT}] 5) 前端 api 文件:api/${LC}.ts 含 list/save/delete 三导出(期望:${API_EXP})"
|
||||
API="$FE/src/api/${LC}.ts"
|
||||
VIEW="$FE/src/views/${ENT}.tsx"
|
||||
if [ -f "$API" ]; then
|
||||
# 命名约定:list 函数走「自然英语复数」(Book → listBooks / Product → listProducts)
|
||||
# save/delete 用 Entity 单数(PascalCase),与后端端点命名一致。
|
||||
PLURAL_ENT="$(plural "$ENT")"
|
||||
for fn in "list${PLURAL_ENT}" "save${ENT}" "delete${ENT}"; do
|
||||
if grep -qE "export[[:space:]]+const[[:space:]]+${fn}" "$API" 2>/dev/null; then
|
||||
ok "${fn} 导出存在"
|
||||
else
|
||||
no "${API} 缺 export const ${fn}(前端解构会 undefined)"
|
||||
fi
|
||||
done
|
||||
else
|
||||
# 🔴 本仓前端是逐字复制:demo 模块**没有** api 文件,
|
||||
# views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒
|
||||
# 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。
|
||||
ok "无 api/${LC}.ts(走 view 直连分支)"
|
||||
if [ -f "$VIEW" ]; then
|
||||
for ep in List Save Delete; do
|
||||
if grep -qE "request\.(get|post|delete)\([^)]*/ssw/${URL}/${ep}" "$VIEW" 2>/dev/null; then
|
||||
ok "views/${ENT}.tsx 直连 request → /ssw/${URL}/${ep}"
|
||||
if [ "${API_EXP}" = "有" ]; then
|
||||
# 期望**有** api 文件 ⇒ 缺文件就是 ❌(**不许**再打「无 api/xxx.ts」这种误导性绿灯)。
|
||||
if [ -f "$API" ]; then
|
||||
# 命名约定:list 函数走「自然英语复数」(Book → listBooks / Product → listProducts)
|
||||
# save/delete 用 Entity 单数(PascalCase),与后端端点命名一致。
|
||||
PLURAL_ENT="$(plural "$ENT")"
|
||||
for fn in "list${PLURAL_ENT}" "save${ENT}" "delete${ENT}"; do
|
||||
if grep -qE "export[[:space:]]+const[[:space:]]+${fn}" "$API" 2>/dev/null; then
|
||||
ok "${fn} 导出存在"
|
||||
else
|
||||
no "views/${ENT}.tsx 没有直连 request → /ssw/${URL}/${ep}"
|
||||
no "${API} 缺 export const ${fn}(前端解构会 undefined)"
|
||||
fi
|
||||
done
|
||||
else
|
||||
no "views/${ENT}.tsx 不存在,无法核对直连分支"
|
||||
no "缺 api/${LC}.ts(期望有:${ENT} 的前端必须有 api 层)"
|
||||
fi
|
||||
else
|
||||
# 期望**无** api 文件 ⇒ 本仓前端是逐字复制:demo 模块没有 api 文件,
|
||||
# views/DemoItem.tsx 直接 request.get('/ssw/demo/DemoItem/List') ⇒
|
||||
# 「前端 api 文件」这一接触点对 demo 走**直连分支**(两种都查不到才算 ❌)。
|
||||
if [ -f "$API" ]; then
|
||||
no "多出 api/${LC}.ts(期望无:${ENT} 走 view 直连分支)—— 请同步期望值表"
|
||||
else
|
||||
ok "无 api/${LC}.ts(期望无 ⇒ 走 view 直连分支)"
|
||||
if [ -f "$VIEW" ]; then
|
||||
for ep in List Save Delete; do
|
||||
if grep -qE "request\.(get|post|delete)\([^)]*/ssw/${URL}/${ep}" "$VIEW" 2>/dev/null; then
|
||||
ok "views/${ENT}.tsx 直连 request → /ssw/${URL}/${ep}"
|
||||
else
|
||||
no "views/${ENT}.tsx 没有直连 request → /ssw/${URL}/${ep}"
|
||||
fi
|
||||
done
|
||||
else
|
||||
no "views/${ENT}.tsx 不存在,无法核对直连分支"
|
||||
fi
|
||||
fi
|
||||
fi
|
||||
|
||||
|
||||
Reference in new issue
Block a user