技术栈概述
- 后端框架: .NET 6.0 提供高性能跨平台支持,集成Admin.NET作为后台管理系统基架。
- 前端框架: Vue 3组合式API + Pinia状态管理,搭配Element Plus实现Web端UI。
- 移动端: Uniapp跨平台开发,一套代码生成H5及小程序(预留扩展能力)。
- 数据库: 支持MySQL/SqlServer,ORM使用SqlSuger对数据库无限可能支持。
- 辅助技术: JWT身份认证、SignalR实时通信、Redis缓存、Docker容器化部署。
核心功能模块设计
- 用户体系: 多角色权限(Admin.NET RBAC)、第三方登录(OAuth2.0)、手机号验证。
- 内容管理: 富文本编辑器(wangEditor 5.0 )、多级分类标签、审核流设计。
- 地方特色: 特产展示、本地找工作、租房、售房、商家入驻系统、本地新闻聚合模块。
- 交互功能: 评论点赞、即时消息(WebSocket)持续完善中。
跨端适配方案
- 响应式布局: Vue 3 + Element Plus按需加载,PC端采用栅格系统,移动端Flex弹性布局。
- Uniapp优化: 条件编译区分平台,H5端对接Vue2组件,原生功能通过uni-API实现。
- API统一: RESTful接口标准化,Axios拦截器处理多端请求差异,DTO动态适配。
性能与安全
- 静态资源: CDN加速,Vite打包优化,路由懒加载。
- 安全措施: 接口签名防篡改,XSS过滤,SQL参数化查询。
- 监控日志: Serilog日志分级,Prometheus+Granfa监控链路。
部署与扩展
- CI/CD: GitHub Actions自动化构建,Docker Compose编排Nginx+后端+数据库。
- 微服务预留: 模块化拆分设计,未来可扩展为ServiceMesh架构。
- SEO优化: SSR同构渲染方案(预留Nuxt.js集成可能性)。
代码规范与开源
- Git管理: 分支策略(main/dev/feature),Commit Message遵循Conventional Commits。
- 文档输出: Swagger API文档,Vitepress编写技术手册,CHANGELOG版本记录。
- 开源协议: 采用MIT License,明确贡献者协议(CLA)。
技术亮点总结
- 前后分离深度实践: 基于.NET 6.0 Minimal API的高效后端 + Vue3现代前端。
- Admin.NET二次开发: 快速搭建后台,复用权限/日志等基础模块。
- Uniapp多端降本: 减少重复开发,动态主题切换适配地方特色UI。
项目开源地址:https://gitee.com/haven5/local-live
网页端预览地址:https://www.kmdc.org.cn/
手机端预览地址:https://m.kmdc.org.cn/
网页端效果图
移动端页面展示