chore: track version files, docs, web app split, scripts (missed commits from March work)

2026-09-13 08:41:35 +08:00
parent 84c709bbcc
commit edf76db56b
33 changed files with 3082 additions and 504 deletions
@@ -0,0 +1,109 @@
+# INP2P 一页发布手册（P4.5 收官）
+
+更新时间：2026-03-08
+当前基线版本：`0.1.0+build.18`
+
+---
+
+## 0) 适用范围
+
+- 项目：`/root/.openclaw/workspace/inp2p`
+- 服务：`inp2ps.service`
+- 目标：每次发布都可复用本手册完成构建、部署、验收与留档
+
+---
+
+## 1) 标准发布流程（强制）
+
+```bash
+cd /root/.openclaw/workspace/inp2p
+make build
+systemctl restart inp2ps.service
+make verify-deploy
+```
+
+**判定规则：**
+- 仅当 `make verify-deploy` 全绿，才算发布成功。
+- 仅重启成功不算发布成功。
+
+**验收证据：**
+- 报告路径：`run/deploy-check/deploy-check-YYYYmmdd-HHMMSS.txt`
+
+---
+
+## 2) UI 交互规范（封板基线）
+
+### 2.1 按钮层级
+- `btn`：主路径提交（状态变更/写入）
+- `btn2`：次级动作（筛选、导出、切换、重试）
+- `btn-danger`：高风险动作（删除、踢下线、不可逆）
+
+### 2.2 文案规范
+- 刷新类统一“重新加载”
+- 空态统一“暂无 xxx 记录 + 下一步引导”
+- 批量反馈统一“成功/失败计数”
+
+### 2.3 快捷键规范
+- `/` 聚焦筛选
+- `r` 刷新
+- `g` 打开节点页
+- `?` 打开/关闭帮助
+- 输入法组合态、Ctrl/Alt/Meta 组合键不触发全局热键
+
+---
+
+## 3) 功能验收清单（最小集）
+
+1. 登录/登出正常，停用账号被拒绝
+2. 节点页：搜索、踢下线确认、改昵称/改IP
+3. SDWAN：保存 SDWAN/节点映射/子网代理
+4. 租户/Key/用户/enroll：单条与批量操作可用
+5. 失败池：保留开关、重试、清空行为正确
+6. 审计：预设筛选、清空筛选、CSV 导出、失败事件导出
+7. 最近操作摘要（opSummary）正确回显
+
+---
+
+## 4) 本轮阶段成果（摘要）
+
+### P0（人性化收尾）
+- 危险操作显式标红
+- 输入示例占位补齐
+- 复制快捷操作（Key/enroll）
+
+### P1（信息与审计可读性）
+- 常用操作区
+- 审计 action 标签化 + 高风险高亮
+- 审计快速筛选与清空
+- 空态引导、最近操作摘要
+
+### P2（效率提升）
+- 审计 CSV 导出 + 失败事件导出
+- 快捷键（/ r g ?）
+- 批量操作 + 二次确认 + 统计回执
+
+### P3（稳定性增强）
+- 批量并发执行 + 失败重试
+- 失败池保留/清空策略
+- 审计预设持久化
+- 热键冲突规避（输入法/组合键）
+
+### P4（封板）
+- 按钮层级统一
+- 文案词典落地
+- 最终回归清单沉淀
+
+---
+
+## 5) 发布签字项（可复制）
+
+- [ ] 已执行 `make build`
+- [ ] 已执行 `systemctl restart inp2ps.service`
+- [ ] 已执行 `make verify-deploy` 且全绿
+- [ ] 已记录 deploy-check 报告路径
+- [ ] 已完成最小功能回归
+- [ ] 已确认线上版本号与 `VERSION` 一致
+
+签字人：__________
+时间：__________
+报告：`run/deploy-check/deploy-check-________________.txt`