# 城市生命线 — 项目目录结构说明

```
city-life-line/                      # 城市生命线 — 地下管网管控平台
├── 📄 .env.development              # 开发环境变量（端口代理、API地址等）
├── 📄 .env.production               # 生产环境变量
├── 📄 .env.staging                  # 预发布环境变量
├── 📄 .gitignore                    # Git 忽略规则
├── 📁 .idea/                        # JetBrains IDE 配置（自动生成）
├── 📁 .vscode/                      # VSCode 编辑器配置
├── 📄 index.html                    # 应用入口 HTML 文件
├── 📄 LICENSE                       # MIT 开源许可证
├── 📄 README.md                     # 项目说明文档
├── 📄 package.json                  # 项目依赖 & 脚本定义
├── 📄 package-lock.json             # 依赖版本锁定文件
├── 📄 uno.config.js                 # UnoCSS 原子化 CSS 配置
├── 📄 vite.config.js                # Vite 构建配置（代理、别名、端口等）
│
├── 📁 bin/                          # 构建/打包/运行脚本
│   ├── build.bat                    # 构建命令
│   ├── package.bat                  # 打包命令
│   └── run-web.bat                  # 一键启动 Web 服务
│
├── 📁 html/                         # 静态 HTML 资源
│   └── ie.html                      # IE 浏览器兼容提示页
│
├── 📁 public/                       # 静态资源（直接复制到输出目录）
│   ├── favicon.ico                  # 网站图标
│   └── logo.png                     # Logo 图片
│
├── 📁 vite/                         # Vite 插件配置
│   └── plugins/                     # 自定义 Vite 插件代码
│
└── 📁 src/                          # 源代码主目录 ⭐
    ├── 📄 App.vue                   # Vue 根组件
    ├── 📄 main.js                   # 应用入口（挂载 Vue、注册插件/指令）
    ├── 📄 permission.js             # 路由权限守卫（登录拦截、动态路由）
    ├── 📄 settings.js               # 全局设置参数
    │
    ├── 📁 api/                      # 接口层（按模块拆分）
    │   ├── login.js                 # 登录/注册/验证码接口
    │   ├── menu.js                  # 菜单接口
    │   ├── dispatch.js              # 应急调度模块接口
    │   ├── drainage.js              # 排水系统模块接口
    │   ├── monitor/                 # 监控管理接口
    │   │   ├── cache.js             # 缓存监控
    │   │   ├── job.js               # 定时任务
    │   │   ├── jobLog.js            # 任务日志
    │   │   ├── logininfor.js        # 登录日志
    │   │   ├── online.js            # 在线用户
    │   │   ├── operlog.js           # 操作日志
    │   │   └── server.js            # 服务器监控
    │   ├── pipeNetwork/             # 管网模块接口
    │   │   ├── basic.js             # 管网基础数据
    │   │   ├── gasMonitor.js        # 燃气监测
    │   │   ├── hazard.js            # 隐患管理
    │   │   └── pdeviceInform.js     # 设备信息
    │   ├── smxyjldczxt/             # 应急指挥系统接口
    │   │   └── yjxxfb/
    │   │       ├── dbyj.js          # 待办预警
    │   │       └── yjfb.js          # 预警发布
    │   ├── system/                  # 系统管理接口
    │   │   ├── config.js            # 参数配置
    │   │   ├── dept.js              # 部门管理
    │   │   ├── dict/                # 字典管理
    │   │   │   ├── data.js          # 字典数据
    │   │   │   └── type.js          # 字典类型
    │   │   ├── menu.js              # 菜单管理
    │   │   ├── notice.js            # 公告管理
    │   │   ├── post.js              # 岗位管理
    │   │   ├── role.js              # 角色管理
    │   │   └── user.js              # 用户管理
    │   ├── tool/                    # 代码生成工具接口
    │   │   └── gen.js
    │   └── work/                    # 工单接口
    │       └── order.js
    │
    ├── 📁 assets/                   # 静态资源（会经 Vite 编译处理）
    │   ├── 401_images/              # 401 无权限页插图
    │   ├── 404_images/              # 404 页面插图
    │   ├── icons/svg/               # SVG 图标（通过 SvgIcon 组件使用）
    │   ├── images/                  # 通用图片（含登录背景图）
    │   ├── logo/                    # Logo 资源
    │   ├── portal/                  # 门户大屏资源
    │   └── styles/                  # 全局样式
    │       ├── index.scss           # 样式入口（汇总引入）
    │       ├── variables.module.scss # SCSS 变量
    │       ├── mixin.scss           # SCSS 混入
    │       ├── transition.scss      # 过渡动画样式
    │       ├── element-ui.scss      # Element Plus 覆盖样式
    │       └── sidebar.scss         # 侧边栏样式
    │
    ├── 📁 components/               # 公共组件
    │   ├── Breadcrumb/              # 面包屑导航
    │   ├── Crontab/                 # Cron 表达式配置器（年/月/周/日/时/分/秒）
    │   ├── DictTag/                 # 字典标签
    │   ├── Editor/                  # 富文本编辑器（Quill）
    │   ├── FileUpload/              # 文件上传
    │   ├── Hamburger/               # 汉堡菜单（侧边栏折叠）
    │   ├── HeaderSearch/            # 头部搜索
    │   ├── IconSelect/              # 图标选择器
    │   ├── ImagePreview/            # 图片预览
    │   ├── ImageUpload/             # 图片上传
    │   ├── Pagination/              # 分页组件
    │   ├── ParentView/              # 父级视图容器
    │   ├── RightToolbar/            # 右侧工具栏
    │   ├── RuoYi/                   # 若依框架辅助（文档/代码仓库链接）
    │   ├── Screenfull/              # 全屏切换
    │   ├── SizeSelect/              # 字号选择
    │   ├── SvgIcon/                 # SVG 图标组件
    │   ├── TopNav/                  # 顶部导航
    │   ├── TreeSelect/              # 树形选择器
    │   └── iFrame/                  # 内嵌 iframe 组件
    │
    ├── 📁 directive/                # 自定义指令
    │   ├── index.js                 # 指令注册入口
    │   ├── common/copyText.js       # v-copyText：一键复制文本
    │   └── permission/              # 权限指令
    │       ├── hasPermi.js          # v-hasPermi：按钮级权限控制
    │       └── hasRole.js           # v-hasRole：角色级权限控制
    │
    ├── 📁 layout/                   # 布局组件
    │   ├── index.vue                # 布局主框架
    │   └── components/
    │       ├── AppMain.vue          # 主内容区
    │       ├── Navbar.vue           # 顶部导航栏
    │       ├── Settings/            # 布局设置面板（主题/固定头部等）
    │       ├── Sidebar/             # 侧边栏菜单
    │       │   ├── index.vue        # 侧边栏主体
    │       │   ├── Logo.vue         # 侧边栏 Logo
    │       │   ├── Link.vue         # 外链菜单项
    │       │   └── SidebarItem.vue  # 菜单项组件
    │       ├── TagsView/            # 标签页视图
    │       ├── IframeToggle/        # iframe 切换
    │       └── InnerLink/           # 内部链接
    │
    ├── 📁 plugins/                  # 工具插件
    │   ├── index.js                 # 插件注册入口
    │   ├── auth.js                  # 权限认证辅助
    │   ├── cache.js                 # 前端缓存（sessionStorage/localStorage）
    │   ├── download.js              # 文件下载
    │   ├── modal.js                 # 模态框封装
    │   └── tab.js                   # 标签页操作
    │
    ├── 📁 router/                   # 路由配置
    │   └── index.js                 # 路由定义（公共路由 + 动态路由）
    │
    ├── 📁 store/                    # Pinia 状态管理
    │   ├── index.js                 # Store 注册入口
    │   └── modules/
    │       ├── app.js               # 应用全局状态（侧边栏/设备/尺寸）
    │       ├── dict.js              # 字典缓存状态
    │       ├── permission.js        # 权限菜单状态
    │       ├── settings.js          # 布局设置状态
    │       ├── tagsView.js          # 标签页状态
    │       └── user.js              # 用户信息/登录/token 状态
    │
    ├── 📁 utils/                    # 工具函数
    │   ├── index.js                 # 通用工具函数
    │   ├── auth.js                  # Token 存取操作
    │   ├── request.js               # Axios 封装（拦截器/防重复提交）
    │   ├── coordTransform.js        # 坐标系转换工具
    │   ├── dict.js                  # 字典翻译工具
    │   ├── dynamicTitle.js          # 动态页面标题
    │   └── errorCode.js             # HTTP 错误码映射
    │
    └── 📁 views/                    # 页面视图
        ├── index.vue                # 系统首页（仪表盘）
        ├── login.vue                # 登录页
        ├── register.vue             # 注册页
        ├── error/                   # 错误页面
        │   ├── 401.vue              # 401 无权限
        │   └── 404.vue              # 404 页面不存在
        ├── redirect/                # 重定向中转页
        │   └── index.vue
        ├── portal/                  # 门户大屏首页
        │   └── index.vue
        ├── monitor/                 # 监控管理
        │   ├── cache/               # 缓存监控
        │   ├── druid/               # 数据库连接池监控
        │   ├── job/                 # 定时任务管理
        │   ├── logininfor/          # 登录日志
        │   ├── online/              # 在线用户
        │   ├── operlog/             # 操作日志
        │   └── server/              # 服务器状态监控
        ├── system/                  # 系统管理（用户/角色/菜单/字典/公告/部门/岗位）
        ├── tool/                    # 代码生成工具
        └── subSystem/               # 业务子系统 ⭐
            ├── basic/               # 管网基础设施
            │   ├── GisDashboard     # GIS 仪表盘总览
            │   ├── PipeNetwork      # 管网管理
            │   ├── PointManage      # 管点管理
            │   ├── Manhole          # 井盖管理
            │   ├── Equipment        # 设备管理
            │   ├── EquipmentAbnormal # 设备异常
            │   ├── GasPipePoint     # 燃气管点关联
            │   ├── BusinessWorkOrder # 业务工单
            │   └── RepairRecord     # 维修记录
            ├── alarm/               # 告警模块
            │   ├── AlarmList        # 告警列表
            │   └── AlarmMap         # 告警地图
            ├── gas/                 # 燃气管网系统
            │   ├── gasBasicadata/   # 基础数据（管网/设备）
            │   ├── gasfxpg/         # 风险评估
            │   ├── gashiddendanger/ # 隐患排查
            │   ├── gasMonitor/      # 燃气监测
            │   ├── gasWorkOrder/    # 燃气工单
            │   └── gasHome/         # 燃气首页
            ├── drainage/            # 排水系统
            │   ├── home             # 排水首页
            │   ├── jcsj/            # 基础数据（管网/泵站/设备/检查井）
            │   ├── jcyj/            # 监测预警（流量/液位+GIS）
            │   ├── spjc/            # 视频监测（GIS/播放/管理）
            │   ├── jcbj/            # 监测报警（四级处置流程）
            │   ├── fxpg/            # 风险评估
            │   └── DrainageWorkOrder # 排水工单
            ├── dispatch/            # 应急指挥调度
            │   ├── dishome          # 调度首页
            │   ├── disOnDuty/       # 值班管理（事故/故障/监督/值班表）
            │   ├── disPlanManage/   # 预案管理（编辑/审批/分级）
            │   ├── disExerciseMan/  # 模拟演练（模拟/实战/课程/规划）
            │   ├── disDecisionDep/  # 辅助决策（方案/路线/可视化）
            │   └── disAssess/       # 总结评估（查询/分析/汇总）
            └── cityLifeline/        # 城市生命线总览大屏
```

