# AIOA 管理设计中心

React + TypeScript 管理端，当前提供两个配置工作台：

- 可视化表单设计器：字段添加与排序、属性配置、移动端卡片预览、Schema 生成、草稿保存和版本发布。
- 流程选择与绑定：选择已发布表单和 Flowable 定义，配置业务类型、请假类型、时长范围、优先级以及绑定启停。

流程绑定仅负责从权威业务数据选择已经部署的流程定义；客户端不能指定流程，已启动实例也不会因绑定变化而切换流程版本。

## 本地运行

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

```bash
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
```

再启动管理端：

```bash
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`；需要覆盖时可设置：

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

## 验证

```bash
npm test
npm run build
```

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