---
title: Checkpoint 2026-09-29 22:36:38 UTC [de7d2eb653]
type: checkpoint
permalink: main/projects/25464650-ed5d-440e-b362-190f2852d451/checkpoint-2026-09-29-22-36-38-utc-de7d2eb653
stable_id: c28f8d69-d185-4df0-9803-c4b0c11850f0
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: t04-checkpoint-20260930-ready
created_at: '2026-09-29T22:36:38.291116+00:00'
updated_at: '2026-09-29T22:36:38.291116+00:00'
tags:
- t04
- ready-to-merge
- line-L
- feat/t04-contracts
---

## T0.4 完成（线 L）ready-to-merge

- **分支**：feat/t04-contracts
- **工作树**：E:/code/NixMsg-wt/t04（toplevel 确认非主工作区）
- **基于**：origin/main @ dd5a331
- **提交**：22c56d1 feat: 补齐模块接口契约与管理 API 文档
- **推送**：origin/feat/t04-contracts（普通推送，未强推，未推 main）
- **验证**：工作树内 task check 通过（web build、embeddist build、golangci-lint 0、go test 含 auth/app/*/port/wire）

## 交付内容
- internal/auth：HashPool、SessionTokens、APITokens、LoginLocks + Stub
- internal/app/message|identity|group|presence：Service 接口 + Stub
- internal/app/port：UplinkHandler / Downlink / ConnControl（broker↔app，选 app/port）
- cmd/nixmsg/wire.go 组装假实现；serve 接 RecoverOnStart，version/serve/healthz 不变
- docs/api/admin-api.md：第 8 节管理路由契约（含 Cookie/X-Nixmsg-Request/Bearer，响应无正文）
- docs/DEVIATIONS.md 总控 L T0.4 四条

## 契约覆盖路由
login/logout/me/password/overview/endpoints 列表开通 import batch 详情修改删除 kick reset-login-password talk-password unlock/registration/tokens 全部/groups 全部（含补充 GET 详情）/messages 列表详情/settings

## 没做
P/N/M/I/A 真实业务；mochi；admin HTTP 实现（仅文档契约）

## 给下个会话
可 ff-merge feat/t04-contracts；勿改主工作区；勿强推 main