cont/mjava-sairui/modules/基础工程

基础工程模块

目标

为全部业务模块提供可构建的前后端工程、统一 API 格式、数据库连接、基础角色映射、操作留痕表、跨域配置和钉钉集成边界。

已交付

1. Spring Boot 2.7.18 + MyBatis-Plus 后端工程与健康检查接口。
2. MySQL 8 基础角色、钉钉用户角色映射和操作留痕表脚本。
3. Vue 3 + Vite 前端工程、移动端布局、模块路由和 API 请求封装。
4. 钉钉用户上下文接口及本地模拟身份 Header。

验收标准

1. 后端执行 mvn test 和 mvn package 均可通过。
2. 前端执行 npm run build 可通过。
3. 启动 MySQL 并配置数据库后，GET /api/v1/system/health 返回 code: 0 和 status: UP。
4. 启动前后端后，前端工作台显示后端服务已连接。

限制

真实钉钉免登、组织同步、角色授权、操作日志切面和生产环境密钥管理尚未实现，后续在“身份与权限”模块完成。

桌面工作台布局

前端应用外壳已调整为桌面工作台布局：顶部品牌栏、左侧业务导航和全宽内容工作区。市场维护等业务页面可利用更宽的可用区域展示表单与数据表；在移动端自动切换为底部导航布局。

参考布局风格

前端全局布局以项目资料中的“布局风格.html”为视觉参考，采用左侧品牌导航、右侧工作区、轻量顶部工具栏、快捷入口卡片、状态色和图标化操作。市场维护页面已同步采用圆角卡片、悬停反馈、图标按钮与聚焦态输入控件；业务功能和接口保持不变。