feat(aihr): complete uni-app role workflows
This commit is contained in:
@@ -8,7 +8,7 @@
|
||||
|
||||
- `backend/` 是 `dromara/RuoYi-Vue-Plus` 的 `5.X` 分支检出。
|
||||
- `frontend/` 是 `CrazyLionCat/plus-ui` 的 `5.X` 分支检出，只承载管理端。
|
||||
- `mobile/` 是独立移动端工程，承载员工端、候选人端、主管端；当前是 Vue/Vite H5，三端首页按 `docs/prototypes/*端-首页.png` 实现，后续确定小程序技术栈后再迁移到 uni-app/Taro。
|
||||
- `mobile-uni/` 是当前用户侧工程，承载员工端、候选人端、主管端，使用 uni-app Vue3 H5，后续便于转换 H5/APP/小程序；旧 `mobile/` 仅保留为 MVP 演示兜底，不再承载新增功能。
|
||||
- 本项目自己的本地编排放在根目录：`docker-compose.dev.yml`、`scripts/`；运行说明在 `docs/DEV_SETUP.md`。
|
||||
- 除非确实要接业务模块，不要改上游框架默认配置；本地端口和开关优先放根目录脚本里覆盖。
|
||||
|
||||
@@ -22,7 +22,8 @@
|
||||
- 本地私密配置：根目录 `.env.local` 已被 `.gitignore` 忽略，`scripts/dev-backend.sh` 会自动加载；阿里云短信密钥只放这里或外部环境变量，不写入 `application-*.yml`。
|
||||
- 后端：`./scripts/dev-backend.sh`，端口 `8080`。
|
||||
- 管理端前端：`./scripts/dev-frontend.sh`，端口 `5173`。
|
||||
- 移动端前端：`./scripts/dev-mobile.sh`，端口 `5174`。
|
||||
- 当前用户侧前端：`portless` 启动 `mobile-uni`，入口 `https://wygj-mobile-uni.localhost/h5/`。
|
||||
- 旧移动端兜底：`./scripts/dev-mobile.sh`，端口 `5174`，只用于回看 MVP 演示壳。
|
||||
- 重置数据：`./scripts/reset-dev-db.sh`，会删除并重建本地 `ry-vue`。
|
||||
|
||||
导入 SQL 必须带 `--default-character-set=utf8mb4`，否则中文昵称可能按错误字符集导入并触发字段长度问题。
|
||||
@@ -30,15 +31,15 @@
|
||||
## 验证口径
|
||||
|
||||
- 前端首页：`http://127.0.0.1:5173/`
|
||||
- 移动端首页：`http://127.0.0.1:5174/h5/user`
|
||||
- 用户侧首页：`https://wygj-mobile-uni.localhost/h5/`
|
||||
- 租户接口：`http://127.0.0.1:5173/dev-api/auth/tenant/list`
|
||||
- 验证码接口：`http://127.0.0.1:5173/dev-api/auth/code`
|
||||
- 默认登录：租户 `000000`，管理员 `admin / admin123`。
|
||||
|
||||
## 发布口径
|
||||
|
||||
- 线上移动端 H5：`https://peilian.njzhmj.top/h5/user`，Caddy 服务 `/opt/wygj/www/h5`。
|
||||
- 只发布移动端静态资源时，用 `VITE_BASE=/h5/ npm --prefix mobile run build` 后备份远端 `/opt/wygj/www/h5`，再 `rsync -az --delete mobile/dist/ YCWY:/opt/wygj/www/h5/`；前端静态修复不需要重启后端。
|
||||
- 线上移动端 H5：`https://peilian.njzhmj.top/h5/`，Caddy 服务 `/opt/wygj/www/h5`。
|
||||
- 只发布移动端静态资源时，用 `npm --prefix mobile-uni run build:h5` 后备份远端 `/opt/wygj/www/h5`，再 `rsync -az --delete mobile-uni/dist/build/h5/ YCWY:/opt/wygj/www/h5/`；前端静态修复不需要重启后端。
|
||||
|
||||
## 品牌入口
|
||||
|
||||
@@ -55,7 +56,7 @@
|
||||
- 资料处理：`frontend/src/views/knowledge/processing.vue`，路由 `/knowledge/processing`。
|
||||
- 模型配置：`frontend/src/views/system/model/index.vue`，路由 `/system/model`。
|
||||
- MVP 阶段侧栏只保留“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”。过滤逻辑在 `frontend/src/layout/components/Sidebar/index.vue`，不要在未明确要求时恢复若依默认全量菜单。
|
||||
- 移动端三端首页：`mobile/src/App.vue`，路由 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，分别对应用户/员工端、候选人端、主管端；兼容 `/h5/employee`、`/h5/admin`，但移动端不要把主管端等同后台系统管理员。员工端首页是「师傅区→今日安排→我的地图→我的成长摘要」（视觉基准 `docs/feedback/2026070423/design/` + REVIEW.md 修正项，修正项优先于图面）；员工端训练列表页是 `/h5/user/training`，首屏必须先给「场景模拟/开始练习/最近练过」，每日三题后置；点击「开始练习」进入独立 `/h5/user/practice` 对话页，不能在训练列表里用锚点或页内展开。师傅四状态(idle/listening/thinking/speaking)只从 `sopRecording/sopLoading/sopSpeaking` 推导，**不要新造状态源**；员工端底部 tab 钉死「今日/练/问/我」（visibleTabs 强制,不跟随后端 home 旧文案），整页互斥切换（isHomeTab + activeUserPanel/activeSupervisorPanel 条件），**不要把面板改回插入首页长页面的叠加渲染**；未实现入口进「建设中」整页（openBuildingPage），不留无反应按钮。查 SOP 全屏层（sopPanel）调 `/api/knowledge/search`（category='sop' 全库），关闭后回到进入前 tab；「生成总结卡」按需调 `/api/knowledge/summary-card`，失败明确报错可重试,不兜假数据。
|
||||
- 移动端三端首页：`mobile-uni/src/pages/*`，员工端 `/h5/#/pages/user/today/index`、候选人端 `/h5/#/pages/candidate/index/index`、主管端 `/h5/#/pages/supervisor/index/index`；`/h5/user`、`/h5/candidate`、`/h5/supervisor`、`/h5/employee`、`/h5/admin` 仅作为旧链接兼容重定向，移动端不要把主管端等同后台系统管理员。员工端首页是「师傅区→今日安排→我的地图→我的成长摘要」（视觉基准 `docs/feedback/2026070423/design/` + REVIEW.md 修正项，修正项优先于图面）；员工端训练页是 `/h5/#/pages/user/practice/index`，首屏必须先给「场景模拟/开始练习/最近练过」，每日三题后置；点击「开始练习」进入训练对话区域，不能在旧 `mobile/src/App.vue` 上继续堆锚点。师傅四状态(idle/listening/thinking/speaking)只从 `sopRecording/sopLoading/sopSpeaking` 推导，**不要新造状态源**；员工端底部 tab 钉死「今日/练/问/我」（visibleTabs 强制,不跟随后端 home 旧文案），整页互斥切换，**不要把面板改回插入首页长页面的叠加渲染**；未实现入口进「建设中」整页（openBuildingPage），不留无反应按钮。查 SOP 页面调 `/api/knowledge/search`（category='sop' 全库），关闭后回到进入前 tab；「生成总结卡」按需调 `/api/knowledge/summary-card`，失败明确报错可重试,不兜假数据。
|
||||
- 移动端首页接口：`GET /api/aihr/mobile/home/{role}`，当前 `@SaIgnore` 公开只读 seed，用于 H5 首屏 API 优先 + 本地 fallback；后续确定小程序登录后再接移动端 token，不复用管理后台登录态。
|
||||
- 移动端手机号登录：验证码发送走 `GET /resource/sms/code?phonenumber=...`，登录走 `POST /auth/mobile/sms-login`；短信发送复用 `sms.blends.config1` 阿里云配置。手机号不存在时自动注册 `app_user`，备注为“移动端短信自动注册”。模板 ID 用 `AIHR_SMS_LOGIN_TEMPLATE_ID`，AccessKey/Secret/签名用 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`，本地放 `.env.local`。dev 兜底：`aihr.sms.dev-fixed-code` 非空则验证码固定（dev 默认 `123456`）、不真发短信；prod profile 代码级强制失效，不要移除该闸门。
|
||||
- 移动端员工训练闭环：员工端首页“开始训练”复用 `POST /api/train/practice/start`、`/turn`、`/finish`，请求必须带移动端登录返回的 `Authorization` 与 `clientid`；`mode=mobile` 完成后写入 `aihr_practice_session`，并更新主管端首页完训率、“待复盘对练”、员工训练历史和能力画像。主管端复盘详情查 `GET /api/aihr/mobile/practice/reviews/{id}`，标记复盘用 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed`。
|
||||
|
||||
Reference in New Issue
Block a user