# 城市生命线 — 项目目录结构说明 ``` 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/` | 城市生命线大屏总览 |