doc — 项目 TODO

📋 待开始 14 ▴ 收起

Flutter 客户端工程搭建（演示态跑通）
待开始高优 · 紧急二级

用 design/flutter/ 起步包建工程：pubspec 覆盖、theme/widgets/main 拷入、字体配置，flutter run 出登录→引导→主框架演示态。前端线起点，可与后端完全并行。

前端 iOS Android

🕐 2026-06-11
auth 模块（验证码/注册/登录/JWT）
待开始重要二级

邮箱验证码限频、注册自动 7 天 PRO 试用、argon2id、JWT RS256（access 15min + refresh 30d）、Redis 滑窗限流。依赖 #1。

后端

🕐 2026-06-11
codes 激活码模块
待开始重要二级

批量生成（Crockford Base32 + 校验位，库存 hash）、发卡店 webhook（HMAC）、兑换幂等 + 订阅顺延叠加、失败锁定、audit_log。依赖 #1。

后端

🕐 2026-06-11
devices + 订阅校验中间件
待开始重要二级

设备登记/移除（同步回收节点侧凭证）、套餐/到期/设备数校验中间件。依赖 #1、#2。

后端

🕐 2026-06-11
节点 agent 实现
待开始重要二级

轻量 agent：mTLS 自注册、心跳、sing-box 用户表增删（凭证下发/回收/TTL）、负载上报 Redis；cloud-init 一段式安装。依赖 #5 的 proto。

后端

🕐 2026-06-11
usage 用量 + 广告解锁
待开始重要二级

usage_daily 聚合（仅字节/分钟，无日志口径）、/v1/ads/unlock 验广告 SDK 回执、free 用户 connect 额度校验。依赖 #1。

后端

🕐 2026-06-11
Flutter 逐屏还原 + iPad 断点
待开始重要二级

对照 ui_kits/mobile + tablet 逐屏补齐：智能选择推荐卡、免费额度卡+看广告解锁、Tab 滑动切换、宽度 ≥900 切侧栏分栏（连接页双栏/节点双列网格）；四态验证（明暗×中英）。依赖 #9。

前端 iOS Android

🕐 2026-06-11
官网 Astro 迁移
待开始重要二级

ui_kits/website → Astro SSG + Cloudflare Pages 多镜像；保留 i18n 单显、响应式断点、全部脱敏文案。完全独立可并行。

Web 前端

🕐 2026-06-11
Web 用户中心（Next.js）
待开始重要二级

ui_kits/usercenter React 组件直接复用；先 mock 数据，后接 me/redeem/devices；TOTP 2FA。UI 部分独立并行，接口联调依赖 #2。

Web 前端

🕐 2026-06-11
弹性节点基建：Terraform + 一键更换
待开始重要二级

多厂商 API 适配层（providers 池）、cloud-init 模板、replace 一键更换（make-before-break）与全量滚动轮换、换 IP 不换机。依赖 #6 的 agent。

CI/CD 后端

🕐 2026-06-11
域名池 + CDN 前置 + 签名端点分发
待开始重要二级

四组域名隔离与冷备池、源站隐藏（回源鉴权）、Ed25519 签名端点更新与公告 JSON 多镜像、客户端 DoH/IP 直连兜底联动。可独立并行。

Web

🕐 2026-06-11
备份与灾备演练
待开始重要三级

xtrabackup 每日全量 + binlog 15min 增量、age 加密异地（独立身份账号）、月度恢复演练脚本、RPO≤15min/RTO≤4h 验证。

数据库 CI/CD

🕐 2026-06-11
管理端最小后台
待开始一般 / 优化二级

码批次生成导出、节点操作（replace/draining）、audit_log 查看；独立监听 + 内网白名单 + 2FA。依赖 #1。

后端 Web

🕐 2026-06-11
CI 流水线
待开始一般 / 优化三级

lint + 单测 + OpenAPI 同步校验 + 脱敏红线词扫描（UI 文案资源）+ 容器镜像构建。

CI/CD

🕐 2026-06-11

🔨 开发中 5 ▴ 收起

OpenAPI 契约 + MySQL migration 基线
开发中高优 · 紧急一级 0/6 子任务

