feat(aihr): complete uni-app role workflows

2026-07-09 10:42:20 +08:00
parent e4070c8b8c
commit 678543e8a5
73 changed files with 15696 additions and 134 deletions
@@ -4,12 +4,13 @@

 - 后端：`backend`，来自 `dromara/RuoYi-Vue-Plus` 的 `5.X` 分支
 - 管理端前端：`frontend`，来自 `CrazyLionCat/plus-ui` 的 `5.X` 分支
- 移动端前端：`mobile`，独立 Vue/Vite 工程
+- 用户侧前端：`mobile-uni`，uni-app Vue3 H5 工程；旧 `mobile` 仅保留为 MVP 演示兜底

 ## 本地端口

 - 管理端前端：`http://127.0.0.1:5173/`
- 移动端前端：`http://127.0.0.1:5174/h5/user`
+- 旧移动端前端：`http://127.0.0.1:5174/h5/user`
+- uni-app 用户侧：`https://wygj-mobile-uni.localhost/h5/`
 - 后端：`http://127.0.0.1:8080/`
 - MySQL：`127.0.0.1:13306`，数据库 `ry-vue`，账号 `root/root`
 - Redis：`127.0.0.1:16379`，密码 `ruoyi123`
@@ -17,7 +18,28 @@
 - Qdrant REST：`http://127.0.0.1:6333`，默认 collection `aihr_knowledge`
 - 服务端资料导入根目录：`./.data/import`

-Qdrant 默认本地无需配置；远端或自定义 collection 可用 `AIHR_QDRANT_URL`、`AIHR_QDRANT_COLLECTION`、`AIHR_QDRANT_API_KEY` 覆盖。服务端资料导入根目录可用 `AIHR_IMPORT_ROOT` 或 `-Daihr.import.root` 覆盖。组织人员同步可用 `AIHR_ORG_SYNC_BASE_URL` 指向外部开放平台 `/open/v1` 前缀，并配置 `AIHR_ORG_SYNC_ACCESS_TOKEN` 或 `AIHR_ORG_SYNC_CLIENT_ID`/`AIHR_ORG_SYNC_CLIENT_SECRET`；如外部要求 HMAC 签名，再配置 `AIHR_ORG_SYNC_SIGNING_SECRET`。移动端手机号登录的短信模板 ID、阿里云 AccessKey、Secret 和短信签名都通过环境变量注入；本地放根目录 `.env.local`，`scripts/dev-backend.sh` 会自动加载。
+## portless 本地入口
+
+本机开发测试优先用 portless 访问稳定域名，避免继续记固定端口：
+
+- uni-app 用户侧：`https://wygj-mobile-uni.localhost/h5/`
+- 后端 API：`https://wygj-api.localhost`
+
+启动 uni-app 用户侧：
+
+```bash
+portless
+```
+
+portless 会按根目录 `portless.json` 执行 `mobile-uni` 的 `npm run dev`。旧 `./scripts/dev.sh` 仍会拉起 `mobile/` 作为演示兜底；新用户侧开发测试优先看 `wygj-mobile-uni.localhost`。
+
+若后端已经由 `./scripts/dev-backend.sh` 启动在 `8080`，注册一次静态别名：
+
+```bash
+portless alias wygj-api 8080
+```
+
+Qdrant 默认本地无需配置；远端或自定义 collection 可用 `AIHR_QDRANT_URL`、`AIHR_QDRANT_COLLECTION`、`AIHR_QDRANT_API_KEY` 覆盖。服务端资料导入根目录可用 `AIHR_IMPORT_ROOT` 或 `-Daihr.import.root` 覆盖。组织人员同步可用 `AIHR_ORG_SYNC_BASE_URL` 指向外部开放平台 `/api/open/v1` 前缀，并配置 `AIHR_ORG_SYNC_ACCESS_TOKEN` 或 `AIHR_ORG_SYNC_CLIENT_ID`/`AIHR_ORG_SYNC_CLIENT_SECRET`；业务请求会用 client secret 生成 HMAC-SHA256 hex 签名。移动端手机号登录的短信模板 ID、阿里云 AccessKey、Secret 和短信签名都通过环境变量注入；本地放根目录 `.env.local`，`scripts/dev-backend.sh` 会自动加载。若开放平台凭证放在 `backend/.env`，启动脚本也会加载该文件，并把 `client_id`/`client_secret` 映射为组织同步实际读取的 `AIHR_ORG_SYNC_CLIENT_ID`/`AIHR_ORG_SYNC_CLIENT_SECRET`。

 本地 `.env.local` 示例：

