TOS 开发周记 01:先把世界画出来
本文根据 2025-10-06 至 2025-10-12 的 Git 提交整理,是一篇待审核的历史开发周记。
从一张调试地图开始
这是现有 Git 历史里 TOS 的第一周。此时还没有客户端提交,主要工作都在后端:搭起服务、数据库连接和地图接口,再做一个可以直接观察结果的调试页面。
最初的两个 init 提交放进了 Zone 数据模型、地图路由与 MapRoom 等基础结构。随后增加的调试页,把原本只能从接口和数据库里查看的地图数据画到了浏览器中。对这个阶段来说,它不是附属工具,而是继续调整地图结构时最直接的反馈入口。
从区域到六边形地块
地图模型很快从区域继续细化到 Tile。add polygon 同时修改了 Tile、Zone、地图和地块路由,也扩展了调试页;换句话说,数据层增加六边形几何信息后,接口和可视化也一起跟了上来。
调试页在几次临时提交中反复调整:尝试缩放,随后撤掉一版缩放逻辑,再补上画布拖拽。最后一笔提交同时改动地图接口和页面,加入了直接绘制的能力。提交记录里能看出明显的试验轨迹,我没有把这些中间状态包装成已经定型的编辑器——这一周更准确的描述,是建立了一套可以看、可以拖、也可以尝试修改地图的原型工具。
留下可继续工作的起点
README 在同一周得到补充,项目的启动与使用信息不再只存在于代码中。至此,TOS 已经有了后端骨架、地图与地块数据,以及用于验证这些数据的可视化页面。功能仍然早期,但“世界数据—接口—调试视图”这条最初的链路已经出现。
提交记录
| 日期 | 仓库 | 提交 | 原始说明 |
|---|---|---|---|
| 2025-10-10 | 后端 | 461998f |
feat: init |
| 2025-10-10 | 后端 | 5b18325 |
feat: init |
| 2025-10-10 | 后端 | a484c65 |
feat: add debug page |
| 2025-10-11 | 后端 | 4b32e71 |
feat: add polygon |
| 2025-10-11 | 后端 | 5f7bec8 |
doc: add readme |
| 2025-10-11 | 后端 | 7f2393e |
tmp: support scale |
| 2025-10-12 | 后端 | 1a23aac |
tidy: remove scale logic |
| 2025-10-12 | 后端 | aedf167 |
tmp |
| 2025-10-12 | 后端 | bc598e3 |
feat: allow dragging canvas |
| 2025-10-12 | 后端 | f974dba |
fetat: allow to draw |