long-agent/user-system
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
44e60be9184c1dcd07f9e6fa706a44001ba624a4
user-system/docs/plans/EXECUTION_PLAN.md

8.0 KiB
Raw Blame History

项目执行计划

📋 待完成任务 (13/20)

优先级分类

P0 - 环境配置（必须）

  • ⏳ Task 20: Go环境配置
  • ⏳ Task 3: 编译验证

P1 - 核心功能测试（必须）

  • ⏳ Task 8: 实现真实E2E测试（替换Mock）
  • ⏳ Task 15: 真实集成测试并验证所有API

P2 - 功能实现（重要）

  • ⏳ Task 9: 实现2FA多因素认证（TOTP）
  • ⏳ Task 10: 实现Admin管理后台（以 docs/plans/ADMIN_FRONTEND_EXECUTION_PLAN.md 为准）
  • ⏳ Task 11: 实现Webhook事件通知
  • ⏳ Task 12: 实现批量导入导出（Excel/CSV）

P3 - 高级功能（可选）

  • ⏳ Task 13: 实现Java/Go/Rust SDK
  • ⏳ Task 14: 实现IP黑白名单和异常登录检测

🎯 执行策略

策略A: 完整实现（推荐）

由于Go环境当前不可用，我将：

  1. P2功能实现（现在可以开始）

    • 实现2FA多因素认证
    • 实现Admin管理后台
    • 实现Webhook事件通知
    • 实现批量导入导出

  2. 等待Go环境配置

    • 您安装Go 1.23+
    • 验证编译
    • 运行测试

  3. P1核心功能测试

    • 替换Mock Handler为真实HTTP请求
    • 完成E2E测试
    • 验证所有API

  4. P3高级功能（可选）

    • 实现SDK支持
    • 实现安全增强功能

策略B: 环境优先

  1. 您先安装Go环境
  2. 验证编译和运行
  3. 然后实现剩余功能

📝 详细任务分解

Task 20: Go环境配置

依赖: 用户手动操作

步骤:

  1. 下载Go 1.23+: https://golang.org/dl/
  2. 安装到系统
  3. 重启命令行
  4. 验证: go version

预计时间: 30分钟

Task 3: 编译验证

依赖: Go环境已安装

步骤:

cd D:\project
go mod verify
go build ./cmd/server

预计时间: 5分钟

Task 8: 实现真实E2E测试

当前问题: E2E测试使用Mock Handler

需要修改:

  1. internal/e2e/e2e_test.go
    • 替换Mock Handler为真实HTTP请求
    • 使用真实的测试服务器
    • 集成真实的数据库

预计时间: 2-3小时

Task 15: 真实集成测试

步骤:

  1. 测试所有REST API
  2. 验证OAuth流程
  3. 验证权限控制
  4. 性能测试

预计时间: 2-3小时

Task 9: 实现2FA多因素认证

需要实现:

  1. TOTP（基于时间的一次性密码）
  2. 二维码生成
  3. 验证逻辑
  4. 恢复码机制

文件:

  • internal/auth/totp.go - TOTP实现
  • internal/service/totp_service.go - TOTP服务
  • internal/api/handler/totp.go - TOTP Handler

预计时间: 4-6小时

Task 10: 实现Admin管理后台

唯一执行方案:

  • 以 docs/plans/ADMIN_FRONTEND_EXECUTION_PLAN.md 为唯一有效方案

当前统一结论:

  1. 技术栈固定为 React 18 + TypeScript + Vite + React Router 6 + Ant Design 5
  2. 页面范围只允许对接当前真实 API，不再按 PRD 愿景假定接口存在
  3. 当前首版范围包括：
    • 登录 / 忘记密码 / 重置密码
    • Dashboard
    • Users
    • Roles
    • Permissions
    • Login Logs / Operation Logs
    • Webhooks
    • Import / Export
    • Profile / Profile Security
  4. 当前明确不做：
    • 系统设置
    • 用户创建
    • 批量用户操作
    • 管理员重置他人密码
    • 全局设备管理页
    • 社交登录 / 绑定的 SPA 落地

说明:

  • 本文不再维护 Task 10 的技术栈、页面清单、API 细节和工时拆分
  • 相关内容全部收敛到 docs/plans/ADMIN_FRONTEND_EXECUTION_PLAN.md

Task 11: 实现Webhook事件通知

需要实现:

  1. Webhook配置管理
  2. 事件触发机制
  3. HTTP请求发送
  4. 重试机制

文件:

  • internal/webhook/ - Webhook模块
  • internal/webhook/webhook.go - Webhook核心
  • internal/service/webhook_service.go - Webhook服务

预计时间: 4-6小时

Task 12: 实现批量导入导出

需要实现:

  1. Excel导入导出
  2. CSV导入导出
  3. 数据验证
  4. 错误处理