---

## 项目概况

| 项目 | 说明 |
|------|------|
| **框架** | Vue 3.4 + Vite 5.3 |
| **UI 库** | Element Plus 2.7 |
| **状态管理** | Pinia |
| **CSS 方案** | UnoCSS（原子化）+ SCSS |
| **地图** | Leaflet + 百度地图 WebGL |
| **图表** | ECharts 5 |
| **HTTP 请求** | Axios（Token 注入、防重复提交、错误统一处理） |
| **鉴权** | JWT + 路由权限守卫 + 按钮级指令控制 |
| **基础框架** | 基于 RuoYi-Vue 改造 |
| **业务领域** | 城市地下管网管控（燃气/排水/供水 + 应急指挥调度） |

## 子系统模块

| 模块 | 路径 | 说明 |
|------|------|------|
| 管网基础 | `subSystem/basic/` | 管网/管点/井盖/设备管理 + GIS 仪表盘 |
| 告警管理 | `subSystem/alarm/` | 告警列表 + GIS 地图告警 |
| 燃气管网 | `subSystem/gas/` | 基础数据/风险评估/隐患/监测/工单 |
| 排水系统 | `subSystem/drainage/` | 基础数据/监测预警/视频监测/报警/风险评估/工单 |
| 应急调度 | `subSystem/dispatch/` | 值班/预案/演练/决策/评估 |
| 生命线总览 | `subSystem/cityLifeline/` | 城市生命线大屏总览 |
