AIOA/admin-web/README.md

AIOA 管理设计中心

React + TypeScript 管理端，当前提供可视化表单设计器 MVP：字段添加与排序、属性配置、移动端卡片预览、Schema 生成、草稿保存和版本发布。

本地运行

先从仓库根目录启动 PostgreSQL、Keycloak 和后端：

docker compose --env-file .env.example -f deploy/compose/compose.yaml up -d postgres keycloak

cd backend
export JAVA_HOME=/usr/local/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home
export GRADLE_USER_HOME=/tmp/aioa-gradle-home
./gradlew --no-daemon :boot:bootRun

再启动管理端：

cd admin-web
npm ci
npm run dev -- --host 127.0.0.1

访问 http://127.0.0.1:5173，通过 Keycloak 登录。默认 OIDC Issuer 为 http://localhost:8081/realms/aioa，后端 API 为 http://localhost:8080/api/v1；需要覆盖时可设置：

VITE_OIDC_ISSUER=http://localhost:8081/realms/aioa
VITE_API_BASE_URL=http://localhost:8080/api/v1

验证

npm test
npm run build

Keycloak Realm 首次导入时会创建 aioa-admin-web 公共客户端并启用 Authorization Code + PKCE S256。若本机 Keycloak 已在加入该客户端之前启动，需要在开发环境重建 Keycloak 容器或通过管理控制台补入同名客户端。