index.md 2.9 KB

城市生命线项目记忆索引

项目概况

  • 项目:城市生命线 — 地下管网管控平台
  • 前端:Vue 3.4、Vite 5.3、Element Plus、Pinia、UnoCSS、SCSS
  • 基础框架:RuoYi-Vue 3.8.8 改造
  • 业务领域:地下管网、燃气、排水、供水、告警、风险和应急指挥调度

关键入口

  • 应用入口:src/main.js
  • 根组件:src/App.vue
  • 路由守卫:src/permission.js
  • 路由定义:src/router/index.js(总后台默认落地页常量 DEFAULT_BACKEND_HOME = '/system/user',写死的首页菜单已移除)
  • 动态权限路由:src/store/modules/permission.js
  • Axios 封装:src/utils/request.js
  • Vite 配置:vite.config.js
  • 环境变量:.env.development.env.staging.env.production

运行方式

cd E:\city-life-line
npm install       # 首次运行或依赖变化时执行
npm run dev       # 默认 http://localhost:80

开发环境 /dev-api 代理到本机 8300/pipe 后端;如果 80 端口不可用,可运行 npm run dev -- --port 5173。不要依赖 bin/run-web.bat 的 Yarn 命令,当前项目以 npm 和 package-lock.json 为准。

业务模块

当前源码实际包含 basicalarmgasdrainagedispatchcityLifelinewaterSupplymanholeCoverpipeNetworklifeCompanyriskhidden 等模块。

当前已知风险

  • 业务菜单主要由后端 /getRouters 动态下发,前端常量路由不包含完整业务树。
  • 门户页退出曾误调 userStore.logout()(Store 实际方法名为 logOut()),已修正为与 Navbar 一致的 logOut() + location.href = '/login' 整页跳转。
  • 供水 19 个页面已按 5.3.2 文档命名补齐并接入后端接口,包含设施 CRUD、设备、监测、报警、统计和轻量 GIS;部署菜单仍依赖后端 sys_menu 与角色授权。
  • 排水报警详情 API 请求 /api/alarm/{id},后端实际路径为 /api/alarm/getById/{id}
  • 若干排水请求设置 X-Silent-Error,但 Axios 拦截器未处理该标志。
  • 百度地图 AK 仍由 index.html 直接配置,环境变量未形成统一生效入口。
  • package.json 没有测试、Lint 或类型检查脚本。

长期记忆

会话记录