依赖:

  • github.com/tealeg/xlsx/v3 - Excel处理
  • encoding/csv - CSV处理

文件:

  • internal/importer/ - 导入导出模块
  • internal/importer/excel.go - Excel处理
  • internal/importer/csv.go - CSV处理
  • internal/api/handler/import.go - API Handler

预计时间: 4-6小时

Task 13: 实现SDK支持

需要实现:

  1. Java SDK
  2. Go SDK
  3. Rust SDK

文件:

  • sdk/java/ - Java SDK
  • sdk/go/ - Go SDK
  • sdk/rust/ - Rust SDK

预计时间: 8-12小时（每个SDK）

Task 14: 实现IP黑白名单和异常检测

需要实现:

  1. IP黑白名单管理
  2. 登录异常检测
  3. 风险评分
  4. 自动封禁

文件:

  • internal/security/ip_filter.go - IP过滤
  • internal/security/anomaly_detection.go - 异常检测
  • internal/service/security_service.go - 安全服务

预计时间: 4-6小时

🚀 开始执行

当前可以立即开始的任务（无需Go环境）

✅ 推荐立即开始:

  1. Task 9: 实现2FA多因素认证

    • 纯代码实现
    • 不需要编译运行
    • 优先级高

  2. Task 11: 实现Webhook事件通知

    • 纯代码实现
    • 独立模块
    • 优先级中

  3. Task 12: 实现批量导入导出

    • 纯代码实现
    • 实用功能
    • 优先级中

需要Go环境的任务

⏳ 等待Go环境:

  • Task 20: Go环境配置（需要您手动操作）
  • Task 3: 编译验证
  • Task 8: E2E测试（需要运行测试）
  • Task 15: 集成测试（需要运行测试）

复杂任务

⚠️ 需要更多时间:

  • Task 10: Admin管理后台（前端开发）
  • Task 13: SDK支持（多语言）

📊 预计完成时间

任务 预计时间 依赖
Task 9 (2FA) 4-6小时 无
Task 11 (Webhook) 4-6小时 无
Task 12 (导入导出) 4-6小时 无
Task 14 (IP黑名单) 4-6小时 无
Task 10 (Admin后台) 以唯一前端方案分阶段执行 真实 API 已稳定
Task 8 (E2E测试) 2-3小时 Go环境
Task 15 (集成测试) 2-3小时 Go环境
Task 13 (SDK) 8-12小时 无

总计: 不再使用本表对 Task 10 做旧版小时级估算，前端排期以 docs/plans/ADMIN_FRONTEND_EXECUTION_PLAN.md 为准。

🎯 建议执行顺序

方案A: 优先完成核心功能（推荐）

  1. Day 1-2: Task 9, 11, 12, 14（后端功能）

    • 2FA认证
    • Webhook通知
    • 批量导入导出
    • IP黑白名单

  2. Day 3+: Task 10（Admin后台）

    • 以前端唯一执行方案分阶段推进

  3. Day 4: Task 8, 15（测试）

    • E2E测试
    • 集成测试
    • （需要Go环境）

  4. Day 5-7: Task 13（SDK）

    • Java SDK
    • Go SDK
    • Rust SDK

方案B: 等待Go环境后统一测试

  1. 先安装Go环境
  2. 验证编译和运行
  3. 完成所有功能实现
  4. 统一测试和验证

📝 工作进度追踪

当前状态

任务 状态 开始时间 完成时间
Task 9 (2FA) ⏳ 待开始 - -
Task 10 (Admin) ⏳ 待开始 - 见唯一前端方案
Task 11 (Webhook) ⏳ 待开始 - -
Task 12 (导入导出) ⏳ 待开始 - -
Task 13 (SDK) ⏳ 待开始 - -
Task 14 (IP黑名单) ⏳ 待开始 - -
Task 20 (Go环境) ⏳ 待开始 - -
Task 3 (编译验证) ⏳ 待开始 - -
Task 8 (E2E测试) ⏳ 待开始 - -
Task 15 (集成测试) ⏳ 待开始 - -

🎯 下一步行动

选项1: 立即开始功能实现（推荐）

我将开始实现：

  1. Task 9: 2FA多因素认证
  2. Task 11: Webhook事件通知
  3. Task 12: 批量导入导出
  4. Task 14: IP黑白名单

选项2: 等待Go环境

您先安装Go环境，然后：

  1. 验证编译
  2. 运行测试
  3. 完成功能实现

选项3: 按需实现

告诉我您最需要的功能，我优先实现。

💡 提示

  • 纯代码任务（9, 11, 12, 13, 14）可以立即开始
  • 需要运行的任务（3, 8, 15）需要Go环境
  • 复杂任务（10, 13）需要更多时间
  • Task 20 需要您手动安装Go

您想让我立即开始实现哪些功能？

Reference in New Issue View Git Blame Copy Permalink