diff --git a/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-10-03 08-15-50 UTC [47f60e656e].md b/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-10-03 08-15-50 UTC [47f60e656e].md new file mode 100644 index 0000000..31178ed --- /dev/null +++ b/projects/25464650-ed5d-440e-b362-190f2852d451/Checkpoint 2026-10-03 08-15-50 UTC [47f60e656e].md @@ -0,0 +1,43 @@ +--- +title: Checkpoint 2026-10-03 08:15:50 UTC [47f60e656e] +type: checkpoint +permalink: main/projects/25464650-ed5d-440e-b362-190f2852d451/checkpoint-2026-10-03-08-15-50-utc-47f60e656e +stable_id: 2043a55a-09e5-4ca4-9676-496343ec1947 +scope: project +memory_type: checkpoint +project_id: 25464650-ed5d-440e-b362-190f2852d451 +usage_profile_id: 0c9feb46-d06e-43cd-9ef0-c5813c84a998 +status: active +revision: 1 +request_id: nixmsg-readonly-familiarization-2026-09-30 +created_at: '2026-10-03T08:15:50.644900+00:00' +updated_at: '2026-10-03T08:15:50.644900+00:00' +tags: +- handover +- readonly +- architecture +--- + +# NixMsg 只读熟悉报告检查点 + +时间:2026-09-30;仓库 E:\\code\\NixMsg;main;HEAD `069039f`,与 `origin/main` 对齐,工作区干净。 + +## 已完成 +- 只读核对 README、产品/开发/运维/任务/偏差文档、Go 服务端、SQLite 存储、协议、MQTT broker/listener、后台 API 与 Vue 前端、Go/JS/Python/Java SDK、部署文件、测试与验收报告。 +- 正式运行时实际入口为 `cmd/nixmsg/runServe`,真实业务装配在 `runServe`;`wire()` 仅是无 DB 的 stub 装配。 +- 启动链:配置校验 -> SQLite/迁移/写队列 -> 管理员密码存在性检查 -> auth/broker/message/presence/identity/group/admin/listener -> 消息恢复 -> 周期循环。 +- 连接链:listener 首字节/TLS/HTTP 协议分流 -> MQTT WS 或裸 TCP -> broker Session hello/认证/连接代号 -> appUplink -> 四个业务 app;响应经 QoS 1 下行。 +- 消息层负责提交、防重、授权、配额、调度、delivery、推送、ACK、撤回、过期、receipt 和重启恢复;SQLite 为持久状态,在线连接/watch 在进程内存。 +- 管理 API 具备 Cookie/API Token、CSRF、登录锁、端/群/注册/消息/概览/token/设置能力;前端路由和 API 调用关系已核对。 +- 四套 SDK 的 API、连接/重连/顶号/队列/幂等/ACK/取消语义与测试入口已核对。 +- 部署为前端构建 + Go 单二进制 + distroless nonroot;默认裸 go build 只嵌入 web/stub,正式前端需 `task build` 或 Docker 的 embeddist 构建。 + +## 验收与限制 +- 仓库已有 `test/accept/ACCEPTANCE.md`:通过 19、部分通过 4、失败 0、未测 0;报告生成时间 `2026-09-30T08:17:19Z`。 +- 部分通过:F03 环境/时长限制;F08 Windows 未跑 Linux netem;F21 裸 TCP 完整验收未覆盖;F22 Docker Compose/镜像全流程未完成。 +- 本轮没有运行构建、测试、Docker 或 SDK 命令;上述为仓库既有报告与源码证据,不是本轮新验证。 +- 早期 `docs/DEVIATIONS.md` 记录中的 stub 上行、未合批写队列、管理注册设置未接线等状态,当前代码已有对应实现或后续偏差记录,报告应以当前源码和最新验收为准。 + +## 交付 +- GenUI 面板已渲染 NixMsg 源码目录导航。 +- 未修改任何项目文件、配置、文档或 Git 历史。 \ No newline at end of file