diff --git a/.kiro/specs/odf-v102-update/design.md b/.kiro/specs/odf-v102-update/design.md
new file mode 100644
index 0000000..504338f
--- /dev/null
+++ b/.kiro/specs/odf-v102-update/design.md
@@ -0,0 +1,2143 @@
+# 设计文档 — ODF v1.0.2 功能更新
+
+## 概述
+
+本设计文档描述 ODF v1.0.2 版本的技术实现方案。基于现有 odf-uniapp（UniApp + Vue 3 Composition API）项目进行扩展，主要变更包括：
+
+1. 首页从公司列表改造为功能入口列表（支持权限控制）
+2. ODF 机架列表页新增签到功能
+3. 新增「干线」版块（公司列表 → 光缆列表 → 故障管理）
+4. 账号权限管理（前端根据后台配置过滤可见版块）
+5. 尝试性路线规划功能
+6. 后台管理前端（ZR.Vue）新增 4 个管理页面：光缆管理、干线故障管理、签到记录管理、用户模块权限管理
+
+项目沿用现有技术栈：UniApp + Vue 3 `<script setup>` + reactive store + 统一 request 封装，目标平台为安卓和 H5。后台管理前端基于 ZR.Vue（Vue 3 + Element Plus + Pinia + Vue Router + Vite）。
+
+## 架构
+
+### 现有架构分析
+
+当前项目采用扁平化架构：
+- `pages/` — 页面组件（每个页面一个目录，内含 index.vue）
+- `components/` — 公共组件（弹窗类）
+- `services/` — API 服务层（按业务模块拆分）
+- `store/` — 全局状态（reactive 对象，非 Vuex/Pinia）
+- `static/` — 静态资源
+
+### v1.0.2 架构扩展
+
+沿用现有架构模式，新增以下内容：
+
+```mermaid
+graph TD
+    A[首页 - 功能入口列表] -->|机房ODF| B[原 ODF 流程: 公司→地区→机房→机架列表]
+    A -->|干线| C[干线页 - 公司列表]
+    B --> D[机架列表页]
+    D -->|签到按钮| E[签到页]
+    C --> F[光缆列表页]
+    F -->|搜索| G[搜索结果页]
+    F --> H[故障列表页]
+    H --> I[故障详情页]
+    H --> J[新增故障页]
+    G -->|点击光缆| H
+    G -->|点击故障| I
+```
+
+### 新增页面
+
+| 页面 | 路径 | 说明 |
+|------|------|------|
+| 功能入口页 | `pages/portal/index` | 功能版块入口列表 |
+| 签到页 | `pages/checkin/index` | 外来人员签到表单 |
+| 干线页 | `pages/trunk/index` | 干线版块公司列表 |
+| 光缆列表页 | `pages/cable/index` | 某公司下光缆列表 |
+| 故障列表页 | `pages/fault-list/index` | 某光缆下故障事件列表 |
+| 故障详情页 | `pages/fault-detail/index` | 故障事件完整信息 |
+| 新增故障页 | `pages/fault-add/index` | 创建故障事件表单 |
+| 搜索结果页 | `pages/trunk-search/index` | 干线搜索结果分类展示 |
+| 路线规划页 | `pages/route-plan/index` | 尝试性路线规划功能 |
+
+### 新增服务模块
+
+| 模块 | 路径 | 说明 |
+|------|------|------|
+| trunk.js | `services/trunk.js` | 干线版块 API（光缆列表、故障 CRUD、搜索） |
+| checkin.js | `services/checkin.js` | 签到 API |
+| permission.js | `services/permission.js` | 权限查询 API |
+
+### 全局 UI 规范（基于现有项目代码风格）
+
+所有新增页面遵循以下统一规范：
+
+| 项目 | 规范值 |
+|------|--------|
+| 页面背景色 | `#F5F5F5` |
+| 主色（按钮、链接） | `#1A73EC` |
+| 正文文字色 | `#333` |
+| 辅助文字色 | `#999` |
+| 标题字号 | `34rpx`，`font-weight: 600` |
+| 正文字号 | `30rpx`，`font-weight: 500` |
+| 辅助字号 | `26rpx` |
+| 卡片背景 | `#fff` |
+| 卡片圆角 | `12rpx` |
+| 卡片阴影 | `box-shadow: 0 2rpx 12rpx rgba(0,0,0,0.06)` |
+| 页面内边距 | `padding: 0 24rpx` |
+| 卡片间距 | `margin-bottom: 20rpx` |
+| 导航栏高度 | `88rpx`（不含 statusBarHeight） |
+| 导航栏背景 | 使用 `bg-image`（`/static/images/home_bg.png`）+ `content` 层叠 |
+| 导航栏标题 | 白色 `#fff`，`34rpx`，居中 |
+| 返回图标 | `/static/images/ic_back.png`，`44rpx × 44rpx` |
+| 按钮圆角 | `12rpx`（行内按钮）/ `20rpx`（全宽按钮） |
+| 按钮文字 | 白色 `#fff`，`32rpx` |
+| navigationStyle | 所有页面均为 `custom`，使用 `statusBarHeight` 适配 |
+
+
+## 组件与接口
+
+### 通用导航栏结构
+
+所有内页（非首页/登录页）共用以下导航栏结构模板：
+
+```html
+<view class="nav-bar" :style="{ paddingTop: statusBarHeight + 'px' }">
+  <view class="nav-bar-inner">
+    <!-- 左侧：返回箭头 -->
+    <image class="nav-icon" src="/static/images/ic_back.png" @click="goBack" />
+    <!-- 中间：页面标题 -->
+    <text class="nav-title">标题</text>
+    <!-- 右侧：占位 / 功能按钮 -->
+    <view class="nav-icon-placeholder" />
+  </view>
+</view>
+```
+
+样式规范：
+- `.nav-bar`：宽度 100%，paddingTop 动态绑定 `statusBarHeight`
+- `.nav-bar-inner`：flex 布局，`justify-content: space-between`，高度 `88rpx`，左右 padding `24rpx`
+- `.nav-icon`：`44rpx × 44rpx`
+- `.nav-title`：`34rpx`，`font-weight: 600`，`color: #fff`
+- `.nav-icon-placeholder`：`44rpx × 44rpx`（无按钮时占位保持标题居中）
+
+---
+
+### 1. 登录页（pages/login/index.vue）— 保持不变
+
+保持现有设计，不做改动。
+
+**页面结构：**
+```
+login-page（全屏，背景图 login_bg.png）
+├── app-title "绥时录"（margin-top: 200rpx）
+├── input-wrap（账号输入框，560rpx 宽，圆角 20rpx，背景 #ECEFF3）
+├── input-wrap（密码输入框，同上）
+└── login-btn（登录按钮，560rpx 宽，背景 #1A73EC，圆角 20rpx）
+```
+
+**交互：** 登录成功后 `uni.reLaunch` 跳转至 `pages/portal/index`（原跳转 home 改为 portal）。
+
+---
+
+### 2. 功能入口列表页（pages/portal/index.vue）— 新建
+
+**设计决策：** 新建 `pages/portal/index.vue` 作为登录后首页，点击【机房ODF】跳转至现有 `pages/home/index`（公司列表保持不变），点击【干线】跳转至 `pages/trunk/index`。对现有代码改动最小。
+
+```
+登录 → portal（功能入口）→ home（ODF 公司列表，保持不变）
+                          → trunk（干线公司列表）
+```
+
+**页面结构：**
+```
+portal-page（min-height: 100vh，背景 #F5F5F5）
+├── bg-image（顶部背景图，home_bg.png，高度 500rpx，absolute 定位）
+├── content（relative，z-index: 1）
+│   ├── nav-bar（自定义导航栏）
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（刷新图标 ic_refresh.png）
+│   │       ├── nav-title "功能列表"
+│   │       └── nav-icon（设置图标 ic_set.png）
+│   └── module-grid（功能入口网格区域）
+│       ├── module-card（机房入口卡片）
+│       │   ├── module-image（图片占位/图标）
+│       │   └── module-name "机房"
+│       └── module-card（干线入口卡片）
+│           ├── module-image（图片占位/图标）
+│           └── module-name "干线"
+```
+
+**布局细节：**
+- `module-grid`：CSS Grid 布局，`grid-template-columns: repeat(2, 1fr)`，`gap: 24rpx`，`padding: 24rpx`
+- `module-card`：白色背景，圆角 `12rpx`，阴影 `0 2rpx 12rpx rgba(0,0,0,0.06)`，`padding: 32rpx`，垂直居中排列
+- `module-image`：居中显示，宽高约 `120rpx × 120rpx`，`margin-bottom: 16rpx`
+- `module-name`：`30rpx`，`color: #333`，`font-weight: 500`，居中
+- 无返回按钮（首页），导航栏左右为刷新和设置图标（复用 home 页导航栏模式）
+- 根据 `store.modules` 权限列表过滤显示的入口卡片
+
+**交互：**
+- 点击【机房】→ `uni.navigateTo({ url: '/pages/home/index' })`
+- 点击【干线】→ `uni.navigateTo({ url: '/pages/trunk/index' })`
+- 仅展示 `store.modules` 中包含的版块
+
+---
+
+### 3. 机架列表页改造（pages/rack/index.vue）— 改造
+
+**改造内容：** 导航栏右侧的 `nav-icon-placeholder` 替换为蓝色【签到】按钮。
+
+**导航栏结构变更：**
+```
+nav-bar-inner
+├── nav-icon（返回箭头 ic_back.png）
+├── nav-title "机房详情"
+└── checkin-btn（签到按钮）
+    └── checkin-btn-text "签到"
+```
+
+**签到按钮样式：**
+- `checkin-btn`：`background-color: #1A73EC`，`border-radius: 8rpx`，`padding: 8rpx 24rpx`
+- `checkin-btn-text`：`color: #fff`，`font-size: 26rpx`
+
+**机架卡片列表保持不变：**
+```
+rack-list（padding: 16rpx 24rpx）
+└── rack-card × N（白色背景，圆角 12rpx，阴影，padding: 32rpx 24rpx，margin-bottom: 20rpx）
+    └── rack-name "机架1"（30rpx，#333，font-weight: 500，居中显示）
+```
+
+**交互：** 点击签到按钮 → `uni.navigateTo({ url: '/pages/checkin/index?roomId=' + roomIdRef.value })`
+
+---
+
+### 4. 签到页（pages/checkin/index.vue）— 新建
+
+**页面结构：**
+```
+checkin-page（min-height: 100vh，背景 #F5F5F5）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "签到"
+│   │       └── nav-icon-placeholder
+│   └── form-area（表单区域，padding: 24rpx）
+│       ├── form-group
+│       │   ├── form-label "人员"
+│       │   └── form-input（input，placeholder: "请输入"）
+│       ├── form-group
+│       │   ├── form-label "时间"
+│       │   └── form-picker（picker mode="date"，显示框右侧下拉箭头图标）
+│       │       └── picker-text "请选择年月日" / 已选日期
+│       └── form-group
+│           ├── form-label "工作内容"
+│           └── form-textarea（textarea，placeholder: "请输入"）
+└── bottom-bar（底部固定按钮区域）
+    └── submit-btn "提交"
+```
+
+**样式规范：**
+- `form-area`：`padding: 24rpx`
+- `form-group`：`margin-bottom: 32rpx`
+- `form-label`：`font-size: 28rpx`，`color: #333`，`margin-bottom: 12rpx`，`font-weight: 500`
+- `form-input`：`height: 80rpx`，`padding: 0 24rpx`，`background: #fff`，`border-radius: 12rpx`，`border: 1rpx solid #E8E8E8`，`font-size: 28rpx`
+- `form-picker`：同 `form-input` 样式，flex 布局，右侧放置下拉箭头图标（`/static/images/ic_arrow_down.png`，`24rpx × 24rpx`）
+- `picker-text`：未选择时 `color: #999`，已选择时 `color: #333`
+- `form-textarea`：`min-height: 200rpx`，`padding: 24rpx`，`background: #fff`，`border-radius: 12rpx`，`border: 1rpx solid #E8E8E8`，`font-size: 28rpx`
+- `bottom-bar`：`position: fixed`，`bottom: 0`，`left: 0`，`width: 100%`，`padding: 24rpx`，`background: #fff`，`box-sizing: border-box`
+- `submit-btn`：`width: 100%`，`height: 88rpx`，`background: #1A73EC`，`border-radius: 20rpx`，`color: #fff`，`font-size: 32rpx`，flex 居中
+
+**交互：**
+- 点击时间字段 → 底部弹出 `<picker mode="date">` 年月日滑动选择器
+- 点击提交 → 校验必填项 → 调用 `submitCheckin` API → 成功 `uni.showToast` + `uni.navigateBack()`
+- 失败保留表单数据
+
+
+---
+
+### 5. 干线页 — 公司列表（pages/trunk/index.vue）— 新建
+
+**页面结构：**
+```
+trunk-page（min-height: 100vh，背景 #F5F5F5）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "干线"
+│   │       └── nav-icon-placeholder
+│   ├── section-title "公司列表"（小标题）
+│   └── company-list（scroll-view，scroll-y）
+│       └── company-card × N
+│           ├── company-image（图片占位区域）
+│           └── company-name "公司名称"（居中）
+```
+
+**样式规范：**
+- `section-title`：`font-size: 30rpx`，`font-weight: 600`，`color: #333`，`padding: 16rpx 24rpx 8rpx`
+- `company-card`：白色背景，圆角 `12rpx`，阴影，`margin: 0 24rpx 20rpx`，`padding: 24rpx`，`border: 1rpx solid #E8E8E8`，flex 垂直居中排列
+- `company-image`：图片占位区域，`width: 100%`，`height: 160rpx`，`background: #F0F0F0`，`border-radius: 8rpx`，`margin-bottom: 16rpx`
+- `company-name`：`font-size: 30rpx`，`color: #333`，`font-weight: 500`，`text-align: center`
+
+**数据源：** 复用 `getCompanyList()` 接口（与 ODF 共用 getcompany 数据源）
+
+**交互：** 点击公司卡片 → `uni.navigateTo({ url: '/pages/cable/index?deptId=' + item.deptId })`
+
+---
+
+### 6. 光缆列表页（pages/cable/index.vue）— 新建
+
+**页面结构：**
+```
+cable-page（min-height: 100vh，背景 #F5F5F5）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "干线"
+│   │       └── nav-icon-placeholder
+│   ├── section-title "光缆列表"（小标题）
+│   ├── search-bar（搜索栏）
+│   │   ├── search-icon（搜索图标，左侧）
+│   │   └── search-input（placeholder: "只支持搜索本公司光缆和故障信息"）
+│   └── cable-list（scroll-view）
+│       └── cable-card × N
+│           ├── cable-image（图片占位区域）
+│           └── cable-name "光缆名称"（居中）
+```
+
+**搜索栏样式：**
+- `search-bar`：flex 布局，`margin: 16rpx 24rpx`，`padding: 0 24rpx`，`height: 72rpx`，`background: #fff`，`border-radius: 36rpx`，`align-items: center`
+- `search-icon`：`width: 32rpx`，`height: 32rpx`，`margin-right: 16rpx`，使用 `/static/images/ic_search.png`
+- `search-input`：`flex: 1`，`font-size: 26rpx`，无边框，`confirm-type="search"`
+- placeholder 文字：`color: #999`，`font-size: 26rpx`
+
+**光缆卡片样式：** 同公司卡片（trunk 页），白色背景 + 边框 + 图片占位 + 名称居中
+
+**交互：**
+- 输入关键词按回车/确认 → `uni.navigateTo({ url: '/pages/trunk-search/index?deptId=' + deptId + '&keyword=' + keyword })`
+- 点击光缆卡片 → `uni.navigateTo({ url: '/pages/fault-list/index?cableId=' + item.id + '&cableName=' + encodeURIComponent(item.cableName) })`
+
+---
+
+### 7. 故障列表页（pages/fault-list/index.vue）— 新建
+
+**页面结构：**
+```
+fault-list-page（min-height: 100vh，背景 #F5F5F5，padding-bottom: 120rpx）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "干线"
+│   │       └── nav-icon-placeholder
+│   ├── section-title "故障列表"（小标题）
+│   └── fault-list（列表区域）
+│       └── fault-card × N
+│           ├── fault-row "故障时间：2025/1/1"
+│           ├── fault-row "故障原因：xxxxxxxxx"
+│           ├── fault-row "表显故障里程：xxxxxxxxx"
+│           └── fault-row "所属光缆：xxxxxxxxx"
+└── bottom-bar（底部固定按钮区域）
+    └── add-fault-btn "新增故障"
+```
+
+**故障卡片样式：**
+- `fault-card`：白色背景，圆角 `12rpx`，`border: 1rpx solid #E8E8E8`，`padding: 24rpx`，`margin: 0 24rpx 20rpx`
+- `fault-row`：`margin-bottom: 12rpx`，最后一行 `margin-bottom: 0`
+- `fault-label`（如"故障时间："）：`font-size: 26rpx`，`color: #999`，`flex-shrink: 0`
+- `fault-value`：`font-size: 26rpx`，`color: #333`，`flex: 1`
+- 每行使用 flex 布局，`align-items: flex-start`，文字左对齐
+
+**底部按钮样式：**
+- `bottom-bar`：`position: fixed`，`bottom: 0`，`left: 0`，`width: 100%`，`padding: 24rpx`，`background: #fff`
+- `add-fault-btn`：`width: 100%`，`height: 88rpx`，`background: #1A73EC`，`border-radius: 20rpx`，`color: #fff`，`font-size: 32rpx`，flex 居中
+
+**交互：**
+- 点击故障卡片 → `uni.navigateTo({ url: '/pages/fault-detail/index?faultId=' + item.id })`
+- 点击【新增故障】→ `uni.navigateTo({ url: '/pages/fault-add/index?cableId=' + cableId + '&cableName=' + encodeURIComponent(cableName) })`
+- 支持分页加载（`onReachBottom` 触发加载更多）
+
+---
+
+### 8. 故障详情页（pages/fault-detail/index.vue）— 新建
+
+**页面结构：**
+```
+fault-detail-page（min-height: 100vh，背景 #F5F5F5，padding-bottom: 120rpx）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "故障详情"
+│   │       └── nav-icon-placeholder
+│   ├── image-area（图片区域）
+│   │   └── image-grid（2 列网格，可横向滚动 scroll-view scroll-x）
+│   │       └── image-item × N（图片缩略图，点击可预览）
+│   └── info-area（信息展示区域）
+│       ├── info-row "故障时间：2025/1/1"
+│       ├── info-row "人员：xxxx、xxxx"
+│       ├── info-row "故障原因：xxxxxxxxx"（支持多行换行）
+│       ├── info-row "表显故障里程：xxxxxxxxx"
+│       ├── info-row "所属光缆：xxxxxxxxx"
+│       ├── info-row "地点：xxxxxxxxx"
+│       └── info-row "备注：xxxxxxxxx"
+└── bottom-bar（底部固定按钮区域，经纬度为空时隐藏）
+    └── navigate-btn "导航至地点"
+```
+
+**图片区域样式：**
+- `image-area`：`padding: 24rpx`
+- `image-grid`：`scroll-view` 横向滚动，`white-space: nowrap`，或使用 CSS Grid `grid-template-columns: repeat(auto-fill, minmax(280rpx, 1fr))`，`gap: 16rpx`
+- `image-item`：`width: 280rpx`，`height: 280rpx`，`border-radius: 8rpx`，`object-fit: cover`
+
+**信息展示样式：**
+- `info-area`：白色背景卡片，`margin: 0 24rpx`，`padding: 24rpx`，`border-radius: 12rpx`
+- `info-row`：flex 布局，`align-items: flex-start`，`margin-bottom: 16rpx`
+- `info-label`（如"故障时间："）：`font-size: 26rpx`，`color: #999`，`flex-shrink: 0`，`width: 180rpx`
+- `info-value`：`font-size: 26rpx`，`color: #333`，`flex: 1`，`word-break: break-all`（支持多行换行）
+
+**底部按钮：** 同故障列表页底部按钮样式，文字为"导航至地点"。当 `latitude` 和 `longitude` 均为空或 0 时，`v-if` 隐藏整个 `bottom-bar`。
+
+**交互：**
+- 点击图片 → `uni.previewImage({ urls: imageList, current: clickedUrl })` 全屏预览
+- 点击【导航至地点】→ 调用 `utils/navigation.js` 的 `openNavigation(lat, lng, name)`
+
+
+---
+
+### 9. 新增故障页（pages/fault-add/index.vue）— 新建
+
+**页面结构：**
+```
+fault-add-page（min-height: 100vh，背景 #F5F5F5，padding-bottom: 120rpx）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "新增故障"
+│   │       └── nav-icon-placeholder
+│   ├── photo-area（拍照区域，padding: 24rpx）
+│   │   └── photo-scroll（横向滚动 scroll-view scroll-x）
+│   │       ├── photo-add-btn（添加按钮，第一个位置）
+│   │       │   ├── plus-icon "+"
+│   │       │   └── add-text "点击拍摄"
+│   │       └── photo-thumb × N（已拍摄照片缩略图）
+│   └── form-area（表单区域，padding: 0 24rpx）
+│       ├── form-group
+│       │   ├── form-label "故障时间"
+│       │   └── form-display（自动填充显示框，如 "2026/1/1 12:12"，不可编辑）
+│       ├── form-group
+│       │   ├── form-label "人员"
+│       │   └── form-input（placeholder: "请输入"）
+│       ├── form-group
+│       │   ├── form-label "故障原因："
+│       │   └── form-input（placeholder: "请输入"）
+│       ├── form-group
+│       │   ├── form-label "表显故障里程"
+│       │   └── form-input（placeholder: "请输入"）
+│       ├── form-group
+│       │   ├── form-label "所属光缆"
+│       │   └── form-display（自动填充，不可编辑，显示从上级页面传入的光缆名）
+│       ├── form-group
+│       │   ├── form-label "地点"
+│       │   ├── location-btn "点击获取当前经纬度"（蓝色按钮）
+│       │   └── location-text "当前经度：0    当前纬度：0"
+│       └── form-group
+│           ├── form-label "备注"
+│           └── form-textarea（placeholder: "请输入"）
+└── bottom-bar
+    └── submit-btn "提交故障"
+```
+
+**拍照区域样式：**
+- `photo-area`：`padding: 24rpx`
+- `photo-scroll`：`scroll-view` 横向滚动，`white-space: nowrap`
+- `photo-add-btn`：`width: 200rpx`，`height: 200rpx`，`background: #fff`，`border: 2rpx dashed #CCCCCC`，`border-radius: 12rpx`，flex 垂直居中排列，`display: inline-flex`
+- `plus-icon`：`font-size: 48rpx`，`color: #999`
+- `add-text`：`font-size: 24rpx`，`color: #999`，`margin-top: 8rpx`
+- `photo-thumb`：`width: 200rpx`，`height: 200rpx`，`border-radius: 12rpx`，`object-fit: cover`，`margin-left: 16rpx`，`display: inline-block`
+
+**表单样式：**
+- `form-group`：`margin-bottom: 32rpx`
+- `form-label`：`font-size: 28rpx`，`color: #333`，`margin-bottom: 12rpx`，`font-weight: 500`
+- `form-input`：`height: 80rpx`，`padding: 0 24rpx`，`background: #fff`，`border-radius: 12rpx`，`border: 1rpx solid #E8E8E8`，`font-size: 28rpx`
+- `form-display`：同 `form-input` 样式，但 `color: #333`，`background: #F5F5F5`（灰底表示不可编辑）
+- `form-textarea`：`min-height: 200rpx`，`padding: 24rpx`，`background: #fff`，`border-radius: 12rpx`，`border: 1rpx solid #E8E8E8`，`font-size: 28rpx`
+
+**地点获取按钮样式：**
+- `location-btn`：`background: #1A73EC`，`border-radius: 12rpx`，`padding: 16rpx 0`，`text-align: center`，`color: #fff`，`font-size: 28rpx`，`width: 100%`
+- `location-text`：`font-size: 26rpx`，`color: #999`，`margin-top: 12rpx`
+
+**底部按钮：** 同签到页底部按钮样式，文字为"提交故障"。
+
+**交互：**
+- 点击"+ 点击拍摄" → `uni.chooseImage({ count: 1, sourceType: ['camera'] })`，仅相机拍摄
+- 拍摄第 1 张照片时自动获取当前时间填充"故障时间"字段
+- 点击【点击获取当前经纬度】→ `uni.getLocation` 获取位置，更新经纬度显示
+- 点击【提交故障】→ 校验必填项（至少 1 张照片）→ 水印处理 → 上传照片 → 提交表单 → 成功返回
+- 失败保留所有数据
+
+---
+
+### 10. 搜索结果页（pages/trunk-search/index.vue）— 新建
+
+**页面结构：**
+```
+trunk-search-page（min-height: 100vh，背景 #F5F5F5）
+├── bg-image（顶部背景图）
+├── content
+│   ├── nav-bar
+│   │   └── nav-bar-inner
+│   │       ├── nav-icon（返回箭头 "<"）
+│   │       ├── nav-title "搜索结果"
+│   │       └── nav-icon-placeholder
+│   └── result-area（搜索结果区域，padding: 16rpx 24rpx）
+│       ├── section（光缆分类，v-if cables.length > 0）
+│       │   ├── section-title "光缆"
+│       │   └── cable-card × N
+│       │       ├── cable-image（图片占位）
+│       │       └── cable-name "光缆名称"（居中）
+│       ├── section（故障分类，v-if faults.length > 0）
+│       │   ├── section-title "故障列表"
+│       │   └── fault-card × N
+│       │       ├── fault-row "故障时间：..."
+│       │       ├── fault-row "故障原因：..."
+│       │       ├── fault-row "表显故障里程：..."
+│       │       └── fault-row "所属光缆：..."
+│       └── no-result（v-if 无结果）
+│           └── "暂无搜索结果"
+```
+
+**样式规范：** 复用 trunk 页的 `section-title` 样式、cable 页的卡片样式、fault-list 页的故障卡片样式。
+
+**交互：**
+- 页面 `onLoad` 时从参数获取 `deptId` 和 `keyword`，调用搜索接口
+- 点击光缆卡片 → `uni.navigateTo({ url: '/pages/fault-list/index?cableId=...' })`
+- 点击故障卡片 → `uni.navigateTo({ url: '/pages/fault-detail/index?faultId=...' })`
+
+---
+
+### 11. 权限管理
+
+**store/index.js 扩展：**
+- 新增 `modules` 字段存储当前账号可见的功能版块列表
+- 登录成功后调用权限接口获取并存储
+
+**services/permission.js（新建）：**
+- `getUserModules()` — 获取当前账号的功能版块权限列表
+
+### 12. 路线规划（尝试性）
+
+**pages/route-plan/index.vue（新建）：**
+- 集成地图 SDK（如高德地图 UniApp 插件）
+- 输入起终点坐标，调用路线规划 API
+- 展示路线总长度
+- 输入距离值，计算路线上对应坐标并标注
+
+### 13. 导航功能实现
+
+**工具函数 `utils/navigation.js`（新建）：**
+
+```javascript
+// 打开导航 APP
+export function openNavigation(lat, lng, name) {
+  // #ifdef APP-PLUS
+  // 安卓端：弹出 actionSheet 选择导航 APP
+  const apps = []
+  // 检测已安装的导航 APP 并构建 scheme URL
+  // 高德: androidamap://navi?lat=xxx&lon=xxx&dev=0
+  // 百度: baidumap://map/navi?location=lat,lng
+  // 腾讯: qqmap://map/routeplan?to=name&tocoord=lat,lng
+  // #endif
+  // #ifdef H5
+  // H5 端：打开高德/腾讯地图网页版
+  window.open(`https://uri.amap.com/navigation?to=${lng},${lat},${name}`)
+  // #endif
+}
+```
+
+### 14. 水印照片处理
+
+**工具函数 `utils/watermark.js`（新建）：**
+
+```javascript
+// 在照片左下角叠加水印文字
+export function addWatermark(imagePath, text) {
+  return new Promise((resolve, reject) => {
+    // 使用 uni.createCanvasContext 或 OffscreenCanvas
+    // 1. 加载原图到 canvas
+    // 2. 在左下角绘制半透明背景 + 白色文字（时间 + 人员）
+    // 3. 导出为临时文件路径
+  })
+}
+```
+
+
+## 数据模型
+
+### Store 扩展（store/index.js）
+
+```javascript
+const store = reactive({
+  // 现有字段保持不变
+  token: '',
+  userId: '',
+  userName: '',
+  isPermission: false,
+  dictUnitTypes: [],
+  dictBusinessTypes: [],
+
+  // 新增：功能版块权限列表
+  // 示例值: ['odf', 'trunk']
+  modules: [],
+
+  setAuth(token, userId, userName) { /* 不变 */ },
+  clearAuth() {
+    // 新增清除 modules
+    this.modules = []
+    // ...原有逻辑
+  },
+  setModules(modules) {
+    this.modules = modules || []
+  }
+})
+```
+
+### API 接口定义
+
+#### 权限接口
+
+```
+GET /business/OdfUserModules/list
+Response: { code: 200, data: ['odf', 'trunk'] }
+```
+
+#### 签到接口
+
+```
+POST /business/OdfCheckin/submit
+Body: { roomId, personnel, checkinTime, workContent }
+Response: { code: 200, msg: '提交成功' }
+```
+
+#### 干线 — 光缆列表
+
+```
+GET /business/OdfCables/list?deptId=xxx
+Response: { code: 200, data: [{ id, cableName, deptId }] }
+```
+
+#### 干线 — 故障列表
+
+```
+GET /business/OdfCableFaults/list?cableId=xxx&pageNum=1&pageSize=20
+Response: {
+  code: 200,
+  data: {
+    result: [{ id, faultTime, faultReason, mileage, cableName, cableId }],
+    totalPage: 5
+  }
+}
+```
+
+#### 干线 — 故障详情
+
+```
+GET /business/OdfCableFaults/{id}
+Response: {
+  code: 200,
+  data: {
+    id, faultTime, personnel, faultReason, mileage,
+    cableName, location, latitude, longitude,
+    remark, images: [{ url }]
+  }
+}
+```
+
+#### 干线 — 新增故障
+
+```
+POST /business/OdfCableFaults/add
+Body (multipart/form-data): {
+  cableId, faultTime, personnel, faultReason, mileage,
+  latitude, longitude, remark,
+  images: [File, File, ...]
+}
+Response: { code: 200, msg: '提交成功' }
+```
+
+#### 干线 — 搜索
+
+```
+GET /business/OdfCables/search?deptId=xxx&keyword=xxx
+Response: {
+  code: 200,
+  data: {
+    cables: [{ id, cableName }],
+    faults: [{ id, faultTime, faultReason, mileage, cableName }]
+  }
+}
+```
+
+### 页面参数传递
+
+| 源页面 | 目标页面 | 参数 |
+|--------|----------|------|
+| portal | home | 无（原 ODF 流程） |
+| portal | trunk | 无 |
+| trunk | cable | deptId |
+| cable | fault-list | cableId, cableName |
+| cable | trunk-search | deptId, keyword |
+| fault-list | fault-detail | faultId |
+| fault-list | fault-add | cableId, cableName |
+| trunk-search | fault-list | cableId, cableName |
+| trunk-search | fault-detail | faultId |
+| rack | checkin | roomId |
+
+### pages.json 新增页面注册
+
+```json
+{
+  "pages": [
+    { "path": "pages/portal/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/checkin/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/trunk/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/cable/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/fault-list/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/fault-detail/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/fault-add/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/trunk-search/index", "style": { "navigationStyle": "custom" } },
+    { "path": "pages/route-plan/index", "style": { "navigationStyle": "custom" } }
+  ]
+}
+```
+
+
+## 数据库设计
+
+### 后台技术栈
+
+后台基于 ZRAdmin 框架（.NET/C#），使用 SqlSugar ORM 操作 SQL Server 数据库。现有 ODF 表采用 `odf_` 前缀，字段命名混合使用 PascalCase（如 `RoomName`）和 snake_case（如 `port_id`）。新增表统一采用 PascalCase 字段命名以保持与主流表一致。
+
+### 新增表结构
+
+#### 1. odf_checkin — 签到记录表
+
+```sql
+CREATE TABLE odf_checkin (
+    Id          INT IDENTITY(1,1) PRIMARY KEY,
+    RoomId      INT NOT NULL,                       -- 关联机房 odf_rooms.Id
+    Personnel   NVARCHAR(200) NOT NULL,             -- 签到人员
+    CheckinTime DATETIME NOT NULL,                  -- 签到时间（用户选择）
+    WorkContent NVARCHAR(MAX) NOT NULL,             -- 工作内容
+    UserId      BIGINT NULL,                        -- 提交人 sys_user.UserId
+    CreatedAt   DATETIME DEFAULT GETDATE()          -- 记录创建时间
+);
+
+-- 索引：按机房查询签到记录
+CREATE INDEX IX_odf_checkin_RoomId ON odf_checkin(RoomId);
+-- 索引：按时间倒序查询
+CREATE INDEX IX_odf_checkin_CheckinTime ON odf_checkin(CheckinTime DESC);
+```
+
+关联关系：`RoomId` → `odf_rooms.Id`，`UserId` → `sys_user.UserId`
+
+#### 2. odf_cables — 光缆表
+
+```sql
+CREATE TABLE odf_cables (
+    Id          INT IDENTITY(1,1) PRIMARY KEY,
+    CableName   NVARCHAR(200) NOT NULL,             -- 光缆名称
+    DeptId      BIGINT NOT NULL,                    -- 所属公司/部门 sys_dept.DeptId
+    DeptName    NVARCHAR(100) NULL,                 -- 冗余：部门名称
+    CreatedAt   DATETIME DEFAULT GETDATE(),
+    UpdatedAt   DATETIME DEFAULT GETDATE()
+);
+
+-- 索引：按公司查询光缆列表
+CREATE INDEX IX_odf_cables_DeptId ON odf_cables(DeptId);
+-- 索引：按名称模糊搜索
+CREATE INDEX IX_odf_cables_CableName ON odf_cables(CableName);
+```
+
+关联关系：`DeptId` → `sys_dept.DeptId`
+
+#### 3. odf_cable_faults — 干线故障表
+
+```sql
+CREATE TABLE odf_cable_faults (
+    Id          INT IDENTITY(1,1) PRIMARY KEY,
+    CableId     INT NOT NULL,                       -- 关联光缆 odf_cables.Id
+    FaultTime   DATETIME NOT NULL,                  -- 故障时间
+    Personnel   NVARCHAR(200) NULL,                 -- 人员
+    FaultReason NVARCHAR(MAX) NULL,                 -- 故障原因
+    Mileage     NVARCHAR(200) NULL,                 -- 表显故障里程
+    Location    NVARCHAR(500) NULL,                 -- 地点描述
+    Latitude    DECIMAL(10,7) DEFAULT 0,            -- 纬度
+    Longitude   DECIMAL(10,7) DEFAULT 0,            -- 经度
+    Remark      NVARCHAR(MAX) NULL,                 -- 备注
+    UserId      BIGINT NULL,                        -- 提交人 sys_user.UserId
+    CreatedAt   DATETIME DEFAULT GETDATE(),
+    UpdatedAt   DATETIME DEFAULT GETDATE()
+);
+
+-- 索引：按光缆查询故障列表
+CREATE INDEX IX_odf_cable_faults_CableId ON odf_cable_faults(CableId);
+-- 索引：按故障时间倒序
+CREATE INDEX IX_odf_cable_faults_FaultTime ON odf_cable_faults(FaultTime DESC);
+```
+
+关联关系：`CableId` → `odf_cables.Id`，`UserId` → `sys_user.UserId`
+
+#### 4. odf_cable_fault_images — 故障图片表
+
+```sql
+CREATE TABLE odf_cable_fault_images (
+    Id          INT IDENTITY(1,1) PRIMARY KEY,
+    FaultId     INT NOT NULL,                       -- 关联故障 odf_cable_faults.Id
+    ImageUrl    NVARCHAR(500) NOT NULL,             -- 图片访问 URL
+    CreatedAt   DATETIME DEFAULT GETDATE()
+);
+
+-- 索引：按故障 ID 查询图片
+CREATE INDEX IX_odf_cable_fault_images_FaultId ON odf_cable_fault_images(FaultId);
+```
+
+关联关系：`FaultId` → `odf_cable_faults.Id`
+
+#### 5. odf_user_modules — 用户功能版块权限表
+
+```sql
+CREATE TABLE odf_user_modules (
+    Id          INT IDENTITY(1,1) PRIMARY KEY,
+    UserId      BIGINT NOT NULL,                    -- 用户 sys_user.UserId
+    ModuleCode  NVARCHAR(50) NOT NULL,              -- 模块标识：'odf', 'trunk', 'route'
+    CreatedAt   DATETIME DEFAULT GETDATE()
+);
+
+-- 唯一索引：同一用户同一模块不重复
+CREATE UNIQUE INDEX UX_odf_user_modules_User_Module ON odf_user_modules(UserId, ModuleCode);
+-- 索引：按用户查询
+CREATE INDEX IX_odf_user_modules_UserId ON odf_user_modules(UserId);
+```
+
+关联关系：`UserId` → `sys_user.UserId`
+
+### ER 关系图
+
+```mermaid
+erDiagram
+    sys_user ||--o{ odf_user_modules : "拥有"
+    sys_user ||--o{ odf_checkin : "提交"
+    sys_user ||--o{ odf_cable_faults : "提交"
+    sys_dept ||--o{ odf_cables : "所属"
+    odf_rooms ||--o{ odf_checkin : "签到于"
+    odf_cables ||--o{ odf_cable_faults : "发生"
+    odf_cable_faults ||--o{ odf_cable_fault_images : "包含"
+```
+
+---
+
+## 后台 API 设计
+
+### 技术架构
+
+遵循现有 ZRAdmin 分层架构：
+
+| 层 | 职责 | 命名规范 |
+|---|------|---------|
+| Controller | 路由、参数校验、权限控制 | `{Entity}Controller.cs`，继承 `BaseController` |
+| Service | 业务逻辑 | `{Entity}Service.cs`，实现 `I{Entity}Service` |
+| Model | 实体映射 | `{Entity}.cs`，`[SugarTable]` 注解 |
+| Dto | 请求/响应对象 | `{Entity}Dto.cs`、`{Entity}QueryDto.cs` |
+
+统一响应格式：`{ code: 200, msg: "success", data: ... }`
+
+### API 1: 获取用户功能版块权限
+
+**路由：** `GET /business/OdfUserModules/list`
+
+**Controller：** `OdfUserModulesController.cs`
+
+```csharp
+[Route("business/OdfUserModules")]
+public class OdfUserModulesController : BaseController
+{
+    private readonly IOdfUserModulesService _service;
+
+    /// <summary>
+    /// 获取当前登录用户的功能版块列表
+    /// </summary>
+    [HttpGet("list")]
+    public IActionResult GetUserModules()
+    {
+        long userId = HttpContext.GetUId();
+        var modules = _service.GetUserModules(userId);
+        return SUCCESS(modules); // 返回 ['odf', 'trunk']
+    }
+}
+```
+
+**Service 逻辑：**
+- 根据 `UserId` 查询 `odf_user_modules` 表
+- 返回 `ModuleCode` 列表（`List<string>`）
+- 若无记录返回空列表
+
+**响应：**
+```json
+{ "code": 200, "data": ["odf", "trunk"] }
+```
+
+---
+
+### API 2: 提交签到
+
+**路由：** `POST /business/OdfCheckin/submit`
+
+**Controller：** `OdfCheckinController.cs`
+
+```csharp
+[Route("business/OdfCheckin")]
+public class OdfCheckinController : BaseController
+{
+    private readonly IOdfCheckinService _service;
+
+    /// <summary>
+    /// 提交签到记录
+    /// </summary>
+    [HttpPost("submit")]
+    public IActionResult Submit([FromBody] OdfCheckinDto dto)
+    {
+        dto.UserId = HttpContext.GetUId();
+        var result = _service.AddCheckin(dto);
+        return SUCCESS(result);
+    }
+}
+```
+
+**请求体（OdfCheckinDto）：**
+```json
+{
+  "roomId": 1,
+  "personnel": "张三",
+  "checkinTime": "2025-06-15",
+  "workContent": "光缆维护"
+}
+```
+
+**Service 逻辑：**
+- 校验 `RoomId` 存在（查 `odf_rooms`）
+- 校验 `Personnel`、`WorkContent` 非空
+- 插入 `odf_checkin` 记录，`CreatedAt` 取服务器当前时间
+- 返回插入的记录
+
+**响应：**
+```json
+{ "code": 200, "msg": "提交成功" }
+```
+
+---
+
+### API 3: 光缆列表
+
+**路由：** `GET /business/OdfCables/list`
+
+**Controller：** `OdfCablesController.cs`
+
+```csharp
+[Route("business/OdfCables")]
+public class OdfCablesController : BaseController
+{
+    private readonly IOdfCablesService _service;
+
+    /// <summary>
+    /// 查询某公司下的光缆列表
+    /// </summary>
+    [HttpGet("list")]
+    public IActionResult GetList([FromQuery] OdfCablesQueryDto parm)
+    {
+        var response = _service.GetList(parm);
+        return SUCCESS(response);
+    }
+}
+```
+
+**查询参数（OdfCablesQueryDto）：**
+```
+deptId: long (必填) — 公司/部门 ID
+```
+
+**Service 逻辑：**
+- 按 `DeptId` 过滤 `odf_cables` 表
+- 返回光缆列表（id, cableName, deptId）
+
+**响应：**
+```json
+{
+  "code": 200,
+  "data": [
+    { "id": 1, "cableName": "XX干线光缆", "deptId": 100 }
+  ]
+}
+```
+
+---
+
+### API 4: 故障列表（分页）
+
+**路由：** `GET /business/OdfCableFaults/list`
+
+**Controller：** `OdfCableFaultsController.cs`
+
+```csharp
+[Route("business/OdfCableFaults")]
+public class OdfCableFaultsController : BaseController
+{
+    private readonly IOdfCableFaultsService _service;
+    private readonly IOdfCablesService _cablesService;
+
+    /// <summary>
+    /// 查询某光缆下的故障列表（分页）
+    /// </summary>
+    [HttpGet("list")]
+    public IActionResult GetList([FromQuery] OdfCableFaultsQueryDto parm)
+    {
+        var response = _service.GetList(parm);
+        return SUCCESS(response);
+    }
+}
+```
+
+**查询参数（OdfCableFaultsQueryDto 继承 PagerInfo）：**
+```
+cableId: int (必填) — 光缆 ID
+pageNum: int (默认 1)
+pageSize: int (默认 20)
+```
+
+**Service 逻辑：**
+- 按 `CableId` 过滤 `odf_cable_faults`
+- 按 `FaultTime DESC` 排序
+- 联查 `odf_cables` 获取 `CableName`
+- 分页返回
+
+**响应：**
+```json
+{
+  "code": 200,
+  "data": {
+    "result": [
+      {
+        "id": 1,
+        "faultTime": "2025-01-01T00:00:00",
+        "faultReason": "光缆断裂",
+        "mileage": "12.5km",
+        "cableName": "XX干线光缆",
+        "cableId": 1
+      }
+    ],
+    "totalPage": 5
+  }
+}
+```
+
+---
+
+### API 5: 故障详情
+
+**路由：** `GET /business/OdfCableFaults/{id}`
+
+```csharp
+/// <summary>
+/// 查询故障详情
+/// </summary>
+[HttpGet("{id}")]
+public IActionResult GetDetail(int id)
+{
+    var response = _service.GetDetail(id);
+    return SUCCESS(response);
+}
+```
+
+**Service 逻辑：**
+- 查询 `odf_cable_faults` 主表
+- 联查 `odf_cables` 获取 `CableName`
+- 联查 `odf_cable_fault_images` 获取图片列表
+- 组装完整详情对象返回
+
+**响应：**
+```json
+{
+  "code": 200,
+  "data": {
+    "id": 1,
+    "faultTime": "2025-01-01T12:00:00",
+    "personnel": "张三、李四",
+    "faultReason": "光缆断裂",
+    "mileage": "12.5km",
+    "cableName": "XX干线光缆",
+    "location": "XX路段",
+    "latitude": 39.9042000,
+    "longitude": 116.4074000,
+    "remark": "已修复",
+    "images": [
+      { "url": "/uploads/fault/20250101_001.jpg" },
+      { "url": "/uploads/fault/20250101_002.jpg" }
+    ]
+  }
+}
+```
+
+---
+
+### API 6: 新增故障（含图片上传）
+
+**路由：** `POST /business/OdfCableFaults/add`
+
+```csharp
+/// <summary>
+/// 新增故障（multipart/form-data，含图片上传）
+/// </summary>
+[HttpPost("add")]
+public async Task<IActionResult> Add([FromForm] OdfCableFaultAddDto dto)
+{
+    dto.UserId = HttpContext.GetUId();
+    var result = await _service.AddFault(dto);
+    return SUCCESS(result);
+}
+```
+
+**请求格式：** `multipart/form-data`
+
+**请求字段（OdfCableFaultAddDto）：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| cableId | int | 是 | 所属光缆 ID |
+| faultTime | string | 是 | 故障时间 |
+| personnel | string | 否 | 人员 |
+| faultReason | string | 否 | 故障原因 |
+| mileage | string | 否 | 表显故障里程 |
+| location | string | 否 | 地点 |
+| latitude | decimal | 否 | 纬度 |
+| longitude | decimal | 否 | 经度 |
+| remark | string | 否 | 备注 |
+| images | IFormFile[] | 是 | 图片文件（至少 1 张） |
+
+**Service 逻辑：**
+1. 校验 `CableId` 存在
+2. 校验 `images` 至少 1 张
+3. 插入 `odf_cable_faults` 主记录，获取自增 `Id`
+4. 遍历 `images`，逐张保存到本地文件系统（复用 `SysFileService.SaveFileToLocal`），保存目录为 `uploads/fault/`
+5. 将每张图片的访问 URL 插入 `odf_cable_fault_images`（关联 `FaultId`）
+6. 返回成功
+
+**图片上传处理方案：**
+- 复用现有 `CommonController.UploadFile` 的本地存储逻辑
+- 图片保存路径：`wwwroot/uploads/fault/{yyyyMMdd}_{hash}{ext}`
+- 返回的 `ImageUrl` 为相对路径，前端拼接 `baseUrl` 访问
+- 水印处理在前端完成（Canvas 叠加），后台接收的已是带水印的图片
+
+**响应：**
+```json
+{ "code": 200, "msg": "提交成功" }
+```
+
+---
+
+### API 7: 搜索光缆和故障
+
+**路由：** `GET /business/OdfCables/search`
+
+```csharp
+/// <summary>
+/// 搜索光缆和故障（限定公司范围）
+/// </summary>
+[HttpGet("search")]
+public IActionResult Search([FromQuery] long deptId, [FromQuery] string keyword)
+{
+    var response = _service.Search(deptId, keyword);
+    return SUCCESS(response);
+}
+```
+
+**查询参数：**
+```
+deptId: long (必填) — 公司 ID，限定搜索范围
+keyword: string (必填) — 搜索关键词
+```
+
+**Service 逻辑：**
+1. 在 `odf_cables` 中按 `DeptId` 过滤，`CableName LIKE '%keyword%'` 模糊匹配
+2. 在 `odf_cable_faults` 中联查 `odf_cables`（`DeptId` 过滤），对 `FaultReason`、`Mileage`、`Location` 进行 `LIKE '%keyword%'` 模糊匹配
+3. 分别返回匹配的光缆列表和故障列表
+
+**响应：**
+```json
+{
+  "code": 200,
+  "data": {
+    "cables": [
+      { "id": 1, "cableName": "XX干线光缆" }
+    ],
+    "faults": [
+      {
+        "id": 1,
+        "faultTime": "2025-01-01T00:00:00",
+        "faultReason": "光缆断裂",
+        "mileage": "12.5km",
+        "cableName": "XX干线光缆"
+      }
+    ]
+  }
+}
+```
+
+---
+
+### 后台实体模型清单
+
+| 实体类 | 表名 | 路径 |
+|--------|------|------|
+| `OdfCheckin` | `odf_checkin` | `ZR.Model/Business/OdfCheckin.cs` |
+| `OdfCables` | `odf_cables` | `ZR.Model/Business/OdfCables.cs` |
+| `OdfCableFaults` | `odf_cable_faults` | `ZR.Model/Business/OdfCableFaults.cs` |
+| `OdfCableFaultImages` | `odf_cable_fault_images` | `ZR.Model/Business/OdfCableFaultImages.cs` |
+| `OdfUserModules` | `odf_user_modules` | `ZR.Model/Business/OdfUserModules.cs` |
+
+### 后台服务清单
+
+| 服务接口 | 实现类 | 路径 |
+|----------|--------|------|
+| `IOdfCheckinService` | `OdfCheckinService` | `ZR.Service/Business/` |
+| `IOdfCablesService` | `OdfCablesService` | `ZR.Service/Business/` |
+| `IOdfCableFaultsService` | `OdfCableFaultsService` | `ZR.Service/Business/` |
+| `IOdfCableFaultImagesService` | `OdfCableFaultImagesService` | `ZR.Service/Business/` |
+| `IOdfUserModulesService` | `OdfUserModulesService` | `ZR.Service/Business/` |
+
+### 后台控制器清单
+
+| 控制器 | 路由前缀 | 路径 |
+|--------|----------|------|
+| `OdfCheckinController` | `business/OdfCheckin` | `Controllers/Business/` |
+| `OdfCablesController` | `business/OdfCables` | `Controllers/Business/` |
+| `OdfCableFaultsController` | `business/OdfCableFaults` | `Controllers/Business/` |
+| `OdfUserModulesController` | `business/OdfUserModules` | `Controllers/Business/` |
+
+---
+
+## 后台管理菜单权限 SQL 脚本设计
+
+### 菜单结构
+
+根据现有 `sys_menu` 表结构，新增 4 个一级菜单（`parentId=0`，`menuType='C'`）和对应的按钮权限（`menuType='F'`），与现有的「机房列表」「机架列表」「端口列表」等同级。
+
+现有菜单 ID 最大值为 `11186`，新增菜单从 `11190` 开始分配，避免冲突。
+
+### 菜单 ID 分配
+
+| MenuId | MenuName | ParentId | MenuType | 说明 |
+|--------|----------|----------|----------|------|
+| 11190 | 光缆管理 | 0 | C | 一级菜单 |
+| 11191 | 查询 | 11190 | F | odfcables:query |
+| 11192 | 新增 | 11190 | F | odfcables:add |
+| 11193 | 删除 | 11190 | F | odfcables:delete |
+| 11194 | 修改 | 11190 | F | odfcables:edit |
+| 11195 | 导出 | 11190 | F | odfcables:export |
+| 11200 | 干线故障管理 | 0 | C | 一级菜单 |
+| 11201 | 查询 | 11200 | F | odfcablefaults:query |
+| 11202 | 删除 | 11200 | F | odfcablefaults:delete |
+| 11203 | 导出 | 11200 | F | odfcablefaults:export |
+| 11210 | 签到记录管理 | 0 | C | 一级菜单 |
+| 11211 | 查询 | 11210 | F | odfcheckin:query |
+| 11212 | 导出 | 11210 | F | odfcheckin:export |
+| 11220 | 用户模块权限 | 0 | C | 一级菜单 |
+| 11221 | 查询 | 11220 | F | odfusermodules:query |
+| 11222 | 修改 | 11220 | F | odfusermodules:edit |
+
+### SQL 脚本
+
+```sql
+-- =============================================
+-- ODF v1.0.2 菜单权限初始化脚本
+-- 新增 4 个一级菜单及按钮权限
+-- =============================================
+
+-- 1. 光缆管理（一级菜单）
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, IsCache, IsFrame, MenuType, Visible, Status, Perms, Icon, Create_by, Create_time)
+VALUES (11190, N'光缆管理', 0, 5, 'OdfCables', 'business/OdfCables', 0, 0, 'C', '0', '0', 'odfcables:list', 'icon1', 'admin', GETDATE());
+
+-- 光缆管理 - 按钮权限
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11191, N'查询', 11190, 1, '#', NULL, 'F', 'odfcables:query', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11192, N'新增', 11190, 2, '#', NULL, 'F', 'odfcables:add', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11193, N'删除', 11190, 3, '#', NULL, 'F', 'odfcables:delete', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11194, N'修改', 11190, 4, '#', NULL, 'F', 'odfcables:edit', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11195, N'导出', 11190, 5, '#', NULL, 'F', 'odfcables:export', 'admin', GETDATE());
+
+-- 2. 干线故障管理（一级菜单）
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, IsCache, IsFrame, MenuType, Visible, Status, Perms, Icon, Create_by, Create_time)
+VALUES (11200, N'干线故障管理', 0, 6, 'OdfCableFaults', 'business/OdfCableFaults', 0, 0, 'C', '0', '0', 'odfcablefaults:list', 'icon1', 'admin', GETDATE());
+
+-- 干线故障管理 - 按钮权限
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11201, N'查询', 11200, 1, '#', NULL, 'F', 'odfcablefaults:query', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11202, N'删除', 11200, 2, '#', NULL, 'F', 'odfcablefaults:delete', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11203, N'导出', 11200, 3, '#', NULL, 'F', 'odfcablefaults:export', 'admin', GETDATE());
+
+-- 3. 签到记录管理（一级菜单）
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, IsCache, IsFrame, MenuType, Visible, Status, Perms, Icon, Create_by, Create_time)
+VALUES (11210, N'签到记录管理', 0, 7, 'OdfCheckin', 'business/OdfCheckin', 0, 0, 'C', '0', '0', 'odfcheckin:list', 'icon1', 'admin', GETDATE());
+
+-- 签到记录管理 - 按钮权限
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11211, N'查询', 11210, 1, '#', NULL, 'F', 'odfcheckin:query', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11212, N'导出', 11210, 2, '#', NULL, 'F', 'odfcheckin:export', 'admin', GETDATE());
+
+-- 4. 用户模块权限（一级菜单）
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, IsCache, IsFrame, MenuType, Visible, Status, Perms, Icon, Create_by, Create_time)
+VALUES (11220, N'用户模块权限', 0, 8, 'OdfUserModules', 'business/OdfUserModules', 0, 0, 'C', '0', '0', 'odfusermodules:list', 'icon1', 'admin', GETDATE());
+
+-- 用户模块权限 - 按钮权限
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11221, N'查询', 11220, 1, '#', NULL, 'F', 'odfusermodules:query', 'admin', GETDATE());
+INSERT INTO sys_menu (MenuId, MenuName, ParentId, OrderNum, Path, Component, MenuType, Perms, Create_by, Create_time)
+VALUES (11222, N'修改', 11220, 2, '#', NULL, 'F', 'odfusermodules:edit', 'admin', GETDATE());
+```
+
+### 角色菜单权限分配
+
+ZRAdmin 权限体系通过 `sys_role_menu` 关联角色与菜单。现有角色分配规则：
+
+| 角色 | RoleId | RoleKey | 现有 ODF 权限 |
+|------|--------|---------|--------------|
+| 超级管理员 | 1 | admin | 自动拥有所有权限，无需插入 sys_role_menu |
+| 本部门及以下可编辑权限 | 2 | common | 所有 ODF 菜单 + 全部按钮权限（增删改查导出） |
+| 编辑角色 | 3 | editor | 所有 ODF 菜单 + 仅查询权限 |
+| 查看权限 | 4 | lock | 所有 ODF 菜单 + 仅查询权限 |
+
+后台 Controller 使用 `[ActionPermissionFilter(Permission = "xxx")]` 注解控制 API 访问权限，前端使用 `v-hasPermi` 指令控制按钮显隐。
+
+新增菜单需按照相同规则分配给各角色：
+
+```sql
+-- =============================================
+-- 角色菜单权限分配
+-- Role 2 (common): 所有菜单 + 全部按钮权限
+-- Role 3 (editor): 所有菜单 + 仅查询权限
+-- Role 4 (lock):   所有菜单 + 仅查询权限
+-- Role 1 (admin):  超级管理员自动拥有所有权限，无需插入
+-- =============================================
+
+-- Role 2 (common) — 光缆管理：全部权限
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11190, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11191, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11192, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11193, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11194, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11195, 'admin', GETDATE());
+
+-- Role 2 (common) — 干线故障管理：全部权限
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11200, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11201, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11202, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11203, 'admin', GETDATE());
+
+-- Role 2 (common) — 签到记录管理：全部权限
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11210, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11211, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11212, 'admin', GETDATE());
+
+-- Role 2 (common) — 用户模块权限：全部权限
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11220, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11221, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (2, 11222, 'admin', GETDATE());
+
+-- Role 3 (editor) — 光缆管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11190, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11191, 'admin', GETDATE());
+
+-- Role 3 (editor) — 干线故障管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11200, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11201, 'admin', GETDATE());
+
+-- Role 3 (editor) — 签到记录管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11210, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11211, 'admin', GETDATE());
+
+-- Role 3 (editor) — 用户模块权限：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11220, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (3, 11221, 'admin', GETDATE());
+
+-- Role 4 (lock) — 光缆管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11190, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11191, 'admin', GETDATE());
+
+-- Role 4 (lock) — 干线故障管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11200, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11201, 'admin', GETDATE());
+
+-- Role 4 (lock) — 签到记录管理：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11210, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11211, 'admin', GETDATE());
+
+-- Role 4 (lock) — 用户模块权限：菜单 + 查询
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11220, 'admin', GETDATE());
+INSERT INTO sys_role_menu (Role_id, Menu_id, Create_by, Create_time) VALUES (4, 11221, 'admin', GETDATE());
+```
+
+### 后台 Controller 权限注解
+
+新增 Controller 需使用 `[ActionPermissionFilter]` 注解，与 `sys_menu.Perms` 对应：
+
+| Controller | Action | Permission |
+|------------|--------|------------|
+| OdfCablesController | list | odfcables:list |
+| OdfCablesController | get | odfcables:query |
+| OdfCablesController | add | odfcables:add |
+| OdfCablesController | edit | odfcables:edit |
+| OdfCablesController | delete | odfcables:delete |
+| OdfCablesController | export | odfcables:export |
+| OdfCableFaultsController | list | odfcablefaults:list |
+| OdfCableFaultsController | get | odfcablefaults:query |
+| OdfCableFaultsController | add | odfcablefaults:list（APP 端提交，无独立 add 权限） |
+| OdfCableFaultsController | delete | odfcablefaults:delete |
+| OdfCableFaultsController | export | odfcablefaults:export |
+| OdfCheckinController | submit | odfcheckin:list（APP 端提交，无独立 add 权限） |
+| OdfCheckinController | list | odfcheckin:list |
+| OdfCheckinController | export | odfcheckin:export |
+| OdfUserModulesController | list（APP） | 无权限限制（登录用户查自己的模块） |
+| OdfUserModulesController | users | odfusermodules:query |
+| OdfUserModulesController | list（管理端） | odfusermodules:query |
+| OdfUserModulesController | save | odfusermodules:edit |
+
+### 说明
+
+- `OrderNum` 排在现有业务菜单（ODF机架管理=1, 机房列表=2, 机架列表=3, 端口列表=4）之后，从 5 开始
+- `Component` 指向 `business/OdfXxx`，ZRAdmin 动态路由会自动加载 `views/business/OdfXxx.vue`
+- `Path` 为路由路径，与 Component 文件名一致
+- `Icon` 使用 `icon1`（与现有业务菜单一致），可后续在管理界面调整
+- 按钮权限的 `Path` 统一为 `#`，`Component` 为 `NULL`，与现有模式一致
+- 菜单 ID 预留间隔（11190-11195, 11200-11203, 11210-11212, 11220-11222），便于后续扩展
+- `sys_role_menu` 分配遵循现有角色权限模式：common 全权限、editor/lock 仅查询
+
+---
+
+## 后台管理前端设计
+
+### 技术栈与代码风格
+
+后台管理前端基于 ZR.Vue（Vue 3 + Element Plus + Pinia + Vue Router + Vite），所有新增页面遵循现有 `views/business/` 下的代码风格：
+
+- 使用 `<script setup name="xxx">` 语法
+- 页面结构：查询表单 → 工具栏（增删改查按钮）→ el-table → pagination
+- 权限控制使用 `v-hasPermi` 指令
+- API 调用格式：`listXxx(queryParams)` / `delXxx(ids)` / `getXxx(id)` / `addXxx(data)` / `updateXxx(data)`
+- 表单使用独立组件（`components/business/XxxForm.vue`），通过 `v-model:visible` 控制显隐
+- 列配置使用 `columns` ref 数组，支持 `showColumn()` 控制列显隐
+- 支持排序（`@sort-change`）、多选（`@selection-change`）、分页
+
+### 新增文件清单
+
+| 类型 | 文件路径 | 说明 |
+|------|----------|------|
+| 页面 | `views/business/OdfCables.vue` | 光缆管理 |
+| 页面 | `views/business/OdfCableFaults.vue` | 干线故障管理 |
+| 页面 | `views/business/OdfCheckin.vue` | 签到记录管理 |
+| 页面 | `views/business/OdfUserModules.vue` | 用户模块权限管理 |
+| 表单组件 | `components/business/OdfCableForm.vue` | 光缆新增/编辑表单 |
+| API | `api/business/odfcables.js` | 光缆管理 API |
+| API | `api/business/odfcablefaults.js` | 干线故障管理 API |
+| API | `api/business/odfcheckin.js` | 签到记录管理 API |
+| API | `api/business/odfusermodules.js` | 用户模块权限管理 API |
+
+---
+
+### 1. 光缆管理（OdfCables.vue）
+
+**页面功能：** 光缆的增删改查，支持按光缆名称和所属部门查询。
+
+**查询表单：**
+
+| 字段 | 组件 | 绑定 |
+|------|------|------|
+| 光缆名称 | `el-input` | `queryParams.cableName` |
+| 所属部门 | `el-tree-select`（部门树） | `queryParams.deptId` |
+
+**工具栏按钮：**
+- 新增（`v-hasPermi="['odfcables:add']"`）
+- 编辑（`v-hasPermi="['odfcables:edit']"`，单选启用）
+- 删除（`v-hasPermi="['odfcables:delete']"`，多选启用）
+- 导出（`v-hasPermi="['odfcables:export']"`）
+
+**表格列配置：**
+
+```javascript
+const columns = ref([
+  { visible: true, prop: 'id', label: 'Id', align: 'center' },
+  { visible: true, prop: 'cableName', label: '光缆名称', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'deptName', label: '所属部门', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'createdAt', label: '创建时间', align: 'center', showOverflowTooltip: true },
+])
+```
+
+**操作列：** 详情、编辑、删除（同 OdfRooms 模式）
+
+**表单组件（OdfCableForm.vue）：**
+
+独立弹窗组件，支持 add / edit / view 三种模式：
+
+| 字段 | 组件 | 验证 |
+|------|------|------|
+| 光缆名称 | `el-input` | 必填 |
+| 所属部门 | `el-tree-select`（部门树） | — |
+
+组件接口：
+```html
+<OdfCableForm v-model:visible="formVisible" :id="currentId" :mode="formMode" @success="handleFormSuccess" />
+```
+
+---
+
+### 2. 干线故障管理（OdfCableFaults.vue）
+
+**页面功能：** 故障记录的查看和删除。故障由 APP 端提交，后台仅提供查看和删除功能，不提供新增/编辑。
+
+**查询表单：**
+
+| 字段 | 组件 | 绑定 |
+|------|------|------|
+| 所属光缆 | `el-select`（远程搜索，调用光缆列表接口） | `queryParams.cableId` |
+| 故障时间范围 | `el-date-picker` type="daterange" | `queryParams.beginFaultTime` / `queryParams.endFaultTime` |
+| 故障原因 | `el-input` | `queryParams.faultReason` |
+
+**工具栏按钮：**
+- 删除（`v-hasPermi="['odfcablefaults:delete']"`，多选启用）
+- 导出（`v-hasPermi="['odfcablefaults:export']"`）
+- 无新增/编辑按钮
+
+**表格列配置：**
+
+```javascript
+const columns = ref([
+  { visible: true, prop: 'id', label: 'Id', align: 'center' },
+  { visible: true, prop: 'faultTime', label: '故障时间', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'personnel', label: '人员', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'faultReason', label: '故障原因', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'mileage', label: '表显故障里程', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'cableName', label: '所属光缆', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'location', label: '地点', align: 'center', showOverflowTooltip: true },
+  { visible: false, prop: 'latitude', label: '纬度', align: 'center' },
+  { visible: false, prop: 'longitude', label: '经度', align: 'center' },
+  { visible: true, prop: 'createdAt', label: '创建时间', align: 'center', showOverflowTooltip: true },
+])
+```
+
+**操作列：** 详情、删除
+
+**详情弹窗：**
+
+点击详情按钮时，调用 `getOdfCableFaults(id)` 获取完整数据（含图片列表），在 `el-dialog` 中展示：
+- 所有文本字段以 `el-descriptions` 或表单只读模式展示
+- 图片列表使用 `el-image` 组件，支持 `preview-src-list` 点击放大预览
+- 图片区域布局：flex wrap，每张图片 `width: 120px`，`height: 120px`，`object-fit: cover`
+
+---
+
+### 3. 签到记录管理（OdfCheckin.vue）
+
+**页面功能：** 签到记录的只读查看，不提供增删改功能。签到数据由 APP 端提交。
+
+**查询表单：**
+
+| 字段 | 组件 | 绑定 |
+|------|------|------|
+| 机房 | `el-select`（远程搜索，调用机房列表接口） | `queryParams.roomId` |
+| 人员 | `el-input` | `queryParams.personnel` |
+| 签到时间范围 | `el-date-picker` type="daterange" | `queryParams.beginCheckinTime` / `queryParams.endCheckinTime` |
+
+**工具栏按钮：**
+- 导出（`v-hasPermi="['odfcheckin:export']"`）
+- 无新增/编辑/删除按钮
+
+**表格列配置：**
+
+```javascript
+const columns = ref([
+  { visible: true, prop: 'id', label: 'Id', align: 'center' },
+  { visible: true, prop: 'roomName', label: '机房名称', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'personnel', label: '人员', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'checkinTime', label: '签到时间', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'workContent', label: '工作内容', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'userName', label: '提交人', align: 'center', showOverflowTooltip: true },
+  { visible: true, prop: 'createdAt', label: '创建时间', align: 'center', showOverflowTooltip: true },
+])
+```
+
+**操作列：** 无（纯只读列表）
+
+---
+
+### 4. 用户模块权限管理（OdfUserModules.vue）
+
+**页面功能：** 为用户分配可见的功能版块（odf / trunk / route）。采用左右分栏布局，不同于标准 CRUD 页面。
+
+**页面结构：**
+
+```
+OdfUserModules
+├── 左侧面板（el-card，宽度 360px）
+│   ├── 搜索框（el-input，placeholder: "搜索用户"）
+│   └── 用户列表（el-table，单列显示用户名）
+│       └── 点击行高亮选中
+└── 右侧面板（el-card，flex: 1）
+    ├── 标题区域："用户名 - 模块权限配置"
+    ├── 模块权限区域（el-checkbox-group）
+    │   ├── el-checkbox label="odf" → "机房 ODF"
+    │   ├── el-checkbox label="trunk" → "干线"
+    │   └── el-checkbox label="route" → "路线规划"
+    └── 操作区域
+        └── el-button type="primary" "保存"
+```
+
+**交互流程：**
+1. 页面加载时调用 `listUsers()` 获取用户列表
+2. 左侧搜索框支持前端过滤用户名
+3. 点击用户行 → 调用 `getUserModules(userId)` 获取该用户已分配的模块列表 → 填充右侧 checkbox
+4. 勾选/取消模块 → 点击保存 → 调用 `saveUserModules(userId, modules)` 批量更新
+5. 保存成功 → `ElMessage.success('保存成功')`
+
+**权限控制：** 整个页面需要 `v-hasPermi="['odfusermodules:edit']"` 权限
+
+---
+
+### API 文件定义
+
+#### api/business/odfcables.js
+
+```javascript
+import request from '@/utils/request'
+import { downFile } from '@/utils/request'
+
+/**
+ * 光缆列表分页查询
+ */
+export function listOdfCables(query) {
+  return request({
+    url: 'business/OdfCables/list',
+    method: 'get',
+    params: query,
+  })
+}
+
+/**
+ * 新增光缆
+ */
+export function addOdfCables(data) {
+  return request({
+    url: 'business/OdfCables',
+    method: 'post',
+    data: data,
+  })
+}
+
+/**
+ * 修改光缆
+ */
+export function updateOdfCables(data) {
+  return request({
+    url: 'business/OdfCables',
+    method: 'PUT',
+    data: data,
+  })
+}
+
+/**
+ * 获取光缆详情
+ */
+export function getOdfCables(id) {
+  return request({
+    url: 'business/OdfCables/' + id,
+    method: 'get',
+  })
+}
+
+/**
+ * 删除光缆
+ */
+export function delOdfCables(pid) {
+  return request({
+    url: 'business/OdfCables/delete/' + pid,
+    method: 'POST',
+  })
+}
+
+/**
+ * 导出光缆
+ */
+export async function exportOdfCables(query) {
+  await downFile('business/OdfCables/export', { ...query })
+}
+```
+
+#### api/business/odfcablefaults.js
+
+```javascript
+import request from '@/utils/request'
+import { downFile } from '@/utils/request'
+
+/**
+ * 故障列表分页查询
+ */
+export function listOdfCableFaults(query) {
+  return request({
+    url: 'business/OdfCableFaults/list',
+    method: 'get',
+    params: query,
+  })
+}
+
+/**
+ * 获取故障详情（含图片）
+ */
+export function getOdfCableFaults(id) {
+  return request({
+    url: 'business/OdfCableFaults/' + id,
+    method: 'get',
+  })
+}
+
+/**
+ * 删除故障
+ */
+export function delOdfCableFaults(pid) {
+  return request({
+    url: 'business/OdfCableFaults/delete/' + pid,
+    method: 'POST',
+  })
+}
+
+/**
+ * 导出故障
+ */
+export async function exportOdfCableFaults(query) {
+  await downFile('business/OdfCableFaults/export', { ...query })
+}
+```
+
+#### api/business/odfcheckin.js
+
+```javascript
+import request from '@/utils/request'
+import { downFile } from '@/utils/request'
+
+/**
+ * 签到记录分页查询
+ */
+export function listOdfCheckin(query) {
+  return request({
+    url: 'business/OdfCheckin/list',
+    method: 'get',
+    params: query,
+  })
+}
+
+/**
+ * 导出签到记录
+ */
+export async function exportOdfCheckin(query) {
+  await downFile('business/OdfCheckin/export', { ...query })
+}
+```
+
+#### api/business/odfusermodules.js
+
+```javascript
+import request from '@/utils/request'
+
+/**
+ * 获取用户列表（简要信息，用于左侧列表）
+ */
+export function listUsers(query) {
+  return request({
+    url: 'business/OdfUserModules/users',
+    method: 'get',
+    params: query,
+  })
+}
+
+/**
+ * 获取指定用户的模块权限列表
+ */
+export function getUserModules(userId) {
+  return request({
+    url: 'business/OdfUserModules/list',
+    method: 'get',
+    params: { userId },
+  })
+}
+
+/**
+ * 保存用户模块权限（批量更新）
+ */
+export function saveUserModules(data) {
+  return request({
+    url: 'business/OdfUserModules/save',
+    method: 'post',
+    data: data, // { userId, modules: ['odf', 'trunk'] }
+  })
+}
+```
+
+---
+
+### 后台管理前端对应的后台 API 补充
+
+以下 API 需要在后台新增，以支持管理前端的查询和操作需求：
+
+#### 光缆管理后台 API（管理端扩展）
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `business/OdfCables/list` | GET | 分页查询（支持 cableName、deptId 过滤） |
+| `business/OdfCables` | POST | 新增光缆 |
+| `business/OdfCables` | PUT | 修改光缆 |
+| `business/OdfCables/{id}` | GET | 获取光缆详情 |
+| `business/OdfCables/delete/{id}` | POST | 删除光缆 |
+| `business/OdfCables/export` | GET | 导出光缆列表 |
+
+#### 故障管理后台 API（管理端扩展）
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `business/OdfCableFaults/list` | GET | 分页查询（支持 cableId、faultTime 范围、faultReason 过滤） |
+| `business/OdfCableFaults/{id}` | GET | 获取故障详情（含图片列表） |
+| `business/OdfCableFaults/delete/{id}` | POST | 删除故障（级联删除关联图片） |
+| `business/OdfCableFaults/export` | GET | 导出故障列表 |
+
+#### 签到记录后台 API（管理端扩展）
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `business/OdfCheckin/list` | GET | 分页查询（支持 roomId、personnel、checkinTime 范围过滤，联查机房名称和提交人用户名） |
+| `business/OdfCheckin/export` | GET | 导出签到记录 |
+
+#### 用户模块权限后台 API（管理端扩展）
+
+| 路由 | 方法 | 说明 |
+|------|------|------|
+| `business/OdfUserModules/users` | GET | 获取用户列表（userId, userName） |
+| `business/OdfUserModules/list` | GET | 获取指定用户的模块权限列表（按 userId 查询） |
+| `business/OdfUserModules/save` | POST | 批量保存用户模块权限（先删后插） |
+
+---
+
+## 正确性属性
+
+*属性（Property）是指在系统所有有效执行中都应成立的特征或行为——本质上是对系统应做什么的形式化陈述。属性是人类可读规格说明与机器可验证正确性保证之间的桥梁。*
+
+### 前端属性
+
+### Property 1: 权限过滤正确性
+
+*For any* 功能版块全集和任意权限列表，权限过滤函数应返回且仅返回权限列表中包含的版块，未包含的版块不应出现在结果中。
+
+**Validates: Requirements 1.1, 1.5, 8.3**
+
+### Property 2: 签到数据完整性（前端）
+
+*For any* 有效的签到数据（非空人员、有效时间、非空工作内容），提交时构建的请求体应包含所有必要字段（roomId、personnel、checkinTime、workContent），且字段值与用户输入一致。
+
+**Validates: Requirements 2.6**
+
+### Property 3: 故障记录渲染完整性
+
+*For any* 故障数据对象，渲染函数输出应包含故障时间、故障原因、表显故障里程、所属光缆名称四个字段；对于故障详情，还应包含图片列表、人员、地点、备注。
+
+**Validates: Requirements 5.1, 6.1**
+
+### Property 4: 搜索范围限定（前端）
+
+*For any* 公司 ID 和搜索关键词，搜索请求应携带当前公司的 deptId 参数，确保搜索范围限定在该公司内。
+
+**Validates: Requirements 4.4**
+
+### Property 5: 搜索结果分类正确性
+
+*For any* 搜索结果数据（包含光缆列表和故障列表），光缆分类下应展示所有匹配的光缆名称，故障分类下应展示所有匹配的故障记录（含故障时间、故障原因、所属光缆）。
+
+**Validates: Requirements 9.2, 9.3**
+
+### Property 6: 导航 URL 构建正确性
+
+*For any* 有效的经纬度坐标和地点名称，导航 URL 构建函数应生成包含正确经纬度参数的 URL 字符串。
+
+**Validates: Requirements 6.5, 10.4**
+
+### Property 7: 水印叠加参数正确性
+
+*For any* 有效的时间字符串和人员字符串，水印函数应将这两个信息组合为水印文本，且水印文本中同时包含时间和人员信息。
+
+**Validates: Requirements 7.8**
+
+### Property 8: 故障提交数据完整性（前端）
+
+*For any* 有效的故障表单数据（含照片、时间、人员、故障原因、表显故障里程、所属光缆、经纬度、备注），提交时构建的请求体应包含所有必要字段，且字段值与用户输入一致。
+
+**Validates: Requirements 7.9**
+
+### Property 9: 路线距离定位计算
+
+*For any* 有效的路线点序列（至少 2 个点）和一个在 [0, 路线总长度] 范围内的距离值，距离定位函数应返回一个位于路线上的坐标点，且该点到路线起点的沿路线距离等于输入的距离值。
+
+**Validates: Requirements 11.3**
+
+### Property 10: 页面导航参数传递正确性
+
+*For any* 列表项数据（公司、光缆、故障），点击该项时构建的导航 URL 应包含正确的目标页面路径和完整的查询参数（如 deptId、cableId、faultId 等）。
+
+**Validates: Requirements 3.3, 4.2, 5.2, 9.4, 9.5**
+
+### 后台属性
+
+### Property 11: 签到数据持久化 round-trip
+
+*For any* 有效的签到输入（非空 Personnel、有效 CheckinTime、非空 WorkContent、存在的 RoomId），调用 AddCheckin 后查询该记录，返回的 Personnel、CheckinTime、WorkContent、RoomId 应与输入一致。
+
+**Validates: Requirements 2.6**
+
+### Property 12: 光缆列表 DeptId 过滤不变量
+
+*For any* DeptId 和数据库中的光缆集合，GetList(deptId) 返回的每条光缆记录的 DeptId 都应等于查询参数 deptId，且不遗漏任何属于该 deptId 的光缆。
+
+**Validates: Requirements 4.1**
+
+### Property 13: 搜索结果 DeptId 范围限定
+
+*For any* DeptId 和搜索关键词，Search(deptId, keyword) 返回的所有光缆的 DeptId 应等于 deptId，返回的所有故障应属于 DeptId 等于 deptId 的光缆。
+
+**Validates: Requirements 4.4**
+
+### Property 14: 故障新增 round-trip（含图片）
+
+*For any* 有效的故障输入（存在的 CableId、至少 1 张图片、有效 FaultTime），调用 AddFault 后查询故障详情，返回的所有字段应与输入一致，且关联的图片数量应等于输入的图片数量。
+
+**Validates: Requirements 7.9**
+
+### Property 15: 用户模块权限 round-trip
+
+*For any* UserId 和模块代码集合，将这些模块插入 odf_user_modules 后调用 GetUserModules(userId)，返回的模块列表应与插入的集合完全一致（无遗漏、无多余）。
+
+**Validates: Requirements 8.1, 8.2**
+
+### 管理前端属性
+
+### Property 16: 光缆表单数据完整性
+
+*For any* 有效的光缆表单数据（非空光缆名称、有效部门 ID），提交时构建的请求体应包含 cableName 和 deptId 字段，且字段值与用户输入一致。
+
+**Validates: 后台管理前端 — 光缆管理**
+
+### Property 17: 管理端查询参数构建正确性
+
+*For any* 管理页面的查询条件组合（光缆名称/部门、故障光缆/时间范围/原因、签到机房/人员/时间范围），构建的 API 请求参数对象应包含所有非空查询条件，且参数值与用户输入一致。
+
+**Validates: 后台管理前端 — 光缆管理、故障管理、签到记录管理**
+
+### Property 18: 用户列表前端搜索过滤
+
+*For any* 用户列表和搜索关键词，前端过滤函数返回的每个用户的用户名都应包含该搜索关键词（不区分大小写），且不遗漏任何匹配的用户。
+
+**Validates: 后台管理前端 — 用户模块权限管理**
+
+### Property 19: 用户模块权限保存数据构建
+
+*For any* 有效的 userId 和模块 checkbox 选中状态（odf/trunk/route 的任意子集），保存时构建的请求体应包含正确的 userId 和与 checkbox 选中状态一致的 modules 数组。
+
+**Validates: 后台管理前端 — 用户模块权限管理**
+
+
+## 错误处理
+
+### 网络请求错误
+
+沿用现有 `services/api.js` 的统一错误处理模式：
+- 请求超时（20s）：reject 并返回 `{ code: -1, msg: '网络异常' }`
+- 服务端返回非 200 状态码：由各页面根据 `res.code` 和 `res.msg` 展示错误提示
+- 401 未授权：跳转至登录页
+
+### 表单提交错误
+
+- 签到提交失败：`uni.showToast({ title: res.msg, icon: 'none' })`，保留表单数据不清空
+- 故障提交失败：同上，保留所有已填写数据和已拍摄照片
+- 表单验证失败（空字段、未拍照等）：`uni.showToast` 提示具体缺失项，不发起请求
+
+### 设备功能错误
+
+- 定位失败：`uni.showToast({ title: '定位失败，请检查权限设置', icon: 'none' })`，经纬度保持默认值 0
+- 相机调用失败：`uni.showToast` 提示错误信息
+- 导航 APP 不可用：H5 端降级为打开地图网页
+
+### 水印处理错误
+
+- Canvas 绑定或绘制失败：跳过水印处理，直接上传原图，并在提交结果中标记水印失败
+- 图片加载失败：提示用户该照片无法处理，允许重新拍摄
+
+### 权限接口错误
+
+- 权限接口调用失败：默认显示空版块列表，提示用户刷新重试
+- 权限数据格式异常：降级为空列表，不崩溃
+
+## 测试策略
+
+### 单元测试
+
+#### 前端测试（Vitest）
+
+**工具函数测试：**
+- `utils/navigation.js`：验证各平台导航 URL 构建的正确性
+- `utils/watermark.js`：验证水印文本生成逻辑
+- 路线距离定位计算函数：验证边界值（距离为 0、等于总长度、中间值）
+
+**服务层测试：**
+- 验证各 API 函数调用正确的 URL 和参数
+- 验证请求体构建的完整性
+
+**数据处理测试：**
+- 权限过滤逻辑
+- 搜索结果分类逻辑
+- 故障数据字段映射
+
+**边界情况测试：**
+- 空权限列表 → 显示空状态
+- 经纬度为空/0 → 隐藏导航按钮
+- 未拍照提交 → 阻止提交并提示
+- 签到/故障提交失败 → 保留表单数据
+- 搜索关键词为空 → 不触发搜索
+
+**管理前端测试（Vitest）：**
+- 光缆管理：验证查询参数构建、表单数据提交完整性
+- 故障管理：验证查询参数构建（含日期范围）、详情弹窗数据加载
+- 签到记录：验证查询参数构建（含日期范围）
+- 用户模块权限：验证用户列表前端搜索过滤、模块权限保存数据构建
+- 管理端 API 函数：验证各 API 调用正确的 URL 和参数
+
+#### 后台测试（xUnit / NUnit）
+
+**Service 层单元测试：**
+- `OdfCheckinService`：签到记录插入、RoomId 校验
+- `OdfCablesService`：光缆列表按 DeptId 过滤、搜索逻辑
+- `OdfCableFaultsService`：故障列表分页、故障详情联查图片、新增故障含图片持久化
+- `OdfUserModulesService`：用户模块查询、空模块返回空列表
+
+**Controller 层测试：**
+- 验证路由映射正确
+- 验证参数绑定（FromQuery、FromBody、FromForm）
+- 验证权限注解配置
+
+**边界情况测试：**
+- 签到时 RoomId 不存在 → 返回错误
+- 新增故障时 CableId 不存在 → 返回错误
+- 新增故障时无图片 → 返回错误
+- 搜索关键词为空 → 返回空结果
+- 用户无模块权限 → 返回空列表
+- 管理端删除故障时级联删除关联图片
+- 管理端保存用户模块权限时先删后插的原子性
+- 签到记录列表联查机房名称和提交人用户名
+
+### 属性测试
+
+#### 前端属性测试（fast-check + Vitest）
+
+每个属性测试至少运行 100 次迭代。
+
+每个属性测试必须以注释标注对应的设计属性：
+
+```javascript
+// Feature: odf-v102-update, Property 1: 权限过滤正确性
+test.prop('权限过滤只返回有权限的版块', [fc.array(fc.constantFrom('odf', 'trunk', 'route'))], (modules) => {
+  const allModules = ['odf', 'trunk', 'route']
+  const filtered = filterModules(allModules, modules)
+  expect(filtered.every(m => modules.includes(m))).toBe(true)
+  expect(modules.every(m => filtered.includes(m))).toBe(true)
+})
+```
+
+**前端属性测试覆盖：**
+
+| 属性 | 测试描述 | 生成器 |
+|------|----------|--------|
+| Property 1 | 权限过滤正确性 | 随机权限子集 |
+| Property 2 | 签到数据完整性（前端） | 随机字符串（人员、工作内容）、随机日期 |
+| Property 3 | 故障记录渲染完整性 | 随机故障数据对象 |
+| Property 4 | 搜索范围限定（前端） | 随机 deptId、随机关键词 |
+| Property 5 | 搜索结果分类正确性 | 随机搜索结果数据 |
+| Property 6 | 导航 URL 构建正确性 | 随机经纬度、随机地点名 |
+| Property 7 | 水印文本生成正确性 | 随机时间字符串、随机人员字符串 |
+| Property 8 | 故障提交数据完整性（前端） | 随机故障表单数据 |
+| Property 9 | 路线距离定位计算 | 随机路线点序列、随机距离值 |
+| Property 10 | 页面导航参数传递 | 随机列表项数据 |
+| Property 16 | 光缆表单数据完整性 | 随机光缆名称、随机部门 ID |
+| Property 17 | 管理端查询参数构建正确性 | 随机查询条件组合 |
+| Property 18 | 用户列表前端搜索过滤 | 随机用户列表、随机关键词 |
+| Property 19 | 用户模块权限保存数据构建 | 随机 userId、随机模块子集 |
+
+#### 后台属性测试（FsCheck / xUnit）
+
+使用 FsCheck 作为 .NET 属性测试库，配合 xUnit 运行。每个属性测试至少运行 100 次迭代。
+
+```csharp
+// Feature: odf-v102-update, Property 15: 用户模块权限 round-trip
+[Property(MaxTest = 100)]
+public Property UserModulesRoundTrip()
+{
+    return Prop.ForAll(
+        Arb.From<long>(),
+        Gen.SubListOf(new[] { "odf", "trunk", "route" }).ToArbitrary(),
+        (userId, modules) =>
+        {
+            // 插入模块 → 查询 → 验证一致
+        });
+}
+```
+
+**后台属性测试覆盖：**
+
+| 属性 | 测试描述 | 生成器 |
+|------|----------|--------|
+| Property 11 | 签到数据持久化 round-trip | 随机 Personnel、CheckinTime、WorkContent |
+| Property 12 | 光缆列表 DeptId 过滤不变量 | 随机 DeptId、随机光缆集合 |
+| Property 13 | 搜索结果 DeptId 范围限定 | 随机 DeptId、随机关键词、随机数据集 |
+| Property 14 | 故障新增 round-trip（含图片） | 随机故障字段、随机图片数量 |
+| Property 15 | 用户模块权限 round-trip | 随机 UserId、随机模块子集 |
+
+### 测试配置
+
+**前端：**
+```javascript
+// vitest.config.js
+export default {
+  test: {
+    environment: 'jsdom',
+    include: ['tests/**/*.test.js'],
+  }
+}
+```
+
+**后台：**
+- 使用 SQLite In-Memory 或 SqlSugar 的内存模式作为测试数据库
+- 每个测试用例独立事务，测试后回滚
+
+属性测试每个用例至少 100 次迭代（fast-check 和 FsCheck 默认即满足），确保覆盖足够多的随机输入组合。
diff --git a/.kiro/specs/odf-v102-update/tasks.md b/.kiro/specs/odf-v102-update/tasks.md
new file mode 100644
index 0000000..033a032
--- /dev/null
+++ b/.kiro/specs/odf-v102-update/tasks.md
@@ -0,0 +1,411 @@
+# 实施计划：ODF v1.0.2 功能更新
+
+## 概述
+
+按照「数据库 → 后台 API → 前端 APP → 后台管理前端」的顺序实施，确保每一层的依赖在实现前已就绪。后台基于 ZRAdmin（.NET/C#/SqlSugar），前端 APP 基于 odf-uniapp（UniApp + Vue 3），后台管理前端基于 ZR.Vue（Vue 3 + Element Plus）。
+
+## 任务
+
+- [ ] 1. 数据库：创建新表和索引
+  - [ ] 1.1 创建 odf_checkin 签到记录表（含索引 IX_odf_checkin_RoomId、IX_odf_checkin_CheckinTime）
+    - 编写 SQL Server DDL 脚本，创建表和索引
+    - _需求: 2.6_
+  - [ ] 1.2 创建 odf_cables 光缆表（含索引 IX_odf_cables_DeptId、IX_odf_cables_CableName）
+    - 编写 SQL Server DDL 脚本，创建表和索引
+    - _需求: 4.1_
+  - [ ] 1.3 创建 odf_cable_faults 干线故障表（含索引 IX_odf_cable_faults_CableId、IX_odf_cable_faults_FaultTime）
+    - 编写 SQL Server DDL 脚本，创建表和索引
+    - _需求: 5.1, 7.9_
+  - [ ] 1.4 创建 odf_cable_fault_images 故障图片表（含索引 IX_odf_cable_fault_images_FaultId）
+    - 编写 SQL Server DDL 脚本，创建表和索引
+    - _需求: 7.9_
+  - [ ] 1.5 创建 odf_user_modules 用户功能版块权限表（含唯一索引和普通索引）
+    - 编写 SQL Server DDL 脚本，创建表和索引
+    - _需求: 8.1_
+  - [ ] 1.6 插入后台管理菜单和权限 SQL 脚本
+    - 编写 INSERT INTO sys_menu SQL 脚本，添加以下一级菜单（parentId=0）和按钮权限：
+    - 一级菜单「光缆管理」（MenuId=11190，OrderNum=5）及按钮权限（odfcables:query / odfcables:add / odfcables:edit / odfcables:delete / odfcables:export）
+    - 一级菜单「干线故障管理」（MenuId=11200，OrderNum=6）及按钮权限（odfcablefaults:query / odfcablefaults:delete / odfcablefaults:export）
+    - 一级菜单「签到记录管理」（MenuId=11210，OrderNum=7）及按钮权限（odfcheckin:query / odfcheckin:export）
+    - 一级菜单「用户模块权限」（MenuId=11220，OrderNum=8）及按钮权限（odfusermodules:query / odfusermodules:edit）
+    - 所有菜单 Component 指向 business/OdfXxx，ZRAdmin 动态路由自动加载对应 Vue 文件
+    - 编写 INSERT INTO sys_role_menu SQL 脚本，按现有角色权限模式分配：
+    - Role 2 (common)：所有新菜单 + 全部按钮权限
+    - Role 3 (editor)：所有新菜单 + 仅查询权限
+    - Role 4 (lock)：所有新菜单 + 仅查询权限
+    - Role 1 (admin)：超级管理员自动拥有所有权限，无需插入
+    - _需求: 8.1_
+
+- [ ] 2. 检查点 — 数据库脚本完成
+  - 确认所有 5 张表和索引创建成功，菜单权限 SQL 脚本执行无误，如有问题请告知。
+
+- [ ] 3. 后台 API：实体模型层
+  - [ ] 3.1 创建 OdfCheckin 实体类（ZR.Model/Business/OdfCheckin.cs）
+    - 使用 [SugarTable("odf_checkin")] 注解，定义 Id、RoomId、Personnel、CheckinTime、WorkContent、UserId、CreatedAt 属性
+    - _需求: 2.6_
+  - [ ] 3.2 创建 OdfCables 实体类（ZR.Model/Business/OdfCables.cs）
+    - 使用 [SugarTable("odf_cables")] 注解，定义 Id、CableName、DeptId、DeptName、CreatedAt、UpdatedAt 属性
+    - _需求: 4.1_
+  - [ ] 3.3 创建 OdfCableFaults 实体类（ZR.Model/Business/OdfCableFaults.cs）
+    - 使用 [SugarTable("odf_cable_faults")] 注解，定义所有字段属性
+    - _需求: 5.1, 7.9_
+  - [ ] 3.4 创建 OdfCableFaultImages 实体类（ZR.Model/Business/OdfCableFaultImages.cs）
+    - 使用 [SugarTable("odf_cable_fault_images")] 注解
+    - _需求: 7.9_
+  - [ ] 3.5 创建 OdfUserModules 实体类（ZR.Model/Business/OdfUserModules.cs）
+    - 使用 [SugarTable("odf_user_modules")] 注解
+    - _需求: 8.1_
+  - [ ] 3.6 创建各实体的 Dto 和 QueryDto 类
+    - OdfCheckinDto、OdfCheckinQueryDto（继承 PagerInfo）
+    - OdfCablesQueryDto（继承 PagerInfo）
+    - OdfCableFaultsQueryDto（继承 PagerInfo，含 beginFaultTime/endFaultTime）
+    - OdfCableFaultAddDto（含 IFormFile[] images）
+    - OdfUserModulesSaveDto（含 userId、modules 列表）
+    - _需求: 2.6, 4.1, 5.1, 7.9, 8.1_
+
+- [ ] 4. 后台 API：Service 层
+  - [ ] 4.1 实现 IOdfUserModulesService / OdfUserModulesService
+    - GetUserModules(userId)：按 UserId 查询 odf_user_modules，返回 ModuleCode 列表
+    - GetUserList()：查询 sys_user 返回用户列表（userId, userName）
+    - SaveUserModules(userId, modules)：先删后插，事务保证原子性
+    - _需求: 8.1, 8.2_
+  - [ ]* 4.1.1 编写属性测试 Property 15：用户模块权限 round-trip
+    - **Property 15: 用户模块权限 round-trip**
+    - 使用 FsCheck 生成随机 UserId 和模块子集，验证插入后查询结果一致
+    - **验证: 需求 8.1, 8.2**
+  - [ ] 4.2 实现 IOdfCheckinService / OdfCheckinService
+    - AddCheckin(dto)：校验 RoomId 存在，插入 odf_checkin 记录
+    - GetList(queryDto)：分页查询，联查 odf_rooms 获取机房名称，联查 sys_user 获取提交人用户名
+    - Export(queryDto)：导出签到记录
+    - _需求: 2.6_
+  - [ ]* 4.2.1 编写属性测试 Property 11：签到数据持久化 round-trip
+    - **Property 11: 签到数据持久化 round-trip**
+    - 使用 FsCheck 生成随机签到数据，验证插入后查询字段一致
+    - **验证: 需求 2.6**
+  - [ ] 4.3 实现 IOdfCablesService / OdfCablesService
+    - GetList(queryDto)：按 DeptId 过滤光缆列表（支持分页和 CableName 模糊查询）
+    - Search(deptId, keyword)：在指定公司范围内搜索光缆和故障
+    - Add/Update/Delete/GetDetail/Export：光缆 CRUD 和导出
+    - _需求: 4.1, 4.4_
+  - [ ]* 4.3.1 编写属性测试 Property 12：光缆列表 DeptId 过滤不变量
+    - **Property 12: 光缆列表 DeptId 过滤不变量**
+    - 使用 FsCheck 生成随机 DeptId 和光缆集合，验证过滤结果正确
+    - **验证: 需求 4.1**
+  - [ ]* 4.3.2 编写属性测试 Property 13：搜索结果 DeptId 范围限定
+    - **Property 13: 搜索结果 DeptId 范围限定**
+    - 使用 FsCheck 生成随机数据集，验证搜索结果均属于指定 DeptId
+    - **验证: 需求 4.4**
+  - [ ] 4.4 实现 IOdfCableFaultsService / OdfCableFaultsService
+    - GetList(queryDto)：按 CableId 分页查询故障列表，联查光缆名称，按 FaultTime DESC 排序
+    - GetDetail(id)：查询故障详情，联查光缆名称和图片列表
+    - AddFault(dto)：校验 CableId 存在和图片数量，插入故障记录，保存图片文件，插入图片记录
+    - Delete(id)：删除故障记录并级联删除关联图片
+    - Export(queryDto)：导出故障列表
+    - _需求: 5.1, 6.1, 7.9_
+  - [ ]* 4.4.1 编写属性测试 Property 14：故障新增 round-trip（含图片）
+    - **Property 14: 故障新增 round-trip（含图片）**
+    - 使用 FsCheck 生成随机故障数据和图片数量，验证插入后查询一致
+    - **验证: 需求 7.9**
+  - [ ] 4.5 实现 IOdfCableFaultImagesService / OdfCableFaultImagesService
+    - GetByFaultId(faultId)：按故障 ID 查询图片列表
+    - BatchInsert(faultId, imageUrls)：批量插入图片记录
+    - DeleteByFaultId(faultId)：按故障 ID 删除所有图片记录
+    - _需求: 7.9_
+
+- [ ] 5. 后台 API：Controller 层
+  - [ ] 5.1 创建 OdfUserModulesController（路由 business/OdfUserModules）
+    - GET list — 获取当前登录用户的功能版块列表（APP 端调用，无权限限制，登录即可）
+    - GET users — 获取用户列表（管理端调用，[ActionPermissionFilter(Permission = "odfusermodules:query")]）
+    - GET list?userId=xxx — 获取指定用户的模块权限（管理端调用，[ActionPermissionFilter(Permission = "odfusermodules:query")]）
+    - POST save — 批量保存用户模块权限（管理端调用，[ActionPermissionFilter(Permission = "odfusermodules:edit")]）
+    - _需求: 8.1, 8.2_
+  - [ ] 5.2 创建 OdfCheckinController（路由 business/OdfCheckin）
+    - POST submit — 提交签到记录（APP 端调用，[ActionPermissionFilter(Permission = "odfcheckin:list")]）
+    - GET list — 分页查询签到记录（管理端调用，[ActionPermissionFilter(Permission = "odfcheckin:list")]，联查机房名称和提交人）
+    - GET export — 导出签到记录（管理端调用，[ActionPermissionFilter(Permission = "odfcheckin:export")]）
+    - _需求: 2.6_
+  - [ ] 5.3 创建 OdfCablesController（路由 business/OdfCables）
+    - GET list — 光缆列表（[ActionPermissionFilter(Permission = "odfcables:list")]）
+    - GET search — 搜索光缆和故障（[ActionPermissionFilter(Permission = "odfcables:query")]）
+    - POST — 新增光缆（[ActionPermissionFilter(Permission = "odfcables:add")]）
+    - PUT — 修改光缆（[ActionPermissionFilter(Permission = "odfcables:edit")]）
+    - GET {id} — 光缆详情（[ActionPermissionFilter(Permission = "odfcables:query")]）
+    - POST delete/{id} — 删除光缆（[ActionPermissionFilter(Permission = "odfcables:delete")]）
+    - GET export — 导出光缆（[ActionPermissionFilter(Permission = "odfcables:export")]）
+    - _需求: 4.1, 4.4_
+  - [ ] 5.4 创建 OdfCableFaultsController（路由 business/OdfCableFaults）
+    - GET list — 故障列表分页查询（[ActionPermissionFilter(Permission = "odfcablefaults:list")]）
+    - GET {id} — 故障详情含图片（[ActionPermissionFilter(Permission = "odfcablefaults:query")]）
+    - POST add — 新增故障含图片上传（APP 端调用，[ActionPermissionFilter(Permission = "odfcablefaults:list")]）
+    - POST delete/{id} — 删除故障并级联删除图片（[ActionPermissionFilter(Permission = "odfcablefaults:delete")]）
+    - GET export — 导出故障列表（[ActionPermissionFilter(Permission = "odfcablefaults:export")]）
+    - _需求: 5.1, 6.1, 7.9_
+
+- [ ] 6. 后台 API：依赖注入注册
+  - 在 Startup / Program.cs 中注册所有新增 Service 的依赖注入
+    - IOdfCheckinService → OdfCheckinService
+    - IOdfCablesService → OdfCablesService
+    - IOdfCableFaultsService → OdfCableFaultsService
+    - IOdfCableFaultImagesService → OdfCableFaultImagesService
+    - IOdfUserModulesService → OdfUserModulesService
+    - _需求: 2.6, 4.1, 5.1, 7.9, 8.1_
+
+- [ ] 7. 检查点 — 后台 API 完成
+  - 确认所有 API 编译通过，依赖注入正确，如有问题请告知。
+
+- [ ] 8. 前端 APP：基础设施和服务层
+  - [ ] 8.1 创建 services/permission.js — 权限 API
+    - getUserModules()：GET /business/OdfUserModules/list，返回模块代码列表
+    - _需求: 8.2_
+  - [ ] 8.2 创建 services/checkin.js — 签到 API
+    - submitCheckin(data)：POST /business/OdfCheckin/submit
+    - _需求: 2.6_
+  - [ ] 8.3 创建 services/trunk.js — 干线版块 API
+    - getCableList(deptId)：GET /business/OdfCables/list
+    - getFaultList(cableId, pageNum, pageSize)：GET /business/OdfCableFaults/list
+    - getFaultDetail(id)：GET /business/OdfCableFaults/{id}
+    - addFault(formData)：POST /business/OdfCableFaults/add（multipart/form-data）
+    - searchCablesAndFaults(deptId, keyword)：GET /business/OdfCables/search
+    - _需求: 4.1, 5.1, 6.1, 7.9, 4.4_
+  - [ ] 8.4 扩展 store/index.js — 新增 modules 字段
+    - 添加 modules: [] 字段
+    - 添加 setModules(modules) 方法
+    - 在 clearAuth() 中清除 modules
+    - _需求: 8.2, 8.3_
+  - [ ] 8.5 创建 utils/navigation.js — 导航工具函数
+    - openNavigation(lat, lng, name)：安卓端弹出导航 APP 选择列表，H5 端打开地图网页
+    - _需求: 6.4, 6.5, 10.4_
+  - [ ]* 8.5.1 编写属性测试 Property 6：导航 URL 构建正确性
+    - **Property 6: 导航 URL 构建正确性**
+    - 使用 fast-check 生成随机经纬度和地点名，验证 URL 包含正确参数
+    - **验证: 需求 6.5, 10.4**
+  - [ ] 8.6 创建 utils/watermark.js — 水印处理工具函数
+    - addWatermark(imagePath, text)：Canvas 叠加水印文字到照片左下角
+    - _需求: 7.8_
+  - [ ]* 8.6.1 编写属性测试 Property 7：水印叠加参数正确性
+    - **Property 7: 水印叠加参数正确性**
+    - 使用 fast-check 生成随机时间和人员字符串，验证水印文本包含两者
+    - **验证: 需求 7.8**
+
+- [ ] 9. 前端 APP：登录页改造和功能入口页
+  - [ ] 9.1 修改 pages/login/index.vue — 登录成功后跳转至 pages/portal/index
+    - 将 uni.reLaunch 目标从 home 改为 portal
+    - 登录成功后调用 getUserModules() 获取权限并存入 store.modules
+    - _需求: 1.1, 8.2_
+  - [ ] 9.2 新建 pages/portal/index.vue — 功能入口列表页
+    - 自定义导航栏（刷新 + 标题"功能列表" + 设置图标）
+    - CSS Grid 2 列布局展示功能版块卡片（机房、干线）
+    - 根据 store.modules 过滤显示的入口卡片
+    - 点击机房 → navigateTo home，点击干线 → navigateTo trunk
+    - 空权限时显示空状态提示
+    - _需求: 1.1, 1.2, 1.3, 1.4, 1.5, 8.3, 8.4_
+  - [ ]* 9.2.1 编写属性测试 Property 1：权限过滤正确性
+    - **Property 1: 权限过滤正确性**
+    - 使用 fast-check 生成随机权限子集，验证过滤函数只返回有权限的版块
+    - **验证: 需求 1.1, 1.5, 8.3**
+  - [ ] 9.3 更新 pages.json — 注册所有新增页面
+    - 添加 portal、checkin、trunk、cable、fault-list、fault-detail、fault-add、trunk-search、route-plan 页面配置
+    - 所有页面 navigationStyle 设为 custom
+    - _需求: 1.1_
+
+- [ ] 10. 前端 APP：签到功能
+  - [ ] 10.1 改造 pages/rack/index.vue — 导航栏右侧添加签到按钮
+    - 将 nav-icon-placeholder 替换为蓝色【签到】按钮
+    - 点击签到按钮 → navigateTo checkin 页面，传递 roomId 参数
+    - _需求: 2.1, 2.2_
+  - [ ] 10.2 新建 pages/checkin/index.vue — 签到页
+    - 自定义导航栏 + 表单区域（人员输入、时间 picker、工作内容 textarea）
+    - 底部固定提交按钮
+    - 点击时间字段弹出 picker mode="date" 年月日选择器
+    - 提交校验必填项 → 调用 submitCheckin API → 成功 showToast + navigateBack
+    - 失败保留表单数据
+    - _需求: 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9_
+  - [ ]* 10.2.1 编写属性测试 Property 2：签到数据完整性（前端）
+    - **Property 2: 签到数据完整性（前端）**
+    - 使用 fast-check 生成随机签到数据，验证请求体包含所有必要字段
+    - **验证: 需求 2.6**
+
+- [ ] 11. 前端 APP：干线版块 — 公司列表和光缆列表
+  - [ ] 11.1 新建 pages/trunk/index.vue — 干线页（公司列表）
+    - 自定义导航栏 + section-title "公司列表"
+    - 复用 getCompanyList() 接口获取公司数据
+    - 公司卡片列表（白色背景 + 图片占位 + 公司名称居中）
+    - 点击公司卡片 → navigateTo cable 页面，传递 deptId
+    - _需求: 3.1, 3.2, 3.3_
+  - [ ] 11.2 新建 pages/cable/index.vue — 光缆列表页
+    - 自定义导航栏 + section-title "光缆列表" + 搜索栏
+    - 调用 getCableList(deptId) 获取光缆数据
+    - 光缆卡片列表（同公司卡片样式）
+    - 搜索栏输入关键词按确认 → navigateTo trunk-search 页面，传递 deptId 和 keyword
+    - 点击光缆卡片 → navigateTo fault-list 页面，传递 cableId 和 cableName
+    - _需求: 4.1, 4.2, 4.3, 4.4, 4.5_
+  - [ ]* 11.2.1 编写属性测试 Property 4：搜索范围限定（前端）
+    - **Property 4: 搜索范围限定（前端）**
+    - 使用 fast-check 生成随机 deptId 和关键词，验证搜索请求携带正确 deptId
+    - **验证: 需求 4.4**
+  - [ ]* 11.2.2 编写属性测试 Property 10：页面导航参数传递正确性
+    - **Property 10: 页面导航参数传递正确性**
+    - 使用 fast-check 生成随机列表项数据，验证导航 URL 包含正确参数
+    - **验证: 需求 3.3, 4.2, 5.2, 9.4, 9.5**
+
+- [ ] 12. 前端 APP：干线版块 — 故障管理
+  - [ ] 12.1 新建 pages/fault-list/index.vue — 故障列表页
+    - 自定义导航栏 + section-title "故障列表"
+    - 调用 getFaultList(cableId) 获取故障数据，支持分页加载（onReachBottom）
+    - 故障卡片列表（显示故障时间、故障原因、表显故障里程、所属光缆）
+    - 底部固定【新增故障】按钮
+    - 点击故障卡片 → navigateTo fault-detail，传递 faultId
+    - 点击新增故障 → navigateTo fault-add，传递 cableId 和 cableName
+    - _需求: 5.1, 5.2, 5.3, 5.4_
+  - [ ]* 12.1.1 编写属性测试 Property 3：故障记录渲染完整性
+    - **Property 3: 故障记录渲染完整性**
+    - 使用 fast-check 生成随机故障数据，验证渲染输出包含所有必要字段
+    - **验证: 需求 5.1, 6.1**
+  - [ ] 12.2 新建 pages/fault-detail/index.vue — 故障详情页
+    - 自定义导航栏 + 图片区域（横向滚动，点击预览）+ 信息展示区域
+    - 调用 getFaultDetail(faultId) 获取完整数据
+    - 展示所有字段：图片列表、故障时间、人员、故障原因、表显故障里程、所属光缆、地点、备注
+    - 底部【导航至地点】按钮（经纬度为空/0 时 v-if 隐藏）
+    - 点击图片 → uni.previewImage 全屏预览
+    - 点击导航 → 调用 openNavigation(lat, lng, name)
+    - _需求: 6.1, 6.2, 6.3, 6.4, 6.5, 6.6_
+  - [ ] 12.3 新建 pages/fault-add/index.vue — 新增故障页
+    - 自定义导航栏 + 拍照区域（横向滚动，仅相机拍摄）+ 表单区域
+    - 拍摄第 1 张照片时自动获取时间填充故障时间字段
+    - 自动填充所属光缆名称（从参数传入，不可编辑）
+    - 【点击获取当前经纬度】按钮 → uni.getLocation 获取位置
+    - 手动输入字段：人员、故障原因、表显故障里程、备注
+    - 提交流程：校验（至少 1 张照片）→ 水印处理 → 上传照片 → 提交表单
+    - 成功 showToast + navigateBack，失败保留数据
+    - _需求: 7.1, 7.2, 7.3, 7.4, 7.5, 7.6, 7.7, 7.8, 7.9, 7.10, 7.11, 7.12_
+  - [ ]* 12.3.1 编写属性测试 Property 8：故障提交数据完整性（前端）
+    - **Property 8: 故障提交数据完整性（前端）**
+    - 使用 fast-check 生成随机故障表单数据，验证请求体包含所有必要字段
+    - **验证: 需求 7.9**
+
+- [ ] 13. 前端 APP：搜索结果页
+  - [ ] 13.1 新建 pages/trunk-search/index.vue — 搜索结果页
+    - 自定义导航栏 + 搜索结果区域
+    - 页面 onLoad 从参数获取 deptId 和 keyword，调用 searchCablesAndFaults 接口
+    - 按「光缆」和「故障列表」两个分类展示结果
+    - 光缆分类：复用光缆卡片样式，点击 → navigateTo fault-list
+    - 故障分类：复用故障卡片样式，点击 → navigateTo fault-detail
+    - 无结果时显示"暂无搜索结果"
+    - _需求: 9.1, 9.2, 9.3, 9.4, 9.5_
+  - [ ]* 13.1.1 编写属性测试 Property 5：搜索结果分类正确性
+    - **Property 5: 搜索结果分类正确性**
+    - 使用 fast-check 生成随机搜索结果数据，验证分类展示逻辑正确
+    - **验证: 需求 9.2, 9.3**
+
+- [ ] 14. 前端 APP：路线规划（尝试性）
+  - [ ] 14.1 新建 pages/route-plan/index.vue — 路线规划页
+    - 集成地图 SDK（如高德地图 UniApp 插件）
+    - 输入起终点坐标，调用路线规划 API，展示路线总长度
+    - 输入距离值，计算路线上对应坐标并标注
+    - 地图 API 调用失败时提示用户
+    - _需求: 11.1, 11.2, 11.3, 11.4, 11.5_
+  - [ ]* 14.1.1 编写属性测试 Property 9：路线距离定位计算
+    - **Property 9: 路线距离定位计算**
+    - 使用 fast-check 生成随机路线点序列和距离值，验证定位计算正确
+    - **验证: 需求 11.3**
+
+- [ ] 15. 检查点 — 前端 APP 完成
+  - 确认所有新增页面正常渲染，页面跳转和参数传递正确，API 调用正常，如有问题请告知。
+
+- [ ] 16. 后台管理前端：API 层
+  - [ ] 16.1 创建 api/business/odfcables.js — 光缆管理 API
+    - listOdfCables / addOdfCables / updateOdfCables / getOdfCables / delOdfCables / exportOdfCables
+    - _需求: 4.1_
+  - [ ] 16.2 创建 api/business/odfcablefaults.js — 干线故障管理 API
+    - listOdfCableFaults / getOdfCableFaults / delOdfCableFaults / exportOdfCableFaults
+    - _需求: 5.1_
+  - [ ] 16.3 创建 api/business/odfcheckin.js — 签到记录管理 API
+    - listOdfCheckin / exportOdfCheckin
+    - _需求: 2.6_
+  - [ ] 16.4 创建 api/business/odfusermodules.js — 用户模块权限管理 API
+    - listUsers / getUserModules / saveUserModules
+    - _需求: 8.1_
+
+- [ ] 17. 后台管理前端：光缆管理页面
+  - [ ] 17.1 创建 views/business/OdfCables.vue — 光缆管理页面
+    - 查询表单（光缆名称 el-input + 所属部门 el-tree-select）
+    - 工具栏按钮（新增/编辑/删除/导出，v-hasPermi 权限控制）
+    - el-table 展示光缆列表（Id、光缆名称、所属部门、创建时间）
+    - 操作列：详情、编辑、删除
+    - 分页组件
+    - _需求: 4.1_
+  - [ ] 17.2 创建 components/business/OdfCableForm.vue — 光缆表单组件
+    - 支持 add / edit / view 三种模式
+    - 表单字段：光缆名称（必填）、所属部门（el-tree-select）
+    - v-model:visible 控制弹窗显隐，@success 回调刷新列表
+    - _需求: 4.1_
+  - [ ]* 17.2.1 编写属性测试 Property 16：光缆表单数据完整性
+    - **Property 16: 光缆表单数据完整性**
+    - 使用 fast-check 生成随机光缆名称和部门 ID，验证请求体字段完整
+    - **验证: 后台管理前端 — 光缆管理**
+
+- [ ] 18. 后台管理前端：干线故障管理页面
+  - [ ] 18.1 创建 views/business/OdfCableFaults.vue — 干线故障管理页面
+    - 查询表单（所属光缆 el-select 远程搜索 + 故障时间范围 el-date-picker + 故障原因 el-input）
+    - 工具栏按钮（删除/导出，无新增/编辑）
+    - el-table 展示故障列表（Id、故障时间、人员、故障原因、表显故障里程、所属光缆、地点、创建时间）
+    - 操作列：详情、删除
+    - 详情弹窗：el-dialog 展示完整故障信息 + 图片列表（el-image 支持预览放大）
+    - 分页组件
+    - _需求: 5.1, 6.1_
+  - [ ]* 18.1.1 编写属性测试 Property 17：管理端查询参数构建正确性
+    - **Property 17: 管理端查询参数构建正确性**
+    - 使用 fast-check 生成随机查询条件组合，验证 API 请求参数完整
+    - **验证: 后台管理前端 — 光缆管理、故障管理、签到记录管理**
+
+- [ ] 19. 后台管理前端：签到记录管理页面
+  - [ ] 19.1 创建 views/business/OdfCheckin.vue — 签到记录管理页面
+    - 查询表单（机房 el-select 远程搜索 + 人员 el-input + 签到时间范围 el-date-picker）
+    - 工具栏按钮（仅导出，无增删改）
+    - el-table 展示签到记录（Id、机房名称、人员、签到时间、工作内容、提交人、创建时间）
+    - 纯只读列表，无操作列
+    - 分页组件
+    - _需求: 2.6_
+
+- [ ] 20. 后台管理前端：用户模块权限管理页面
+  - [ ] 20.1 创建 views/business/OdfUserModules.vue — 用户模块权限管理页面
+    - 左右分栏布局（左侧 360px 用户列表 + 右侧模块权限配置）
+    - 左侧：搜索框 + el-table 用户列表，点击行高亮选中
+    - 右侧：标题"用户名 - 模块权限配置" + el-checkbox-group（odf/trunk/route）+ 保存按钮
+    - 页面加载调用 listUsers() 获取用户列表
+    - 点击用户 → 调用 getUserModules(userId) 填充 checkbox
+    - 保存 → 调用 saveUserModules(userId, modules) 批量更新
+    - v-hasPermi="['odfusermodules:edit']" 权限控制
+    - _需求: 8.1_
+  - [ ]* 20.1.1 编写属性测试 Property 18：用户列表前端搜索过滤
+    - **Property 18: 用户列表前端搜索过滤**
+    - 使用 fast-check 生成随机用户列表和关键词，验证过滤结果正确
+    - **验证: 后台管理前端 — 用户模块权限管理**
+  - [ ]* 20.1.2 编写属性测试 Property 19：用户模块权限保存数据构建
+    - **Property 19: 用户模块权限保存数据构建**
+    - 使用 fast-check 生成随机 userId 和模块子集，验证请求体正确
+    - **验证: 后台管理前端 — 用户模块权限管理**
+
+- [ ] 21. 后台管理前端：路由配置
+  - ZRAdmin 使用动态路由（从 sys_menu 读取 Component 字段自动生成路由），因此无需手动配置 Vue Router
+  - 任务 1.6 的菜单 SQL 脚本已配置 Component 指向对应 Vue 文件，执行后即可通过菜单访问
+  - 仅需确认 4 个 Vue 文件路径与菜单 Component 一致：
+    - business/OdfCables → views/business/OdfCables.vue
+    - business/OdfCableFaults → views/business/OdfCableFaults.vue
+    - business/OdfCheckin → views/business/OdfCheckin.vue
+    - business/OdfUserModules → views/business/OdfUserModules.vue
+  - _需求: 8.1_
+
+- [ ] 22. 最终检查点 — 全部完成
+  - 确认所有功能模块正常工作：数据库表、后台 API、前端 APP 页面、后台管理前端页面
+  - 确认菜单权限 SQL 脚本已执行，后台管理页面可通过菜单访问
+  - 确认所有测试通过，如有问题请告知。
+
+## 备注
+
+- 标记 `*` 的任务为可选测试任务，可跳过以加快 MVP 进度
+- 每个任务引用了对应的需求编号，确保需求可追溯
+- 检查点任务用于阶段性验证，确保增量交付质量
+- 属性测试验证系统的通用正确性属性
+- 单元测试验证具体示例和边界情况
+- 任务 1.6（菜单权限 SQL 脚本）是后台管理前端正常运行的前提，务必不要遗漏
diff --git a/sql/v1.0.2/menu_permissions.sql b/sql/v1.0.2/menu_permissions.sql
new file mode 100644
index 0000000..e69de29