福大兄弟队——Alpha冲刺Day1：让开发与测试跑在同一条基线上

目录

一 今日目标与交付

日期：2026年10月23日。本轮冲刺持续到10月29日，共七天。今天的重点是让源码、场景、资源、数据和测试有一个共同起点，为后续十波流程、装备成长和保存续玩留出清楚的接线位置。

今天完成七人的独立交付，并按A01—G01顺序推送到Dev。原有三波主场景保留战斗与商店流程；宿舍区另有可运行的场景预览。本地数据层已可初始化和读写，云端完成工程、数据库及接口骨架。

二 站立式会议

跟进事项

• 客户端先保留三波可运行入口，明日开始拆分输入、暂停和对局流程。
• 场景碰撞按“阻挡移动”和“阻挡子弹”分别配置，后续地图高度边界使用独立规则处理。
• 属性、内容ID、检查点和返回结构先对齐，再连接成长、装备与云同步。
• 测试与功能并行推进，每天保留代码、运行结果和回归记录。

三 七名成员的进展

下面按任务归属汇总首日工作。AI参与了代码、资源索引和测试的实现与验证；各模块的交付、技术总结和下一步安排分别记录。

3.1 石华波｜A01 工程源码入仓与运行基线

3.2 陈炳珲｜B01 代码规范、任务验收与拆分

3.3 朱宇濠｜C01 本地数据库初始化与读写入口

3.4 游诗可｜D01 首图场景与碰撞配置基线

3.5 郭锦蓉｜E01 现有素材清单与内容索引

3.6 吴江彬｜F01 云端工程、四表与接口骨架

3.7 詹铖煜｜G01 测试基线、用例与自动化入口

3.8 七人提交索引

四 AI技术员的工作

今天让AI参与了具体实现，也让它执行已有规则对应的验证。采用结果以代码和运行输出为依据；模块负责人继续负责接口、规则和后续集成。

一个具体的协作过程：低矮障碍能否让子弹通过

输入给AI的规则是：花坛阻挡角色移动，但允许子弹越过；垃圾桶同时阻挡角色和子弹。实现时将两类阻挡能力拆成不同碰撞层，测试脚本再分别执行射线和角色运动检查。

这次协作的价值在于把文字规则落成了可以复验的断言。以后更换贴图或调整障碍尺寸时，仍能运行同一组检查，确认碰撞规则保持一致。

五 项目燃尽图

燃尽图按任务估算的剩余人时绘制。今天的开发交付计入已完成工作量，Issue编号在团队建项后补齐；明日继续根据实际剩余工作更新曲线。

六 程序运行与测试结果

6.1 宿舍区真实运行

首图使用水泥地背景，场内有两排共6段花坛、两侧垃圾桶和四面边界。角色支持WASD与点地移动。预览场景独立于原有三波主场景，便于接下来连接战斗HUD、敌人与波次控制。

6.2 本地数据库执行结果

本地仓储从DDL创建12张表，并通过命令行导入内容目录、创建档案及检查数据库。此次执行导入91项目录记录，完整性结果为ok，外键检查无异常。

{
  "catalog_entries": 91,
  "integrity": "ok",
  "foreign_key_errors": []
}

测试还覆盖了档案重复创建、关闭后重新打开、科研点整数限制、参数绑定和事务回滚。接下来由C02开始连接游戏内的属性与成长状态。

6.3 云接口执行结果

使用实际FastAPI应用和独立临时SQLite数据库执行接口调用，结果如下。

Day1建立了工程与接口骨架。账号认证、上传下载和双设备续玩按F02—F06继续实现。

6.4 测试汇总与复现

环境：Windows，Godot 4.7.2 stable，Compatibility渲染；Python依赖为FastAPI 0.161.1、Uvicorn 0.54.0、HTTPX 0.28.1、pytest 9.1.1。

在仓库根目录安装Server/requirements.txt后，可以执行：

python -m pytest Tests -q --junitxml=Tests/runtime/day1.xml
godot --headless --path Client --script res://tests/day1_smoke.gd
python -m Storage.cli --database Storage/runtime/day1.db --catalog Client/content/catalog_ref.json

执行中记录到一项Starlette对HTTPX适配的弃用提示；当前依赖组合下检查通过。后续扩展接口时统一处理兼容版本。

6.5 证据与版本索引

七 测试实践与明日安排

7.1 本轮采用的测试方法

围绕《构建之法》第2章的个人技术与流程，本轮将任务拆成可验收工作项，保留运行命令、交付和问题记录。围绕第13章的软件测试，先从数据库、接口和引擎三个层级建立可重复执行的检查，再随业务逐日扩展。

今天的测试已经参与开发：科研点更新同时验证整数与回滚，地图配置同时验证移动与射线，接口骨架同时验证状态和返回字段。后续交易、保存与同步接线时继续沿用这些入口。

7.2 明日集成顺序

1. B02先对齐属性、内容ID、检查点与返回结构。
2. A02、D02、E02并行推进输入暂停、主界面/HUD和基础敌人。
3. C02装配角色初始属性与修正；F02实现账号认证。
4. G02补充SQLite约束与事务检查，保留本日基线作为每日冒烟。

下一次站会继续逐项检查进展、困难和次日安排，记录新增问题及各模块的接线结果。