ArchForge为 AI 时代设计的企业级开发平台

契约先行的四仓架构 · Spring Boot 4.1 + Java 25 · 让 AI Agent 和人共用同一份事实源

快速开始

契约先行

GitHub

⚙️

现代底座

Spring Boot 4.1 + Java 25 虚拟线程。可选 Native Image（约 100ms 启动）。OpenTelemetry 开箱即用。

🧩

契约先行四仓

后端从代码生成 OpenAPI 契约与枚举，管理端、C 端按契约校验。已删除路径不会复活。

🤖

AI 原生

每仓内置 AGENTS.md。ArchForge/.agents 里的 skills 渐进披露。CLI 可安装 skill 并作为 MCP Server。

为什么是四个仓库？

ArchForge 由 四个独立 Git 仓库 组成，并列克隆，没有 git submodule。后端仓拥有契约（spec/openapi.yaml，由代码生成）和 AI 上下文（repos.yaml、AGENTS.md、.agents/），AI Agent 最先读它。原来的 ArchForgeSpec 仓已并入后端仓（ADR-0012）。

仓库	职责	本地端口
ArchForge	后端。`archforge-server-admin` + `archforge-server-web`	`:8080` / `:8081`
ArchForgeAdmin	管理端 UI（vue-pure-admin）	`:8848` → `:8080`
ArchForgeWeb	C 端（Next.js）	`:3000` → `:8081`
ArchForgeDocs	本 VitePress 站点	`npm run docs:dev`

先读契约先行，再读 AI 协作。开发者 CLI 在后端仓：./archforge。

本地跑起来

bash

git clone https://github.com/sofn/ArchForge.git
git clone https://github.com/sofn/ArchForgeAdmin.git
git clone https://github.com/sofn/ArchForgeWeb.git
git clone https://github.com/sofn/ArchForgeDocs.git

cd ArchForge
./archforge init --write
./archforge infra up
FILE_STORAGE_TYPE=local ./gradlew :archforge-server-admin:bootRun

默认管理员 admin / admin123（dev 开验证码）。目前没有公开托管 Demo，请本地或 Docker Compose 启动。