test(M01-B): 验证脱敏旧库迁移兼容
This commit is contained in:
@@ -1,10 +1,10 @@
|
||||
# 自助棋牌室系统
|
||||
|
||||
本仓库是 `panda/qipai.git` 的单一 Monorepo 工作区。Windows 固定开发路径为 `D:\qipai`,当前权威开发总纲为 [`V5.2.md`](./V5.2.md)。详细功能、模块顺序、验收标准和 Codex 纪律以总纲及 `docs/` 为准。
|
||||
本仓库是 `panda/qipai.git` 的单一 Monorepo 工作区。Windows 固定开发路径为 `D:\qipai`,当前权威开发总纲为 [`V5.3.md`](./V5.3.md)。详细功能、模块顺序、验收标准和 Codex 纪律以总纲及 `docs/` 为准。
|
||||
|
||||
## 固定约束
|
||||
|
||||
- 当前权威总纲:`V5.2.md`
|
||||
- 当前权威总纲:`V5.3.md`
|
||||
- 固定远端:`ssh://git@git.txyundm.cn:2222/panda/qipai.git`
|
||||
- 默认分支:`main`
|
||||
- 生产 API:`https://api.txyundm.cn`
|
||||
@@ -13,9 +13,8 @@
|
||||
- 后台 Web:`https://api.txyundm.cn/admin/`
|
||||
- 正式 MQTT Broker:`101.42.38.246:1883`
|
||||
- 生产系统:Ubuntu Server 24.04 x86-64/amd64,无桌面、无 Docker、无微信云开发
|
||||
- 后端运行时:Node.js 20+、npm 10+
|
||||
- 部署入口:Ubuntu 执行 `sudo bash /opt/apps/setup.sh`
|
||||
- 开发流程:Windows 本地开发与测试 → 完成一个模块 → 更新文档 → commit → SSH push `origin/main`
|
||||
- 开发流程:Windows 本地开发与测试 → 按 M00→M10 固定队列连续编码 → 每个子阶段测试/commit/SSH push/远端校验 → 自动进入下一子阶段
|
||||
|
||||
## 目录
|
||||
|
||||
@@ -36,7 +35,7 @@
|
||||
| 用途 | 位置 |
|
||||
|---|---|
|
||||
| 项目入口 | `D:\qipai\README.md` |
|
||||
| 当前总纲 | `D:\qipai\V5.2.md` |
|
||||
| 当前总纲 | `D:\qipai\V5.3.md` |
|
||||
| 完整配置索引 | `D:\qipai\docs\configuration.md` |
|
||||
| 仓库目录映射 | `D:\qipai\docs\repository-map.md` |
|
||||
| 后端开发配置 | `D:\qipai\backend\.env.development` |
|
||||
@@ -100,31 +99,35 @@ WSL 已验证:EMQX `5.8.9`、MQTTX CLI `1.13.0`、EMQX 服务 `active (running
|
||||
| Ubuntu 生产 | MQTT | `101.42.38.246:1883` | 待配置 | 待配置 | 禁止复用 WSL 凭据 |
|
||||
| Ubuntu 生产 | MySQL | `127.0.0.1:3306` | 待配置 | 待配置 | 配置后写入 `/etc/qipai/qipai.secrets` 并同步更新本表 |
|
||||
|
||||
## Codex 工程优先纪律
|
||||
|
||||
- 默认流程:读取必要文档 → 选择一个未完成子阶段 → 先修改工程文件 → 测试 → 增量更新既有文档 → commit → push。
|
||||
- 除用户明确要求只更新文档外,普通开发提交必须包含后端、后台、小程序、迁移、测试、脚本或部署配置中的实质工程变化。
|
||||
- 只修改 Markdown 不得把模块标记为 `DONE`,不得增加功能完成数。
|
||||
- 禁止连续两个纯文档提交;同一模块子阶段只保留一份开发日志,补丁追加到原日志。
|
||||
- `docs/current-baseline.md` 使用 `audited_commit` 做增量核验,禁止每次重新生成全量审计。
|
||||
- 详细门禁见 `V5.2.md` 的 `0.0 工程编码优先与反文档循环硬门禁`。
|
||||
## 持续开发规则
|
||||
|
||||
- 唯一模块顺序:`M00 → M01 → M02 → … → M10`,模块内按 `A → B → C → …`。
|
||||
- `docs/module-status.md` 顶部的 `execution_cursor` 是唯一续接游标;Codex 不重新规划、不从 M00 重来。
|
||||
- 一个 commit 只完成一个子阶段;同一次 Codex 会话可连续完成多个相邻子阶段。
|
||||
- 每个子阶段必须完成工程编码、真实测试、增量文档、commit、push,并验证 `HEAD == origin/main`。
|
||||
- 完成一个子阶段后,在会话资源允许时自动继续下一子阶段,不询问“是否继续”。
|
||||
- 纯 Markdown 变更不计业务进度;V5.3 文档提交后的下一次普通开发必须产生工程增量。
|
||||
- 当前游标、最近工程提交和下一工程目标以 `docs/module-status.md`、`docs/current-baseline.md` 为准,不在 README 中猜测。
|
||||
|
||||
## 当前进度
|
||||
|
||||
项目已开发部分模块;具体完成度不得从 README 猜测,必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md`、`docs/module-status.md`、`docs/feature-status.md` 为准。
|
||||
项目已开发部分模块;从 V4.8 切换到 V5.0 后仅新增少量内容。具体完成度不得从 README 猜测,必须以现有代码、测试、数据库迁移、Git 历史以及 `docs/current-baseline.md`、`docs/module-status.md`、`docs/feature-status.md` 为准。
|
||||
|
||||
- 最近工程提交:`8749a44 test(M01-B): 验证MySQL迁移往返`。
|
||||
- 下一工程目标:以 `docs/current-baseline.md` 的 `next_engineering_target` 为准,当前为 M01-B 脱敏旧库结构副本迁移与兼容读取验证。
|
||||
- 开发纪律:普通“继续开发”必须产生工程文件变化、测试、commit 和 push;只改 Markdown 不计入模块进度。
|
||||
- 当前执行游标:`M01-C`。
|
||||
- 最近工程提交:`8749a44`;本轮完成 M01-B 脱敏旧库副本迁移与兼容读取验证。
|
||||
- 下一工程目标:MySQL outbox、任务表和 PM2 worker 轻量异步任务基础。
|
||||
|
||||
## 版本递进
|
||||
|
||||
- **V4.8**:固定 `D:\qipai`、`参考/`、Monorepo、Windows/WSL 协作和模块完成即推送。
|
||||
- **V5.0**:固化 WSL EMQX 5.8.9、MQTTX CLI 1.13.0 和已有代码续接规则。
|
||||
- **V5.1**:同步 README,明确全部配置位置、明文凭据登记和 README 随总纲递进规则。
|
||||
- **V5.2**:增加工程编码优先、禁止文档循环、基线增量核验和工程证据门禁。
|
||||
- **V5.2**:增加工程编码优先、反文档循环、增量审计和工程完成证据。
|
||||
- **V5.3**:增加固定模块队列、执行游标、会话内自动推进、可中断恢复和跨模块回归检查点。
|
||||
|
||||
## Codex 入口
|
||||
|
||||
```text
|
||||
请阅读 V5.2.md,按当前进度继续开发。
|
||||
请阅读 V5.3.md,按当前进度继续开发。
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user