0011-mobile-controllers-shared-services.md 1.9 KB
status: accepted
移动端独立 Controller，共用业务 Service
2026-10-14：移动端专用接口原先分散在 PC Controller 中。为集中管理移动端契约，将其统一迁入 zksy-admin/src/main/java/com/zksy/web/controller/mobile。用户进一步确认统一 URL 前缀为 /api/mobile，移动端调用同步迁移；此决定取代同日初版保留旧 URL 的约定。
| Controller | 统一后的路由前缀或路径 |
|---|---|
| MobileWorkOrderController | /api/mobile/ops/workOrder |
| MobileInspectTaskController | /api/mobile/ops/inspectTask |
| MobileEquipmentController | /api/mobile/equipment-base |
| MobileAlarmController | /api/mobile/alarm |
| MobileNoticeController | /api/mobile/notice |
| MobileLogininforController | /api/mobile/monitor/logininfor/list |
| MobileContactsController | /api/mobile/contacts |
Controller 负责参数绑定、鉴权和响应适配，调用 PC 使用的现有业务 Service。可在业务 Service 内提供移动端查询方法，公司范围、当前用户范围及业务状态校验留在 Service，禁止通过调用 PC Controller 复用流程或复制一套移动端业务实现。
报警专用的 MobileAlarmService 撤销，其查询、范围、审核分别归入 AlarmOperationsService、AlarmReviewScopeService、AlarmReviewService。移动端审核的公开 Service 方法保留事务，与 PC 共用审核实现。
登录、验证码、个人资料、通用上传和工单处置等两端共用同一 URL 的接口仍保留原 Controller，不重复注册映射。以后新增移动端专属契约遵循本目录规则和 /api/mobile 前缀，旧移动端专用 URL 直接迁移，不保留双路由。
迁移保留原有权限、数据范围、参数及返回结构，通过 PC 与移动端 Controller 同时注册的映射测试和相关业务回归验证。管理后端和移动端必须同步更新，PC 无需改动；无需数据库迁移。