memrelay
d2044a2337
MemRelay-Operation: checkpoint-save:nixmsg-readonly-familiarization-2026-09-30 MemRelay-Resource: 2043a55a-09e5-4ca4-9676-496343ec1947
43 lines
2.8 KiB
Markdown
43 lines
2.8 KiB
Markdown
---
|
||
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 历史。 |