@@ -28,11 +50,14 @@ ALIYUN_SMS_ACCESS_KEY_SECRET=xxx
 ALIYUN_SMS_SIGN_NAME=物业AI助手
 # 演示兜底：非空则不真发短信，验证码固定为该值；dev 默认 123456，prod profile 代码级强制失效
 AIHR_SMS_DEV_FIXED_CODE=123456
-AIHR_ORG_SYNC_BASE_URL=https://hr.example.com/open/v1
+AIHR_ORG_SYNC_BASE_URL=https://wuye.meihe.cc/api/open/v1
 AIHR_ORG_SYNC_ACCESS_TOKEN=
 AIHR_ORG_SYNC_CLIENT_ID=
 AIHR_ORG_SYNC_CLIENT_SECRET=
 AIHR_ORG_SYNC_SIGNING_SECRET=
+# 若放在 backend/.env，也可沿用开放平台字段名：
+# client_id=dn_xxxxxx
+# client_secret=dns_xxxxxx
 # 试点成本闸门：超预算时改 false，chat/asr/tts 会走现有文本兜底
 AIHR_AI_RUNTIME_ENABLED=true
 AIHR_AI_CHAT_ENABLED=true
@@ -47,8 +72,11 @@ AIHR_AI_SPEECH_ENABLED=true

 ```bash
 ./scripts/dev.sh
+portless
 ```

+`./scripts/dev.sh` 启动后端、管理端和旧移动端兜底；`portless` 启动当前 `mobile-uni` 用户侧。
+
 首次启动或需要重建本地 `ry-vue` MVP 数据库时执行：

 ```bash
@@ -84,7 +112,7 @@ AIHR_AI_SPEECH_ENABLED=true
 - 启用 `aihr_model_config.category='vector'` 的模型配置后，上传会同步写入片段 embedding，并尽力 upsert 到 Qdrant；模型配置页可查看 Qdrant 维度、点数和片段向量数，并在维度不一致时重建索引；未配置或 Qdrant 不可用时只走 MySQL Fulltext/seed fallback，不影响检索。
 - 后端 `ruoyi-admin` 已完成 Maven 打包并启动在 `8080`
 - 前端依赖已安装，Vite 已启动在 `5173`
- 移动端依赖已安装，Vite 已启动在 `5174`
+- 旧移动端兜底依赖已安装，Vite 可启动在 `5174`；当前用户侧由 portless 启动 `mobile-uni`，入口 `https://wygj-mobile-uni.localhost/h5/`
 - 移动端手机号登录页已接 `/resource/sms/code` 与 `/auth/mobile/sms-login`；未配置真实 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`、`AIHR_SMS_LOGIN_TEMPLATE_ID` 时不会发送阿里云短信；手机号不存在时会自动注册为 `app_user`
 - 移动端员工端“开始训练”已复用 `/api/train/practice/start`、`/turn`、`/finish`；移动端请求需带登录返回的 `Authorization` 与 `clientid`；完成后主管端完训人数、“待复盘对练”计数、复盘列表、复盘详情、员工训练历史和能力画像会变化
 - 移动端候选人端“开始面试/面试练习”已复用 `/api/recruit/interview/start`、`/answer`、`/finish`；“补充资料”需带移动端 `Authorization` 与 `clientid`，上传后写 `sys_oss` 和 `aihr_candidate_material`，管理端 `/recruit/interview` 可审核为 `已通过/已驳回`
@@ -109,10 +137,10 @@ curl -fsS http://127.0.0.1:8080/api/knowledge/doc/vector-index-status -H "Author
 线上 `peilian.njzhmj.top` 由 Caddy 服务，`/h5*` 映射到服务器 `/opt/wygj/www/h5`，并 fallback 到 `/h5/index.html`。只改移动端静态资源时无需重启后端。

 ```bash
-VITE_BASE=/h5/ npm --prefix mobile run build
+npm --prefix mobile-uni run build:h5
 ssh YCWY 'ts=$(date +%Y%m%d%H%M%S); mkdir -p /opt/wygj/backups; cp -a /opt/wygj/www/h5 /opt/wygj/backups/h5-$ts; echo /opt/wygj/backups/h5-$ts'
