5 分钟启动一个决策引擎

环境要求

最低运行环境，企业版生产部署建议遵循生产规格手册。

方式一：Docker Compose 一键启动（推荐）

项目根目录包含完整的 docker-compose.yml，一行命令拉起所有服务。

# 1. Clone 仓库
git clone https://gitee.com/freshday/radar.git
cd radar-ee-enterprise

# 2. 一键启动 MySQL + Redis + Admin + Engine + Web
docker compose up -d

# 3. 查看日志
docker compose logs -f

启动后访问

• 管理后台http://localhost:3000
• Admin APIhttp://localhost:8080
• Engine APIhttp://localhost:8081
• Swagger 文档http://localhost:8080/swagger-ui.html

默认管理员账号在初始化 SQL 中创建，请查阅 README 获取首次登录凭证并尽快修改。

方式二：本地开发模式

适合参与开发与调试，需要先准备好本机的 MySQL 与 Redis。

cd radar-server
mvn clean install -DskipTests

# 启动管理后台 (:8080)
cd radar-admin
mvn spring-boot:run

# 启动决策引擎 (:8081)
cd ../radar-engine
mvn spring-boot:run

cd radar-admin-web
npm install

# 开发模式 (热更新, :3000)
npm run dev

# 生产构建 (含 vue-tsc 类型检查)
npm run build

第一次决策调用

创建模型与策略后，向 Engine API 发送一次决策请求。

POST http://localhost:8081/api/v1/decision/execute
Content-Type: application/json
X-API-Key: your-api-key

{
  "modelCode": "LOAN_PRE_CHECK",
  "requestId": "req-20260531-0001",
  "features": {
    "age": 28,
    "creditScore": 720,
    "monthlyIncome": 15000,
    "phone": "138****0000"
  }
}

{
  "code": 0,
  "message": "success",
  "data": {
    "requestId": "req-20260531-0001",
    "decision": "APPROVE",
    "score": 86,
    "hitRules": ["RULE_AGE_OK", "RULE_CREDIT_OK"],
    "latencyMs": 12
  }
}

主要 API 端点

基础路径：/api/v1

• 登录POST /auth/login
• 刷新 TokenPOST /auth/refresh
• 当前用户GET /auth/me
• 模型管理GET/POST /models
• 发布模型POST /models/{id}/publish
• 策略管理GET/POST /models/{modelId}/policies
• 规则管理GET/POST /policies/{policyId}/rules
• 特征源GET/POST /models/{modelId}/feature-sources
• 名单管理GET/POST /watchlists
• API KeyGET/POST /api-keys
• 决策执行POST /decision/execute（Engine）

完整 OpenAPI 规范请访问 /swagger-ui.html。

下一步

启动成功后，可以按以下路径深入。