依据 doc/02、doc/03：openapi.yaml 展开全部 /v1 契约（connect 返回 sing-box 凭证而非 WG peer）；MySQL 8 全量 DDL（users/devices/plans/subscriptions/codes/usage_daily/audit_log + providers/node_events/directory_version）。后端各模块的共同前置。

⏸ 待确认一级方案规划 · 确认后方可继续开发

openapi.yaml 13 端点 + MySQL 12 表 migration + plans seed；golang-migrate/oapi-codegen/chi；connect 返回 sing-box 凭证
📄 详见 doc/plans/01-openapi-mysql.md

在终端运行：
/todo approve 1
子任务 0 / 6 完成
- ○ 1A Go 模块骨架 + 工具链(go.mod/tools.go/Makefile)
  一级待开始
- ○ 1B MySQL migration 7 文件 + plans seed
  一级待开始
- ○ 1C openapi.yaml 契约(13 操作 + 全量 schema)
  一级待开始
- ○ 1D oapi-codegen 接线 + 生成代码入库
  一级待开始依赖:1A1C
- ○ 1E config + store(UTC DSN) + 自动迁移
  一级待开始依赖:1A1B
- ○ 1F apierr + idgen + CONVENTIONS.md
  二级待开始依赖:1A
后端数据库

🕐 2026-06-11
nodes 模块 + agent gRPC 协议设计
开发中高优 · 紧急一级 0/5 子任务

proto 定义（注册/心跳/凭证下发与回收/用量上报，mTLS 双向）、节点目录 version 灰度（if_version 304）、connect/disconnect 下发 REALITY/Hy2 参数、free 凭证 TTL。依赖 #1。

⏸ 待确认一级方案规划 · 确认后方可继续开发

agent gRPC proto(buf) + 控制面 nodes 模块；agent 主动拨号、下发服务端流、mTLS 内部CA、目录 version 灰度
📄 详见 doc/plans/05-nodes-grpc.md

在终端运行：
/todo approve 5
子任务 0 / 5 完成
- ○ 5A proto 契约 + buf 工具链(最先冻结)
  一级待开始
- ○ 5B mTLS/CA + 引导 token 框架
  一级待开始
- ○ 5C gRPC server + hub + 跨实例 pub/sub
  一级待开始依赖:5A5B
- ○ 5D 目录灰度 + connect/disconnect + 凭证编排
  一级待开始依赖:5C
