# Road.NetCore_1
**Repository Path**: shikehui123/Road.NetCore_1
## Basic Information
- **Project Name**: Road.NetCore_1
- **Description**: 本项目旨在构建“教、学、研、用“一体化的公路养护管理平台，底层基于Vue.NetCore开源快速开发框架，严格遵循MIT开源协议，确保零法律风险地应用于高校教学、企业实训及科研创新。通过引入优秀开源框架，本项目将师生从重复编码中解放出来，专注于公路养护的智能化算法创新与业务模式探索。预期成果包括一套可运行的软硬件系统、系列化教学案例库及支撑课题开展的科研平台，打造交通信息化领域产教融合的标杆范例。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 64
- **Created**: 2026-03-26
- **Last Updated**: 2026-03-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
<<<<<<< HEAD
=======
# Road.NetCore
## 基于 Vue.NetCore 开源项目的公路养护管理系统开发与运维教学科研项目建设方案。
- 利用原框架的代码生成器、前后端分离、信创支持、快速扩展等核心优势，将其转化为教学与科研。
- —— 基于 Vue.NetCore (MIT协议) 开源架构
## 项目背景与概述
- 随着交通强国战略的推进，公路养护管理正向数字化、智能化转型。本项目旨在构建一个“教、学、研、用”一体化的公路养护管理平台。
- 项目底层采用 Vue.NetCore 开源快速开发框架（遵循 MIT 开源协议），该技术栈具备前后端分离、支持信创环境、拥有强大的代码生成器等特性。
- 通过引入真实的公路养护业务场景（基础信息、检测、任务、计划、决策）
- 本项目不仅是一个管理软件，更是一个适用于高校计算机/交通专业教学、企业运维实训及科研算法验证的综合平台。
## 技术架构与选型
- 本项目严格遵循原框架的技术体系，确保技术的先进性与生态的完整性。
## 2.1 核心架构
- 开发模式：前后端分离 (Frontend/Backend Separation)
- 开源协议：MIT License (允许自由使用、修改、分发，甚至用于商业闭源项目，极大降低教学与科研的法律风险)
## 后端核心：
- .NET 8.0：最新长期支持版本，高性能跨平台。 - ORM 框架：支持 EF Core 8.0 与 SqlSugar (双版本适配，适合对比教学)。
- 其他组件：JWT (认证), SignalR (实时消息), Quartz.Net (定时任务), Autofac (依赖注入), Dapper (高性能查询)。
- 数据库：支持 SQLServer, MySQL, PostgreSQL, Oracle (全面支持信创数据库如达梦、人大金仓等)。
## 前端核心：
- 框架：Vue 3 + Vite + TypeScript。
- UI 库：Element Plus。
- 状态管理：Vuex/Pinia。
- 移动端：Uniapp (支持小程序/H5/App，实现养护外业移动化)。
## 2.2 特色技术亮点（教学/科研价值点）
## 全自动代码生成器：
- 支持主从表（一对一、一对多）前后端代码一键生成。
- 教学应用：学生可直观理解 MVC 模式、API 接口定义及前端组件化开发，将重复性编码时间减少 90%，专注于业务逻辑。
## 低代码扩展能力：
- 基于Vue.NetCore 开源项目提供的扩展方法，支持在生成代码基础上进行自定义业务扩展。
- 科研应用：研究人员可快速搭建原型，将精力集中在“养护决策算法”、“路况预测模型”等核心科研点上，而非基础 CRUD。
## 信创适配能力：
- 原生支持国产操作系统与数据库，符合国家对交通行业软件自主可控的要求。
## 系统功能模块设计
- 基于公路养护全生命周期，设计以下核心模块，所有模块均利用框架的代码生成器快速构建：
- 模块分类 功能子项 技术实现与教学点
- 公路基础信息管理 路线档案、桥梁隧道台账、沿线设施、GIS 地图可视化
- 树形结构配置：学习无限级树形数据加载；
- GIS 集成：结合百度/高德地图 API 进行路段标注。
## 公路检测管理
- 日常巡查、定期检测、特殊检测、病害录入、PCI/RQI 计算
- 移动端协同：利用 Uniapp 实现外业人员现场拍照上传；数据导入导出：学习 Excel 批量处理与数据校验。
## 养护任务管理
- 任务派发、进度跟踪、完工验收、电子签名 工作流引擎：基于框架的审批流程配置，学习状态机与流程控制；SignalR 实时推送：任务状态变更实时通知。
## 养护计划管理
- 年度计划编制、资金预算、月度分解、计划调整 图表统计：利用 ECharts 实现资金执行率、计划完成率的可视化；
- 复杂表单：主子表（计划头/明细）的联动编辑。
## 养护决策支持
- 路况趋势分析、养护对策推荐、资金优化分配模型
- 科研接口：预留 Python/算法模型接口，展示科研算法如何嵌入工程系统；大数据看板：多维度数据钻取分析。
## 系统运维管理
- 用户权限、角色管理、日志审计、代码生成配置
- RBAC 模型：深入理解基于角色的权限控制；系统监控：学习 JWT 令牌机制与接口安全。
## 教学与科研应用场景
## 4.1 教学实训场景 (Teaching & Training)
## 全栈开发课程：
- 初级：使用代码生成器在 10 分钟内构建一个“病害录入”模块，理解前后端数据交互。
- 中级：在生成的代码上编写自定义逻辑（如：当 PCI 指数低于 60 时自动触发预警），掌握 .NET 8 业务扩展。
- 高级：开发移动端 Uniapp 应用，实现扫码巡检，掌握跨平台开发技术。
## DevOps 运维实践：
- 利用框架的 Docker 部署能力，学生在 Linux (信创环境) 上搭建 CI/CD 流水线，完成从代码提交到自动部署的全过程。
## 数据库课程设计：
- 对比 EF Core 与 SqlSugar 在不同数据库（MySQL vs PostgreSQL）下的性能差异与配置方法。
## 4.2 科研项目支撑 (Research Support)
## 算法落地验证平台：
- 科研人员无需从零开发系统，可直接在本系统中集成“基于 AI 的路面裂缝识别算法”或“遗传算法优化的养护资金分配模型”，快速验证算法的工程实用性。
行业大数据分析：
- 基于系统积累的海量养护数据，开展路况衰减规律研究、预防性养护时机研究等课题。
## 信创迁移研究：
- 研究系统在国产数据库（如达梦）与国产操作系统上的适配性、性能瓶颈及优化策略，形成科研论文或技术报告。
## 项目实施与运维规划
## 5.1 开发阶段
- 环境搭建：部署 .NET 8 SDK, VS2022, Node.js, 数据库。
- 模型设计：设计公路、桥梁、任务等数据库表结构。
- 代码生成：使用框架内置生成器，配置 30+ 属性，一键生成前后端代码。
- 业务扩展：针对养护特有的计算逻辑（如 PQI 指数计算）编写 C# 扩展代码。
- 移动端开发：同步生成 Uniapp 代码，定制外业巡检界面。
## 5.2 运维与部署
- 容器化部署：提供 Dockerfile 与 docker-compose 脚本，支持一键部署至服务器或云端。
- 多环境管理：利用框架配置中心，轻松切换 开发/测试/生产 环境及数据库连接。
- 安全加固：开启 JWT 令牌刷新机制，配置接口访问频率限制，启用操作日志审计。
## 开源协议说明 (MIT)
- 本项目基于 Vue.NetCore 框架开发，遵循 MIT 开源协议。
- 自由度：允许师生及研究人员免费使用、复制、修改、合并、出版发行、散布、再授权及贩售软件副本。
- 免责条款：软件按“原样”提供，不提供任何形式的担保。
- 价值：MIT 协议最大限度地消除了法律障碍，使得该项目可以无障碍地应用于高校教学案例、学生毕业设计、科研课题原型以及校企合作项目中
## 预期成果
- 一套可运行的系统：包含 PC 端管理后台与移动端巡检小程序。
- 一系列教学案例：涵盖从数据库设计到前端可视化的完整视频教程与实验指导书。
- 科研支撑平台：支持至少 2-3 项省部级以上交通信息化相关课题的算法验证与数据支撑。
- 信创示范工程：形成一份完整的交通行业软件国产化适配报告。
## 结语：
- 本项目不仅仅是一个软件系统的开发，更是一次将工业级开源框架引入教育科研领域的创新实践。
- 通过 Vue.NetCore 强大的生产力，我们将把师生从重复的“造轮子”工作中解放出来，真正聚焦于公路养护的业务逻辑创新与核心算法研究。
## Vue + .Net8前后端分离，不一样的快速开发框架(支持信创)
## 框架核心
- 快速开发(基础功能全部由代码生成器生成)
- 支持前端、后台自定义业务代码扩展,后台提供了大量常用扩展与通用类
- 前端、后台提供了近300个扩展方法与属性,开发人员可在此功能上编写扩展自定义业务代码
- 代码生成(代码生成器可直接生成主/从表前后端业务代码,有30多种属性可在线配置生成的代码)
- 前端table自动转换key/value
- 前端表单select/checkbox自动绑定数据源,不需要写任何代码
- 支持(主从表)一对一前后端代码全自动生成、并支持数据源自动绑定与业务代码扩展,不需要写任何代码
- 支持一对多从表自定义扩展(不限从表类型与从表数量) , 一对多从表使用扩展可轻松实现
- 如果能上手框架，可以体会到不用996,更不用掉头发的感觉^_^
## 框架适用范围
- 前后端分离项目
- 编写各种后台restful api接口。后台基础代码由代码生成器完成,在生成的代码上继续编写业务即可
- 前端表单开发(直接上手看demo即可)
- 配合app做H5或全h5开发
- 移动端开发、app、微信小程序(uniapp)，见下面介绍
- 在现有的代码生成器功能上，继续定制开发代码生成器功能,解决重复性工作
## 框架开发依赖环境
- 后台：VS2022 、.Net8、EFCor8.0、SqlSugar、JWT、Dapper、SignalR、Quartz.Net、Autofac、SqlServer/MySql/PGSql/Oracle、Redis
- 前端：VsCode、Vue2/vue3、Vite、TypeScript、vuex、axios、promise、element ui、element plus
## 链接
## [vol框架视频](https://www.cctalk.com/m/group/90268531)
## [vol框架企业版](http://pro.volcore.xyz/)
## [NET视频教程(微软MVP-ACE录制)](https://space.bilibili.com/525836469)
## [元讯趣编程交流社区](https://www.qubcedu.com/)
## [易软通开源免费openWMS系统](https://gitee.com/yiruantong/open-wms)
## [旧版本代码已迁移至仓库](https://gitee.com/x_discoverer/vol_v3)
#### 框架文档
vue3版本: [http://www.volcore.xyz](http://www.volcore.xyz)
vue2版本: [http://v2.volcore.xyz/document/guide](http://v2.volcore.xyz/document/guide)
App、H5、微信小程序: [http://app.volcore.xyz/](http://app.volcore.xyz/)
#### 2023.10增加sqlsugar适配
不是简单的增加sqlsugar而是重写后台，增加框架后台sqlsugar版本并独立维护
sqlsugar: [https://www.donet5.com/](https://www.donet5.com/)
## 框架移动端（uniapp）已发布,同样全自动生成代码,扫描小程序二维码即可查看
## 1、标准页面
整个页面所有前后端代码，全部由代码生成器界面上配置生成，并支持并后端业务代码扩展
## 2、主子表页面
同样由代码生成器自动生成，零代码实现整个页面主子表的新建、编辑、删除、查询、导入、导出功能
主子表编辑页面
## 3、审批流程配置
## 4、数据审批
## 5、树形结构
只需少量配置即可完成树形结构配置编辑，按层级加载数据等功能
## 6、图表统计
框架提供了丰富的图表统计，能复制就能开发
其他功能。。。。。
## 框架预览
- 框架内置了大量的通用组件可直接使用,并内置了基于本框架定制开发的代码生成器，尽量避免重复性代码编写。
- 框架不仅仅是快速开发，更多的是倾向于业务代码扩展的编写与代码规范。
- 如果有什么问题或建议，提issue或加QQ：283591387
- QQ3群：743852316(已满)
- QQ4群：959924606
-
- vue3地址：http://www.volcore.xyz
- vue2地址：http://v2.volcore.xyz
- 帐号：admin666密码：123456（本地超级管理员帐号：admin密码123456)
- github地址：https://github.com/cq-panda/vue.netcore
- gitee码云：https://gitee.com/x_discoverer/Vue.NetCore
- 框架文档：http://v2.volcore.xyz/document/guide
- 框架更新日志：http://v2.volcore.xyz/document/log