# 基础工程模块

## 目标

为全部业务模块提供可构建的前后端工程、统一 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”为视觉参考，采用左侧品牌导航、右侧工作区、轻量顶部工具栏、快捷入口卡片、状态色和图标化操作。市场维护页面已同步采用圆角卡片、悬停反馈、图标按钮与聚焦态输入控件；业务功能和接口保持不变。