- ○ 5E 生命周期状态机接口(供 #15)
  一级待开始依赖:5C
后端

🕐 2026-06-11
sing-box libbox 桥接 PoC（三端隧道）
开发中高优 · 紧急一级 0/8 子任务

gomobile AAR/XCFramework + iOS NetworkExtension / Android VpnService / 桌面 TUN 子进程；URLTest 智能选线、Kill-switch。全项目最大技术风险，应尽早并行启动。

⏸ 待确认一级方案规划 · 确认后方可继续开发

gomobile libbox + Platform Channel + 三端壳；首发桌面→Android→iOS；含数据面定稿 11A
📄 详见 doc/plans/11-libbox-bridge.md

在终端运行：
/todo approve 11
子任务 0 / 8 完成
- ○ 11A 数据面定稿 + 修订 ARCHITECTURE.md connect 契约
  一级待开始
- ○ 11B app/kernel 构建管线(AAR/XCFramework/桌面二进制)
  一级待开始
- ○ 11C 桥接 API 面(Channel 契约 + 三端原生骨架)
  一级待开始
- ○ 11D 桌面端 PoC M1(首发打通)
  一级待开始依赖:11A11B11C
- ○ 11E Android 端 PoC M2
  一级待开始依赖:11B11C
- ○ 11F iOS 端 PoC M3 + entitlement 申请
  一级待开始依赖:11B11C
- ○ 11G URLTest + Kill-switch + 弹性重连 M4/M5
  二级待开始依赖:11D
- ○ 11H 控制面联调 M6
  二级待开始依赖:11A
前端 iOS Android mac Windows

🕐 2026-06-11
探针判封 + 自动更换 scheduler
开发中高优 · 紧急一级 0/8 子任务

境内多 ISP 拨测 + 境外对照 + 流量骤降三路互证；blocked_suspect/confirmed 状态机、阈值与熔断、池水位告警、自动补新。依赖 #5、#14。

⏸ 待确认一级方案规划 · 确认后方可继续开发

探针汇聚入口 + 三路互证判定引擎 + make-before-break 自动更换 + 熔断；Go 单体 goroutine + Redis 选主
📄 详见 doc/plans/15-probe-scheduler.md

在终端运行：
/todo approve 15
子任务 0 / 8 完成
- ○ 15A 探针汇聚入口 + Redis 探针存储
  一级待开始
- ○ 15B 轻量探针客户端 L1/L2/L3
  一级待开始依赖:15A
- ○ 15C 第三方拨测 API 适配
  二级待开始依赖:15A
- ○ 15D 判定引擎 signals+rules+streak
  一级待开始依赖:15A
- ○ 15E 自动更换编排 + 养机灰度
  一级待开始依赖:15D
- ○ 15F 容量水位 + 熔断器
  二级待开始依赖:15E
- ○ 15G 告警出口 TG bot + runbook
  二级待开始依赖:15D
- ○ 15H scheduler 装配 + 选主 + 优雅退出
  一级待开始依赖:15D15E
后端

🕐 2026-06-11
档3 真实连接出网：新 VPS 全套部署（代码+部署脚本）
开发中高优 · 紧急一级

nodectl bootstrap-token 子命令 + deploy/single-node 一键部署脚本 + systemd unit；本机编译验证，机器到位端到端测试

⏸ 待确认一级方案规划 · 确认后方可继续开发

nodectl bootstrap-token 子命令 + deploy/single-node 部署脚本
📄 详见 /Users/wangjia/.claude/plans/majestic-kindling-boole.md

在终端运行：
/todo approve 23

后端部署 CI/CD

🕐 2026-06-16

🔍 待验收 4 ▴ 收起

客户端三端布局架构(mobile/tablet/desktop) + desktop 对齐设计稿
待验收高优 · 紧急一级

用 design-distill skill 重做：form_factor 三端判定 + shell/ 三端外壳(desktop_shell 对照 ui_kits/desktop/dapp.jsx：侧栏204·6项+套餐卡+顶栏主题切换+居中单列连接页) + navigation_provider(6视图) + contact_page/settings_page 一级页 + 截图diff验收。根因：MainFlutterWindow nib默认<900走窄屏；现宽屏分支是tablet双栏非desktop单列。plan: ~/.claude/plans/majestic-kindling-boole.md

前端 mac

🕐 2026-06-16
档2: 接真后端(本机置备 + 客户端去旁路/修keychain)
待验收高优 · 紧急一级

后端/客户端已就绪,只差: dev/ 本机置备(docker MySQL+Redis + JWT密钥 + migrate + seed节点 + run-local.sh) + 客户端修keychain(MacOsOptions useDataProtectionKeyChain:false) + 删dev旁路。验收: mac app 真注册→登录→拉真节点。plan: ~/.claude/plans/majestic-kindling-boole.md

后端前端 mac CI/CD

🕐 2026-06-16
Flutter 逐屏还原+iPad断点: l10n/Riverpod/三态连接/推荐卡/额度卡/Tab滑动/≥900分栏/golden/CI红线
待验收重要

🕐 2026-06-13
修复 macOS keychain entitlement (-34018) 导致登录写 token 失败
待验收重要二级

flutter_secure_storage 在未签名 macOS app 上 write keychain 抛 PlatformException -34018 'A required entitlement isnot present'。真实登录成功后调 saveTokens 写 keychain 会卡住/抛异常。需给 macos entitlements 加 keychain-access-groups，或 TokenStore.saveTokens 加错误兜底。当前 debug 用 devLogin 内存旁路绕过。栈: token_store.dart:17 / auth_provider.dart:44 / auth_screen.dart

前端 mac

🕐 2026-06-16

✅ 已验收 0 ▾ 展开

暂无条目

拒绝验收