简介

Forgexa 是一个自主软件开发平台，通过编排 AI 编码 Agent 将需求转化为可工作、经过测试和评审的代码。

核心功能

1. 需求分析 — AI 分析自然语言需求，生成带验收标准的结构化规格说明
2. 方案生成 — AI 创建执行计划和工作项，将需求拆解为可执行的任务
3. 自动执行 — AI Agent（Claude Code、Codex 等）根据项目的 WORKFLOW.md 配置实现代码
4. 质量保证 — 自动化测试-修复循环、Lint 检查和 6 维质量门禁评分
5. 人工评审 — 质量门禁在合并前要求人工审批，确保人在环路中

核心概念

组织（Organization）

组织是最顶层的多租户容器。管理成员、强制预算限制、定义共享配置（SMTP、集成、工作流模板、运行时），所有工作空间继承这些设置。每个组织有三种角色：Owner、Admin 和 Member。

工作空间（Workspace）

工作空间属于某个组织，是项目的运营容器。持有项目、管理独立预算、团队成员与 RBAC 角色（Owner、Admin、Developer、Viewer），可定义细粒度权限的自定义角色。

项目（Project）

每个项目有 Git 仓库、技术栈定义和 WORKFLOW.md 配置文件，用于规定 AI Agent 的工作方式。

需求（Requirement）

以自然语言提交需求，由 AI 分析后生成结构化规格说明。审批通过的需求会生成执行计划。

计划与执行（Plan & Execution）

计划由工作项组成，映射到执行节点（设计 → 编码 → 测试 → 评审）。编排器将节点分发到运行时守护进程。

运行时守护进程（Runtime Daemon）

运行在开发机器上的轻量级进程，发现已安装的 AI Agent CLI，注册到服务器，在隔离工作空间中执行任务。

质量门禁（Quality Gate）

执行完成后计算 6 维质量评分。根据可配置阈值，变更可以自动合并、要求人工评审或被阻断。

架构概览

┌─────────┐    ┌─────────────┐    ┌──────────────┐
│  Web UI │───▶│  API 服务器  │───▶│  PostgreSQL  │
│ (React) │    │  (FastAPI)  │    │  + pgvector  │
└─────────┘    └──────┬──────┘    └──────────────┘
                      │
┌─────────┐    ┌──────┴──────┐
│  桌面端  │───▶│    Redis    │
│ (Tauri) │    │  (事件总线)  │
└─────────┘    └──────┬──────┘
                      │
            ┌─────────┴─────────┐
            │   运行时守护进程    │
            │   (宿主机器)      │
            │  ┌─────────────┐  │
            │  │ Claude Code │  │
            │  │ Codex       │  │
            │  │ OpenCode    │  │
            │  └─────────────┘  │
            └───────────────────┘

数据层级

组织 → 工作空间 → 项目 → 需求 → 执行