基于 OpenClaw + Claude Code 的端到端研发自动化系统
| 原则 | 说明 |
|---|---|
| 微服务架构 | 按业务领域拆分独立服务，支持独立部署和扩展 |
| 事件驱动 | 使用消息队列解耦服务，支持异步处理 |
| API First | 所有功能通过 API 暴露，支持多客户端接入 |
| 云原生 | 容器化部署，支持 K8S 编排和弹性伸缩 |
| 安全优先 | 多层安全防护，零信任架构 |
| 可观测性 | 完善的日志、指标、追踪体系 |
| 类别 | 技术选型 | 版本 | 选择理由 |
|---|---|---|---|
| 编程语言 | Python | 3.12+ | AI 生态丰富，开发效率高 |
| Web 框架 | FastAPI | 0.109+ | 高性能，原生异步，自动生成 OpenAPI 文档 |
| ORM | SQLAlchemy | 2.0+ | 成熟的 ORM，支持异步 |
| 数据验证 | Pydantic | 2.5+ | 类型安全，自动验证 |
| 认证授权 | JWT + OAuth2 | - | 标准化，易集成 |
| 任务队列 | Celery + Redis | 5.3+ | 成熟稳定，支持定时任务 |
| 实时通信 | WebSocket | - | 支持实时推送和人机交互 |
| 数据库类型 | 技术选型 | 用途 |
|---|---|---|
| 关系型数据库 | PostgreSQL 15+ | 核心业务数据存储 |
| 缓存数据库 | Redis 7+ | 会话管理、热点数据缓存 |
| 向量数据库 | pgvector / Qdrant | AI 记忆存储、语义搜索 |
| 对象存储 | MinIO / AWS S3 | 文件、代码包、制品存储 |
| 搜索引擎 | Elasticsearch 8+ | 日志检索、全文搜索 |
| 表名 | 说明 | 关键字段 |
|---|---|---|
users |
用户表 | id, username, email, role, is_active |
projects |
项目表 | id, name, owner_id, status, git_repository_url |
requirements |
需求表 | id, project_id, title, priority, status |
prds |
PRD 表 | id, requirement_id, version, content, approval_status |
technical_designs |
技术方案表 | id, prd_id, architecture_design, database_schema, api_specification |
tasks |
任务表 | id, project_id, task_type, status, assigned_agent_id |
code_commits |
代码提交表 | id, task_id, commit_hash, branch_name, diff_summary |
test_cases |
测试用例表 | id, task_id, test_type, content, status |
pipelines |
CI/CD 流水线表 | id, project_id, jenkins_job_name, pipeline_config |
pipeline_runs |
流水线运行记录表 | id, pipeline_id, run_number, status, duration_seconds |
human_approvals |
人机协同审批表 | id, task_id, approver_id, status, decision |
agent_configs |
Agent 配置表 | id, agent_type, model_provider, model_name, skills |
users (1) ──────< (N) projects
projects (1) ────< (N) requirements
requirements (1) ────< (N) prds
prds (1) ──────< (N) technical_designs
projects (1) ────< (N) tasks
tasks (1) ──────< (N) code_commits
tasks (1) ──────< (N) test_cases
projects (1) ────< (N) pipelines
pipelines (1) ────< (N) pipeline_runs
tasks (1) ──────< (N) human_approvals
| 项目 | 规范 |
|---|---|
| 协议 | HTTPS |
| 风格 | RESTful API |
| 数据格式 | JSON |
| 认证 | JWT Bearer Token |
| 版本控制 | URL Path Versioning (/api/v1/) |
| 文档 | OpenAPI 3.0 (Swagger) |
| 环境 | 用途 | 部署方式 | 资源 |
|---|---|---|---|
| Development | 开发测试 | Docker Compose | 本地/小型服务器 |
| Staging | 预发布验证 | K8S (单节点) | 中等规模集群 |
| Production | 生产环境 | K8S (多节点高可用) | 大规模集群 |
| 类别 | 指标 | 告警阈值 |
|---|---|---|
| 系统资源 | CPU 使用率 | > 80% |
| 内存使用率 | > 85% | |
| 磁盘使用率 | > 90% | |
| 应用性能 | API 响应时间 P95 | > 500ms |
| 错误率 | > 1% | |
| QPS | 根据容量规划 | |
| AI Agent | 任务成功率 | < 95% |
| Agent 响应时间 | > 30s | |
| Token 消耗速率 | 异常波动 |
{
"timestamp": "2026-03-15T08:30:00.000Z",
"level": "INFO",
"service": "task-orchestrator",
"trace_id": "abc123def456",
"span_id": "span789",
"message": "Task started successfully",
"context": {
"task_id": "task-123",
"project_id": "proj-456",
"agent_id": "be-dev-001"
},
"user_id": "user-789",
"ip_address": "192.168.1.100"
}| 节点编号 | 节点名称 | 协同方式 | 超时策略 |
|---|---|---|---|
| HIL-001 | 需求评审 | 人工审核 PRD | 24h 自动跳过或升级 |
| HIL-002 | PRD 确认 | 人工确认签字 | 48h 提醒，72h 升级 |
| HIL-003 | 技术方案评审 | 架构师审核 | 24h 自动流转 |
| HIL-004 | 代码合并审批 | Tech Lead 审批 PR | 可配置超时 |
| HIL-005 | 上线审批 | 发布经理审批 | 可配置超时 |