# WebPlugins

**Repository Path**: shend/WebPlugins

## Basic Information

- **Project Name**: WebPlugins
- **Description**: WebPlugins is a modular and pluggable application framework based on ASP.NET Core and VUE. By completely decoupling core logic from functional components, it enables secondary development.
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://opensource.ganweicloud.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-16
- **Last Updated**: 2025-06-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: JavaScript, IOT, Vue, dotNET, industrial-iot

## README

<p align="left" dir="auto">
  <a href="https://opensource.ganweicloud.com" rel="nofollow">
    <img width="130" height="130" src="./src/logo.jpg">
  </a>
</p>

[![GitHub license](https://camo.githubusercontent.com/5eaf3ed8a7e8ccb15c21d967b8635ac79e8b1865da3a5ccf78d2572a3e10738a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f646f746e65742f6173706e6574636f72653f636f6c6f723d253233306230267374796c653d666c61742d737175617265)](https://gitee.com/shend/WebPlugins/blob/master/LICENSE) ![https://v2.vuejs.org/](https://img.shields.io/badge/Vue-3.5.13-%2394c20c?labelColor=#94c20c) ![https://www.webpackjs.com](https://img.shields.io/badge/vite-4.5.5-%234ec428?labelColor=#5a5a5a) ![https://www.axios-http.cn/docs/intro](https://img.shields.io/badge/Axios-1.7.9-%2397c424?labelColor=#5a5a5a) ![https://next.router.vuejs.org](https://img.shields.io/badge/vueRouter-4.5.0-%23d6604a?labelColor=#5a5a5a) ![https://element.eleme.io/#/zh-CN](https://img.shields.io/badge/ElementUI-2.9.1-%23097abb?labelColor=#5a5a5a) ![](https://img.shields.io/badge/join-discord-infomational)

WebPlugins 是一个基于ASP.NET Core和VUE的模块化和插件化应用程序框架，基于松耦合、高内聚的设计理念，构建了一个可扩展、易维护的应用框架，通过将核心逻辑与功能组件完全解耦，可进行二次开发

# Source Code Structure
```bash
|-- IoTCenter.Build # 统一包管理解决方案
|-- IoTCenter.HostProxies # 代理服务库
|   |-- IoTCenterHost.Protos # 代理服务接口定义库
|   |-- IoTCenterHost.Proxy # 代理服务接口调用
|-- IoTCenter.Infrastructure # 基础服务解决方案
|   |-- IoTCenter.Data # 数据访问层
|   |-- IoTCenter.Utilities # 基础帮助库
|   |-- IoTCenterCore # 模块化基础服务库
|   |-- IoTCenterCore.Abstractions # 模块化基础服务库
|   |-- IoTCenterCore.Abstractions.Application # 模块化基础服务库
|   |-- IoTCenterCore.AutoMapper # AutoMapper封装库
|   |-- IoTCenterCore.DeviceDetection # 登录设备检测库
|   |-- IoTCenterCore.DynamicCache # 动态缓存服务
|   |-- IoTCenterCore.DynamicCache.Abstractions # 动态缓存服务抽象
|   |-- IoTCenterCore.ExcelHelper # Excel导入导出服务库
|   |-- IoTCenterCore.Hei.Captcha # 图片验证码库
|   |-- IoTCenterCore.RsaEncrypt # RSA加解密库
|   |-- IoTCenterCore.SelfSignedCertificate # Linux自签名库
|   |-- IoTCenterCore.SlideVerificationCode # 滑动验证码库
|   |-- IoTCenterWebApi.BaseCore
|-- IoTCenter.Modules # 插件解决方案
|   |-- Ganweisoft.IoTCenter.Module.EquipConfig # 设备管理
|   |-- Ganweisoft.IoTCenter.Module.EquipLink # 设备联动
|   |-- Ganweisoft.IoTCenter.Module.EquipList # 设备列表
|   |-- Ganweisoft.IoTCenter.Module.Event # 事件查询
|   |-- Ganweisoft.IoTCenter.Module.LogManage # 日志管理
|   |-- Ganweisoft.IoTCenter.Module.Login # 登录
|   |-- Ganweisoft.IoTCenter.Module.RealTime # 实时快照
|   |-- Ganweisoft.IoTCenter.Module.SignalR # SignalR实时推送
|   |-- Ganweisoft.IoTCenter.Module.TimeTask # 定时任务
|-- IoTCenter.WindowsServices # Windows服务注册解决方案
|   |-- IoTCenterWeb.Daemon
|   |-- IoTCenterWebApi.StartUp
|-- IoTCenterWebApi # Web入口
|-- Shared # Web统一配置
````

## [前端开发指南](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end)
- [1. 环境配置与项目初始化](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#1-%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE%E4%B8%8E%E9%A1%B9%E7%9B%AE%E5%88%9D%E5%A7%8B%E5%8C%96)
  - [1.1 开发环境搭建](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#11-%E5%BC%80%E5%8F%91%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA)
  - [1.2 项目架构解析](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#12-%E9%A1%B9%E7%9B%AE%E6%9E%B6%E6%9E%84%E8%A7%A3%E6%9E%90)

- [2. 子应用开发规范](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#2-%E5%AD%90%E5%BA%94%E7%94%A8%E5%BC%80%E5%8F%91%E8%A7%84%E8%8C%83)
  - [2.1 模板工程体系](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#21-%E6%A8%A1%E6%9D%BF%E5%B7%A5%E7%A8%8B%E4%BD%93%E7%B3%BB)
  - [2.2 菜单系统配置](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#22-%E8%8F%9C%E5%8D%95%E7%B3%BB%E7%BB%9F%E9%85%8D%E7%BD%AE)
  - [2.3 业务代码开发规范](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#23-%E4%B8%9A%E5%8A%A1%E4%BB%A3%E7%A0%81%E5%BC%80%E5%8F%91%E8%A7%84%E8%8C%83)
  - [2.4 启动流程说明](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#24-%E5%90%AF%E5%8A%A8%E6%B5%81%E7%A8%8B%E8%AF%B4%E6%98%8E)

- [3. 界面主题系统](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#3-%E7%95%8C%E9%9D%A2%E4%B8%BB%E9%A2%98%E7%B3%BB%E7%BB%9F)
  - [3.1 主题资源引用机制](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#31-%E4%B8%BB%E9%A2%98%E8%B5%84%E6%BA%90%E5%BC%95%E7%94%A8%E6%9C%BA%E5%88%B6)
  - [3.2 动态主题切换实现](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#32-%E5%8A%A8%E6%80%81%E4%B8%BB%E9%A2%98%E5%88%87%E6%8D%A2%E5%AE%9E%E7%8E%B0)

- [4. 构建与部署](https://gitee.com/shend/WebPlugins/wikis/front%E2%80%90end#4-%E6%9E%84%E5%BB%BA%E4%B8%8E%E9%83%A8%E7%BD%B2)

## [后端开发指南](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end)
- [1. 插件工程架构](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#1-%E6%8F%92%E4%BB%B6%E5%B7%A5%E7%A8%8B%E6%9E%B6%E6%9E%84)
  - [1.1 工程化解决方案](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#11-%E5%B7%A5%E7%A8%8B%E5%8C%96%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88)
    - [1.1.1 下载模板引擎](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#111-%E4%B8%8B%E8%BD%BD%E6%A8%A1%E6%9D%BF%E5%BC%95%E6%93%8E)
    - [1.1.2 命令行创建插件模板解决方案](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#112-%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%88%9B%E5%BB%BA%E6%8F%92%E4%BB%B6%E6%A8%A1%E6%9D%BF%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88)
    - [1.1.3 VisualStudio创建插件模板解决方案](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#113-visualstudio%E5%88%9B%E5%BB%BA%E6%8F%92%E4%BB%B6%E6%A8%A1%E6%9D%BF%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88)
  
  - [1.2 解决方案结构](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#12-%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E7%BB%93%E6%9E%84)
    - [1.2.1 Solution Items解决方案文件夹](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#121-solution-items%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E6%96%87%E4%BB%B6%E5%A4%B9)
    - [1.2.2 docs解决方案文件夹](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#122-docs%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E6%96%87%E4%BB%B6%E5%A4%B9)
    - [1.2.3 build解决方案文件夹](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#123-build%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E6%96%87%E4%BB%B6%E5%A4%B9)
    - [1.2.4 插件项目](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#124-%E6%8F%92%E4%BB%B6%E9%A1%B9%E7%9B%AE)

- [2. 上下文管理规范](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#2-%E4%B8%8A%E4%B8%8B%E6%96%87%E7%AE%A1%E7%90%86%E8%A7%84%E8%8C%83)
  - [2.1 模型映射规范](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#21-%E6%A8%A1%E5%9E%8B%E6%98%A0%E5%B0%84%E8%A7%84%E8%8C%83)
  - [2.2 上下文命名规范](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#22-%E4%B8%8A%E4%B8%8B%E6%96%87%E5%91%BD%E5%90%8D%E8%A7%84%E8%8C%83)
  - [2.3 上下文基本说明](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#23-%E4%B8%8A%E4%B8%8B%E6%96%87%E5%9F%BA%E6%9C%AC%E8%AF%B4%E6%98%8E)
  - [2.4 跨插件模型操作说明](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#24-%E8%B7%A8%E6%8F%92%E4%BB%B6%E6%A8%A1%E5%9E%8B%E6%93%8D%E4%BD%9C)

- [3. 接口定义及调用](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#3-%E6%8E%A5%E5%8F%A3%E5%AE%9A%E4%B9%89%E5%8F%8A%E8%B0%83%E7%94%A8)
  - [3.1 服务接口定义](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#31-%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%AE%9A%E4%B9%89)
  - [3.2 服务接口实现](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#32-%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%E5%AE%9E%E7%8E%B0)
  - [3.3 服务接口注册](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#33-%E6%9C%8D%E5%8A%A1%E6%8E%A5%E5%8F%A3%E6%B3%A8%E5%86%8C)
  - [3.4 控制器继承](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#34-%E6%8E%A7%E5%88%B6%E5%99%A8%E7%BB%A7%E6%89%BF)
  - [3.5 本地调试接口](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#35-%E6%9C%AC%E5%9C%B0%E8%B0%83%E8%AF%95%E6%8E%A5%E5%8F%A3)
  - [3.6 接口调试工具](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#36-%E6%8E%A5%E5%8F%A3%E8%B0%83%E8%AF%95%E5%B7%A5%E5%85%B7)

- [4. 日志管理](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#4-%E6%97%A5%E5%BF%97%E7%AE%A1%E7%90%86)
  - [4.1 平台日志输出](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#41-%E5%B9%B3%E5%8F%B0%E6%97%A5%E5%BF%97%E8%BE%93%E5%87%BA)
  - [4.2 插件日志输出](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#42-%E6%8F%92%E4%BB%B6%E6%97%A5%E5%BF%97%E8%BE%93%E5%87%BA)

- [5. 常用帮助扩展](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#5-%E5%B8%B8%E7%94%A8%E5%B8%AE%E5%8A%A9%E6%89%A9%E5%B1%95)
  - [5.1 字符串扩展](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#51-%E5%AD%97%E7%AC%A6%E4%B8%B2%E6%89%A9%E5%B1%95)
  - [5.2 日期扩展](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#52-%E6%97%A5%E6%9C%9F%E6%89%A9%E5%B1%95)
  - [5.3 序列化扩展](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#53-%E5%BA%8F%E5%88%97%E5%8C%96%E6%89%A9%E5%B1%95)
  - [5.4 枚举扩展](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#54-%E6%9E%9A%E4%B8%BE%E6%89%A9%E5%B1%95)
  - [5.5 键值对对象](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#55-%E9%94%AE%E5%80%BC%E5%AF%B9%E5%AF%B9%E8%B1%A1)

- [6. 会话信息](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#6-%E4%BC%9A%E8%AF%9D%E4%BF%A1%E6%81%AF)
- [7. 读取配置](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#7-%E8%AF%BB%E5%8F%96%E9%85%8D%E7%BD%AE)
- [8. 定时作业](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#8-%E5%AE%9A%E6%97%B6%E4%BD%9C%E4%B8%9A)
  - [8.1 使用示例](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#81-%E4%BD%BF%E7%94%A8%E7%A4%BA%E4%BE%8B)
  - [8.2 使用注意](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#82-%E4%BD%BF%E7%94%A8%E6%B3%A8%E6%84%8F)
- [9. 数据转换对象(DTO)](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#9-%E6%95%B0%E6%8D%AE%E8%BD%AC%E6%8D%A2%E5%AF%B9%E8%B1%A1dto)
  - [9.1 映射配置](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#91-%E6%98%A0%E5%B0%84%E9%85%8D%E7%BD%AE)
  - [9.2 映射方式（一）](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#92-%E6%98%A0%E5%B0%84%E6%96%B9%E5%BC%8F%E4%B8%80)
  - [9.3 映射方式（二）](https://gitee.com/shend/WebPlugins/wikis/back%E2%80%90end#93-%E6%98%A0%E5%B0%84%E6%96%B9%E5%BC%8F%E4%BA%8C)