-rsync -az --delete mobile/dist/ YCWY:/opt/wygj/www/h5/
-curl -k -s https://peilian.njzhmj.top/h5/supervisor | sed -n '1,20p'
+rsync -az --delete mobile-uni/dist/build/h5/ YCWY:/opt/wygj/www/h5/
+curl -k -s https://peilian.njzhmj.top/h5/ | sed -n '1,20p'
 ```

 ## MVP 页面验证
@@ -138,8 +166,9 @@ curl -k -s https://peilian.njzhmj.top/h5/supervisor | sed -n '1,20p'
 - 案例沉淀：进入 `/knowledge/cases`，上传真实语音 → “AI 整理” → “送审” → “入库”，应看到“已完成闭环”和新增案例记录；上传必须先完成 ASR 转写。
 - SOP知识库：进入 `/knowledge/sop`，可上传 txt/md/PDF/Word/Excel/PPT 文档入库；点击“检索” → “生成训练题”，应看到“已完成闭环”、命中数据库 SOP 原文片段和训练题；数据库不可用时页面回退 seed。
 - 资料处理：进入 `/knowledge/processing`，应看到资料总量、解析任务表、处理链路、规则与风险；可用少量文件验证“批量导入/选择目录/服务端导入”。**批量导入走异步队列**：提交即返回，页面出现“本次批量上传”进度面板（排队/加工中/完成/失败 + 单条重试），后台 worker 并发 2 逐条解析入库；暂存目录默认 `./.data/staging`（`aihr.upload.staging` 覆盖）。服务端导入读取 `./.data/import` 下的相对目录，启动后台任务并在页面显示进度，运行中任务可点“取消”；目录导入的重试粒度是同目录重新导入，批量上传的重试粒度是单文件。
- 移动端员工训练：进入 `http://127.0.0.1:5174/h5/user`，手机号登录（dev 验证码固定 `123456`）。员工端首页为「师傅区(mentor.png 头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图四色块→我的成长摘要」（视觉基准 `feedback/2026070423/design/`），底部 tab（今日/练/问/我）整页切换，滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页。点底部“练”进入 `http://127.0.0.1:5174/h5/user/training`，首屏应先看到场景模拟、开始练习和最近练过，每日三题在下方；点“开始练习”进入 `http://127.0.0.1:5174/h5/user/practice`，两次“填入建议回复 / 提交本轮”后应看到评分、导师改写、训练历史和能力画像；切到主管端后完训人数与“待复盘对练”计数增加，并展示待复盘列表；点进单条可看评分、话术、导师改写，并可标记已复盘。训练页有“语音输入”和“播报”按钮，需启用 asr/tts 模型后生效；iOS/WebView 若无法直接访问麦克风，会切到“选择语音”并用系统录音/音频文件继续走 ASR，否则降级文本。快捷 chip 或「问」打开查 SOP 面板：文本/语音提问 → 轻概要(回答+要点+注意)+依据折叠；点「生成总结卡·约10秒」弹出信息图卡（四步法/异议/话术/提醒+听一遍/开始跟读），需 chat 模型；语音需 asr 模型。
- 移动端候选人：进入 `http://127.0.0.1:5174/h5/candidate`，手机号登录（dev 验证码固定 `123456`）→ “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到“已提交资料”、`OSS ...`、`待审核`。再进入管理端 `/recruit/interview` 底部“候选资料审核”点“通过/驳回”，候选人端刷新后应显示新状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。
+- uni-app 员工端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/user/today/index`，手机号登录（dev 验证码固定 `123456`）。今日页进入问师傅、练习、案例素材和个人页；练习页应能完成开始练习、提交回应、结束评分、每日三题提交，个人页同步训练历史和成长证据包。
+- uni-app 主管端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/supervisor/index/index`，应看到团队概览、团队画像、团队预警、指派专项、待复盘和复盘详情；从团队画像派专项后，最近专项应立即回读新记录。
+- uni-app 候选人端：进入 `https://wygj-mobile-uni.localhost/h5/#/pages/candidate/index/index`，手机号登录（dev 验证码固定 `123456`）→ “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到资料状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。
 - 真 LLM 激活：在 `/system/model` 给供应商填 api_host/api_key 并启用 `category=chat` 模型后，三角色对练的客户回复与评分即为真实 LLM 生成；再启用 `category=asr/tts`（如硅基流动 SenseVoice/CosyVoice2）语音路径生效。未配置时全链路自动回退 seed。

 演示前可先跑最小预检：