2026-07-20 起，这套系统改成中央仓库协作开发：谁改代码都从同一个地方拉、往同一个地方推，push 到 main 就自动上线。这份文件记录我们是怎么接起来的、以后怎么一起维护。
两台电脑各自开发，汇到同一个私有仓库；仓库跟正式环境之间由 Railway 自动接管，中间没有人手动上传代码这一步。
敏感文件（.env · staff.json · ai-students.json）只留在各自电脑上，从不经过仓库这一段。
2026-07-20 起不强制走 PR 审核——两人经常没法同步在线互相看代码，卡在那一步反而拖慢。改成靠本地测试 + 沟通兜底，测过直接上线。
git clone 仓库 → npm install → 复制 .env.example 成自己的 .env。本地库跟线上完全隔离，怎么测都不会碰到真实数据。
说清楚在改哪个文件/哪块功能。没有人审核这道关了，靠这一步互相避让，避免两人同时改同一块代码。
起服务，把受影响的功能页面至少点一遍。这是唯一的安全网——线上是真人在用的系统，裸测等于拿正式环境当测试场。
测过的改动直接 git push 到 main（或开 PR 留个 diff 记录、自己 merge，PR 只是留痕不是关卡），Railway 自动拉代码构建，通常一分钟内上线。
看 Railway 部署日志或直接开正式环境页面，确认这次改动真的健康上线了。
系统能长期让两人 + AI 一起维护，靠的是这几条边界，不是靠记性。
staff.json / ai-students.json 全部 gitignore。需要真数据本地测试，找永良要，走 AirDrop / 加密盘，别用 IM 或邮件明文发。
main 就是线上push / merge 进 main 会直接部署到真实员工在用的系统。动手前问自己一句：这个改动本地测过了吗。
生产密钥都在 Railway 后台环境变量里，跟本地 .env 无关。本地 .env 自己填自己的测试值，不互传、不进仓库。
第一次拉这个项目，照这张表从上到下走一遍。
| 步骤 | 命令 / 位置 |
|---|---|
| 拉代码 | git clone https://github.com/DCT-TWC/dct-twc-ops.git |
| 装依赖 | npm install |
| 配环境 | cp .env.example .env，本地填 PORT=3200 / DB_PATH=./ops.db |
| 起服务 | npm start → 打开 http://localhost:3200 |
| 开分支 | git checkout -b feat/xxx |
| 推分支 | git push -u origin feat/xxx |
| 详细步骤 | 仓库里的 CONTRIBUTING.md |
| 系统设计 / 踩过的坑 | 仓库里的 HANDOFF-OPS.md |