前言
在企业级应用开发中,如何高效组织多端项目、统一技术栈、提升协作效率,已成为团队面临的核心挑战。传统"各自为政"的开发模式不仅带来重复劳动,也增加了维护成本。
本文推荐一个融合 Web 前端、移动端 App、后端服务与文档网站的全栈管理系统,它不是简单的功能堆砌,而是基于 Monorepo + Turbo 架构打造的一体化解决方案,为大家提供开箱即用、高效协同、易于部署的现代化开发体验。
项目介绍
项目是一个面向企业级场景的全栈管理系统。它采用 Monorepo(单一代码仓库)管理四个子应用:Web 前端、React Native 移动端、Node.js 后端服务以及基于 Next.js 的文档网站。所有模块共享一套构建工具链和依赖体系,通过 Turbo 实现并行构建与智能缓存,大幅缩短本地开发与 CI/CD 流程时间。
系统支持完整的用户认证体系、细粒度权限控制、实时通信能力,并提供 Docker 容器化部署方案,真正实现"一次配置,处处运行"。
项目功能
1、用户认证方面,系统采用 JWT 双 Token 机制(Access + Refresh),支持单点登录、二维码扫码登录、图形验证码等主流方式。
2、权限管理上,基于 RBAC 模型扩展出四层权限体系(系统层、模块层、操作层、数据层),配合动态菜单路由与按钮级权限控制,满足复杂业务需求。
3、实时通信通过 SSE(Server-Sent Events)实现,包括登录通知、心跳检测、下线提醒等功能,前端封装了增强版 useSSE Hook,自动处理重连与认证。
4、移动端支持扫码登录、头像上传、设备信息采集,并通过 Expo Router 实现文件路由,开发体验接近原生。
5、文档网站内置全文搜索、代码高亮、主题切换、SEO 优化等能力,内容以 Markdown 编写,结构清晰,便于团队知识沉淀。
项目特点
项目最大的亮点在于架构设计。Monorepo + Turbo 不仅让多端代码共处一仓,还通过依赖图分析避免重复安装,PNPM 进一步节省磁盘空间。
Docker 部署方案高度自动化,auto-deploy.sh 脚本支持版本管理与软链接切换,配合 Nginx 反向代理,轻松实现生产环境上线。
另外,全局代码格式化(Prettier + ESLint + Husky)确保团队编码风格统一,减少低级错误。
项目体验
Web前端:https://wladmin.cn
后端API:https://admin.liyq666.top/api/docs/
文档网站:https://www.wladmin.cn
移动端App:https://wladmin.cn/app
项目技术
构建工具
Turbo 2.0.6 - 高性能并行构建系统
PNPM 10.24.0 - 快速、节省磁盘空间的包管理器
部署工具
Docker - 容器化部署
Docker Compose - 容器编排
auto-deploy.sh - 自动部署脚本
后端技术栈
Node.js >= 20.10.0 - JavaScript运行时
Express.js 5.1.0 - Web应用框架
MySQL >= 8.0 - 关系型数据库
Redis - 缓存和会话存储
JWT - JSON Web Token认证
bcryptjs 3.0.2 - 密码加密
ioredis 5.8.2 - Redis客户端
svg-captcha - 图形验证码
multer 2.0.2 - 文件上传
node-schedule 2.1.1 - 定时任务
Swagger - API文档
Web前端技术栈
React 18.2.0 - UI框架
Ant Design 6.0.0 - UI组件库
Webpack 5.99.9 - 模块打包器
Babel 7.27.4 - JavaScript编译器
Redux Toolkit 2.8.2 - 状态管理
React Router 6.30.0 - 路由管理
Axios 1.10.0 - HTTP客户端
Less 4.3.0 - CSS预处理器
Day.js 1.11.19 - 时间处理
ESLint 9.39.1 - 代码规范
SparkMD5 3.0.2 - 文件哈希计算
移动端技术栈
React Native 0.81.5 - 跨平台移动应用框架
Expo 54.0.29 - React Native开发工具链
Expo Router 6.0.19 - 文件路由系统
React Native Paper 5.14.5 - Material Design组件库
TypeScript - 类型安全
Expo Camera - 相机扫描
Expo Image Picker - 图片选择
Expo Crypto - 文件哈希
Expo File System - 文件系统
Expo Device - 设备信息
EAS Build - 云端/本地构建服务
文档网站技术栈
Next.js 16.1.0 - React 全栈框架
TypeScript - 类型安全
Tailwind CSS 3.4.19 - 原子化 CSS 框架
rehype-pretty-code - 代码高亮(支持暗色/亮色主题)
remark + rehype - Markdown 处理
Fuse.js 7.1.0 - 全文搜索
@tailwindcss/typography - 排版插件
开发工具
Prettier 3.3.3 - 代码格式化工具
ESLint 9.39.1 - 代码质量检查工具
EditorConfig - 编辑器统一配置
Husky 9.1.7 - Git hooks 管理
lint-staged 15.2.10 - Git 提交前格式化
ShellCheck - Bash 脚本静态分析
shfmt - Shell 代码格式化
Bats - Bash 自动化测试
项目效果
Web 端界面简洁专业,移动端交互流畅,文档站内容完整易查。得益于缓存策略与 SSE 优化,高频操作如用户登录、权限变更、消息推送均能即时生效。Docker 部署后,服务启动时间控制在 30 秒内,资源占用合理,适合中小型团队快速搭建内部管理系统或对外交付标准化产品。
项目源码
项目已完全开源
Gitee:https://gitee.com/genchuan/genchuan-smart-city
总结
项目是一个后台管理系统模板,更是一套经过实践验证的企业级开发范式。它将工程化思维贯穿始终——从代码组织、构建优化到部署运维,每一步都力求高效与规范。对于希望提升团队研发效能、降低系统耦合度的团队而言,这套方案提供了极具参考价值的落地路径。未来,随着更多功能模块的加入与社区生态的完善,它有望成为国产开源全栈解决方案中的有力代表。
关键词
作者:小码编匠
出处:gitee.com/smallcore/DotNetCore
声明:网络内容,仅供学习,尊重版权,侵权速删,歉意致谢!
方便大家交流、资源共享和共同成长
纯技术交流群、需要的小伙伴请扫码