create: Checkpoint 2026-10-03 08:15:50 UTC [47f60e656e]

MemRelay-Operation: checkpoint-save:nixmsg-readonly-familiarization-2026-09-30
MemRelay-Resource: 2043a55a-09e5-4ca4-9676-496343ec1947

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 历史。