# huimv-employment

灵活用工与用工税筹独立后端工程（fe-server）**骨架项目**，依据 `灵活用工项目技术方案.md` v1.2 初始化。

> 当前仅为多模块 Maven 骨架，各模块业务代码后续按需逐步实现。

## 目录结构

```text
huimv-employment/
├── fe-common/        # 统一响应 R、异常、常量、工具类
├── fe-dao/           # Entity、Mapper、MyBatis-Plus
├── fe-service/       # 业务 Service、规则引擎、状态机
├── fe-integration/   # 第三方 Adapter（人力平台 Mock + AI HTTP 客户端）
├── fe-api/           # Spring Boot 启动、Controller、Security
└── fe-miniapp/       # 微信小程序（非 Maven 模块）
```

## AI 交互方式

**不内置 Python AI 服务**。对话类请求由 fe-server 通过 **HTTP** 调用外部 AI 服务；AI 侧需回调 fe-server 的 `/internal/fe/**` 工具接口（查画像、写草稿、算成本等）。

```text
小程序 → fe-server(/api/v1/mp/agent/messages)
      → HTTP 调用外部 AI 服务
      → AI 回调 fe-server(/internal/fe/*)
      → 组装卡片返回小程序
```

AI 服务地址与密钥在 `application.yml` 的 `fe.ai` 节点配置。

## 技术栈（定稿）

- Spring Boot 2.7.18 + MyBatis-Plus + MySQL 5.7 + Redis
- Spring Security + JWT + Knife4j
- WxJava 小程序 SDK
- 外部 AI：HTTP 对接（通义 / 智谱 / DeepSeek 等自建或第三方网关）

## 快速验证

```bash
cd E:\luhao\code\huimv-employment\huimv-employment
mvn clean package -DskipTests
cd fe-api
mvn spring-boot:run
```

- 健康检查：`GET http://localhost:8080/api/v1/mp/health`
- 接口文档（骨架阶段已引入依赖，后续在 fe-api 配置）：`/doc.html`

## 相关文档

- 技术方案：`E:\luhao\工作交接\灵活用工\灵活用工项目技术方案.md`
- 数据库脚本：`E:\luhao\工作交接\灵活用工\灵活用工-mysql.sql`
- 第三方 Mock：`E:\luhao\工作交接\灵活用工\第三方平台对接接口-mock.json`
