docs: ADR 体系废除 + architecture.md 确立为架构唯一事实源（2026-10-15 用户令：决策记录归 git commit log，不另存决策文档）
- 删除 design/dev/architecture/adr-0001~0007 共 7 份文件（内容留 git 历史可查） - architecture.md：删「ADR 审计」「ADR 立项清单」两节；清除全文 ADR-000X 注记、QQ 表/S 表 ADR 引用；未决表关闭已落定项（QQ-01/02/03），立项清单在途事项转登记 QQ-11~14；补 A1 生成姿态事实、autoload 四件清单、board_generator 性能姿态；文档状态立「事实源地位」条 - CLAUDE.md：恢复 RNG 单点硬性红线（去 ADR-0007 引用）；新增「架构事实唯一源」红线；规范导航架构行标注唯一事实源 - doc-conventions：§5 增「架构事实唯一源」行；§11 活文档清单补架构文档 - registry：architecture.yaml 删 18 处 adr 字段、autoload_set 补 SaveManager/MetaProgression、board_rending 更新为 Node2D 已落地事实；entities.yaml 12 处引用清除 - game/ 代码注释约 60 处清 ADR-000X 引用（事实与日期保留）；豁免标记 ADR-0007-exempt → rng-seed-exempt（main.gd/static_scan.sh/architecture.md/06/iter27 五处同步） - GDD/qa 实现报告/research 卡片/roadmap/tests README 引用全清；死链校验 1206 链接 0 死链、gdd_lint 0 不通过 - 代码中 adr/adr5 等为 adventure_runner 既有局部变量名（非 ADR 引用），未动
This commit is contained in:
DKChan committed
1 parent
f22adb5564
commit
6c2dbc37c1
73 files changed
+193
-1118
No files matched your search
@@ -1,7 +1,7 @@
|
||||
# Test Infrastructure — Dungeon Sweeper
|
||||
|
||||
**Engine**: Godot 4.7.2-stable（GDScript 单语言）
|
||||
**Test Framework**: 双载体（ADR-0004）——`--headless --script` 逻辑冒烟 + headless 场景探针；gdUnit4 **deferred**（D2 OQ1 关闭形态，正式 CI 期再议）
|
||||
**Test Framework**: 双载体——`--headless --script` 逻辑冒烟 + headless 场景探针；gdUnit4 **deferred**（D2 OQ1 关闭形态，正式 CI 期再议）
|
||||
**CI**: `.github/workflows/tests.yml`（首次 push 到 GitHub 后自动生效；仓库已初始化 git、尚未配置远端）
|
||||
**Setup date**: 2026-09-12（2026-09-27 `7f24b640` 三层收敛：根 tests/ 并入 `game/tests/`、docs 并入 `design/dev/`、production 解散）
|
||||
**参考实现**: `game/smoke/`（冒烟断言 + 场景探针族——正式工程的活样板；断言计数双口径见下节）
|
||||
@@ -14,7 +14,7 @@ tests/
|
||||
smoke/ # critical-paths.md——人工 gate 清单（/smoke-check 读取）
|
||||
evidence/ # 截图与人工签核记录
|
||||
run_all.gd # CI 冒烟统一入口（套件 manifest 协议，D2 AC-2b）
|
||||
static_scan.sh # ADR-0004 静态扫描域 S1–S8 可执行子集
|
||||
static_scan.sh # 静态扫描域 S1–S8 可执行子集
|
||||
```
|
||||
|
||||
> integration/ 目录已删空壳（迭代 19 卡① T4/Q8 2026-10-08——彼时仅有章程 README 无实体）。章程句保留在此：将来跨系统测试（Core-Core 集成、回放确定性〔同种子步骤流逐行相同——B1 AC-33 形态〕、存档/RNG 快照往返、A1×A2 双包含端到端）落地时随批建 `tests/integration/` 迁入；各 GDD 登记的 deferral 集成用例以对侧登记为生效条件。
|
||||
@@ -36,13 +36,13 @@ godot --headless --script tests/unit/example_test.gd
|
||||
# 场景探针（双载体之二）——以探针场景为运行目标，走完整项目引导（autoload 在位）
|
||||
godot --headless --path . res://smoke/<probe>.tscn
|
||||
|
||||
# CI 旁必须配外部 wall-clock 超时（ADR-0004：引擎无死锁探测）
|
||||
# CI 旁必须配外部 wall-clock 超时（引擎无死锁探测）
|
||||
timeout 120s godot --headless --script tests/run_all.gd
|
||||
```
|
||||
|
||||
> 单元/契约套件状态（单元测试与契约层批 2026-09-28 立基，后随迭代 7/8 增补）：`_suites()` manifest 已登记实跑 **18 套件**（第 18 套 = 迭代 19 卡④提灯载体批新增 `unit/core/fog_lantern_wiring_test` 提灯装配链〔行加载/schema/只读出口双态/enc 注入面〕——本分支基点早于卡④合并时实测 17 套全绿，合并后 18）——data_config（ConfigDB 加载/进度坐标 ceil 解析/fatal 退出码/统一随机流）、core（秘宝结构冻结/断点续玩/提灯装配链）、battle_settlement（DamageMath 纯函数/DamageController 伤害单据五配方）、contracts（系统间接口契约断言）、presentation（节奏队列/奖励浮层/字体资产/地形瓦片集）；致命类独立进程 `expect=1`。期望值一律由表读值推导（零玩法数值字面量）、随机只经 RngService 统一流。
|
||||
|
||||
**协议要点**（D2 冒烟协议 + ADR-0004）：
|
||||
**协议要点**（D2 冒烟协议）：
|
||||
- 冒烟脚本 `extends SceneTree` 以获得 `quit(code)`；成功 `quit(0)`、失败 `quit(1)`
|
||||
- `--script` 模式**不加载 autoload 且不注册全局标识符**（裸引用 `ConfigDB` = parse error）——ConfigDB/RngService 由脚本显式实例化，core 一律构造注入
|
||||
- 致命类用例独立进程，runner manifest 登记"调用 → 期望退出码"
|
||||
@@ -67,8 +67,8 @@ timeout 120s godot --headless --script tests/run_all.gd
|
||||
|
||||
## Static Scan（提交前双跑：本地 + CI）
|
||||
|
||||
`tests/static_scan.sh` 实现 ADR-0004 扫描域 S1–S8 的可执行子集；规则全集与动机见
|
||||
`design/dev/architecture/adr-0004-test-carrier-and-ci.md`。新违规案例必须**先补扫描规则再修码**。
|
||||
`tests/static_scan.sh` 实现静态扫描域 S1–S8 的可执行子集；规则全集与动机见
|
||||
`design/dev/architecture/architecture.md`「测试与质量域」节。新违规案例必须**先补扫描规则再修码**。
|
||||
|
||||
## CI
|
||||
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
# tests/run_all.gd — 单元测试统一入口（ADR-0004 双载体的逻辑测试调用点，套件 manifest 协议 D2 AC-2b）
|
||||
# tests/run_all.gd — 单元测试统一入口（双载体的逻辑测试调用点，套件 manifest 协议 D2 AC-2b）
|
||||
# 用法：godot --headless --path game --script res://tests/run_all.gd （CI 侧包装外部超时：timeout 120s …）
|
||||
# 协议：套件清单逐条"套件 → 期望退出码"；致命类独立进程（expect=1）。
|
||||
# 执行形态：逐套件起独立 Godot 子进程实跑
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
#!/usr/bin/env bash
|
||||
# tests/static_scan.sh — ADR-0004 静态扫描域 S1–S8 可执行子集
|
||||
# 规则全集与动机：design/dev/architecture/adr-0004-test-carrier-and-ci.md §Decision 3
|
||||
# tests/static_scan.sh — 静态扫描域 S1–S8 可执行子集
|
||||
# 规则全集与动机：design/dev/architecture/architecture.md「测试与质量域」节
|
||||
# 正式工程（core/ 存在）时执行；否则优雅跳过（工程在 game/core——2026-09-24 转正结构批后仓库根布局）。
|
||||
# 纪律：新违规案例必须先补本脚本规则再修码（design/dev/code-conventions.md 缺陷-规范对照表）。
|
||||
set -u
|
||||
@@ -34,7 +34,7 @@ fi
|
||||
# 2026-09-24 首次实跑收敛（转正结构批）：违规签名=裸 randomize/rand* 调用（实例方法 .randi() 排除）
|
||||
# + RngService 之外的 RandomNumberGenerator.new()；接收服务注入流的类型标注不属违规（core 五文件 15 处实证）
|
||||
hits=$(grep -rnE '\brandomize[[:space:]]*\(|(^|[^.[:alnum:]_])randi[[:space:]]*\(|(^|[^.[:alnum:]_])randf[[:space:]]*\(|(^|[^.[:alnum:]_])randf_range[[:space:]]*\(' \
|
||||
game/core game/presentation --include='*.gd' 2>/dev/null | grep -vE '^[^:]+:[0-9]+:[[:space:]]*#' | grep -v 'ADR-0007-exempt' | wc -l)
|
||||
game/core game/presentation --include='*.gd' 2>/dev/null | grep -vE '^[^:]+:[0-9]+:[[:space:]]*#' | grep -v 'rng-seed-exempt' | wc -l)
|
||||
hits2=$(grep -rn 'RandomNumberGenerator\.new()' game/core game/presentation --include='*.gd' 2>/dev/null | grep -vc rng_service)
|
||||
if [ "$hits" -gt 0 ] || [ "$hits2" -gt 0 ]; then echo "[static_scan] S1/S2 FAIL: 全局随机/RNG 自建命中 $hits+$hits2 处"; grep -rnE '\brandomize[[:space:]]*\(|(^|[^.[:alnum:]_])randi[[:space:]]*\(|(^|[^.[:alnum:]_])randf[[:space:]]*\(|(^|[^.[:alnum:]_])randf_range[[:space:]]*\(' game/core game/presentation --include='*.gd' 2>/dev/null; grep -rn 'RandomNumberGenerator\.new()' game/core game/presentation --include='*.gd' 2>/dev/null | grep -v rng_service; fail=1; else echo "[static_scan] S1/S2 ok"; fi
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# tests/unit/data_config/config_db_test.gd — 数据配置单元测试：表加载/进度坐标 ceil 解析/变异池门控/消费面访问器
|
||||
# 运行：godot --headless --path game --script res://tests/unit/data_config/config_db_test.gd
|
||||
# 协议（ADR-0004 + tests/README）：extends SceneTree + quit(code)；--script 模式无 autoload——显式实例化。
|
||||
# 协议（tests/README）：extends SceneTree + quit(code)；--script 模式无 autoload——显式实例化。
|
||||
# 红线：期望值由表读值推导，不写死玩法数值（tests/README 协议要点）。
|
||||
extends SceneTree
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
# 覆盖：六路线 schema 零违例（id 唯一/类型轴枚举/值域——出域行逐类构造各一行全部被拒）
|
||||
# + 满级特效留空（行字段闭集=无特效参数位 + 效果类型闭集 24 种零新增）+ 几何价格梯 20/30/45/67/101。
|
||||
# 运行：godot --headless --path game --script res://tests/unit/data_config/forge_table_test.gd（expect 0）
|
||||
# 协议（ADR-0004 + tests/README）：extends SceneTree + quit(code)；负向用例资源直构不碰生产表（enemy_table 先例）。
|
||||
# 协议（tests/README）：extends SceneTree + quit(code)；负向用例资源直构不碰生产表（enemy_table 先例）。
|
||||
extends SceneTree
|
||||
|
||||
const ConfigDBScript := preload("res://core/config_db.gd")
|
||||
|
||||
@@ -49,7 +49,7 @@ func _test_counter_ledger() -> void:
|
||||
rng.open_stream("armor_roll")
|
||||
var c2: int = rng.counter()
|
||||
Kit.check("open_stream 逐次推进全局计数器（+1/次）", c1 == c0 + 1 and c2 == c0 + 2)
|
||||
# 用途标签只进事件日志不参与派生——同 scope 同派生种子（ADR-0007 裁丙口径）
|
||||
# 用途标签只进事件日志不参与派生——同 scope 同派生种子（2026-09-27 统一流裁决口径）
|
||||
var rng_x = _fresh_service()
|
||||
var rng_y = _fresh_service()
|
||||
var s1: int = int(rng_x.open_stream("board_gen").seed)
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# tests/unit/example_test.gd — 示例测试：项目测试协议的活样板（gate-check 硬性要求 ≥1 示例测试）
|
||||
# 运行：godot --headless --script tests/unit/example_test.gd
|
||||
# 协议要点（ADR-0004 + D2 冒烟协议）：
|
||||
# 协议要点（D2 冒烟协议）：
|
||||
# extends SceneTree 以获得 quit(code)；断言失败 → push_error + quit(1)；全绿 → quit(0)
|
||||
# --script 模式无 autoload 且无全局标识符（裸引用 ConfigDB = parse error）——
|
||||
# 涉及表值的测试须显式实例化 ConfigDB，期望由表读值推导不写死
|
||||
|
||||
Reference in new issue
Block a user