项目简介
前言
我们相信,脚手架的终点不是功能堆叠,而是把代码写好的那股清流。
Start-Admin-Boot 是一款面向 Java 开发者的单体多模块后台脚手架,以「工程规范 + AI 协作体系」为核心:当别人还在争论 AI 能不能写代码时,我们已经在用 AGENTS.md → rules → skills → ai-check 一整套门禁,让 AI 按章程工作——约束 AI、带证据交付,而不是黑箱输出。
这个仓库没有炫技,只有一件件被验证过的事:
- 规范不是口号:分层契约、统一响应、权限审计,全部落地为规则与门禁,由 400+ 测试用例守着;
- AI 不是玩具:需求收敛 → 任务契约 → 规则路由 → 实现 → 测试 → 验收证据,28 个专项 Skill 把「AI 协作」变成可以复制的工程方法;
- 开箱即用:用户、角色、菜单、部门、岗位、字典、参数配置、通知公告,该有的都有,还配好了缓存、分布式 Job、WebSocket 与数据权限。
花 3 分钟往下看,希望你也能感受到“代码就该这么写”的踏实。
理念与思想
人类掌舵,AI 执行。 这是这个项目最重要的信念。
- 工程规范落地为代码:Controller → Service → Manager → Mapper,四层分得清清楚楚;该在 Controller 做的只在 Controller 做,该下沉到 Manager 的一律下沉——每一层都有边界,每一条边界都有门禁守护。
- 约束 AI、带证据交付:AI 可以写得很快,但我们要求它先给需求规格与任务契约,跑完测试再交验收证据;缺业务事实就停下提问,没跑检查就说明原因。AI 是并肩的协作者,不是黑箱。
- 一致性优先:缓存、异步、事务,一律以数据一致性为第一原则;性能优化永远排在正确之后。
- 演进克制:单体起步,共享能力域纵切;不为想象的规模预建微服务全家桶,规模真的来了再说。
技术体系
| 层 | 选型 |
|---|---|
| 后端 | Java 25 · Spring Boot 4.1(Framework 7)· MyBatis-Flex · Sa-Token · Redisson · Jackson 3 |
| 前端 | Vue 3.5 · TypeScript · Fantastic-admin · Element Plus · UnoCSS,pnpm monorepo |
| 基础设施 | PostgreSQL 14+ · Redis 6+ |
架构:单体多模块——start-common 共享能力域(缓存 / 数据库 / Web / 鉴权 / 日志 / Excel / OSS,零业务语义)+ start-admin 业务启动模块,依赖单向,分层与域隔离交给门禁。
仓库布局:
start-admin-boot-backend/:后端单体,start-admin启动模块 +start-common技术设施;start-admin-boot-web-ui/:前端 monorepo,应用在apps/example,共享组件在packages/components;start-admin-web/:就是本官网。
功能亮点
完整管理域,开箱即用:用户、角色、菜单、部门、岗位、字典、参数配置、通知公告——每个模块都有页面、权限、审计,拿来即用,不用二次造轮子。
基础设施,已替你踩过坑:
- 缓存:注解 + 手写双轨,异常降级、事务感知,不会出现“缓存清了但库里没更新”的尴尬;
- 分布式 Job:内置调度封装,统一触发与失败处理;
- 实时能力:WebSocket 通知与在线状态;
- 文件与 OSS:上传、预览策略化,按需切换对象存储;
- 数据权限:部门、人员、组织维度的行级隔离,交给门禁守护;
- 测试体系:单元测试 + 持久层集成测试两层覆盖,统一基座,改 SQL 先跑测试。
以上只是冰山一角,更多细节等你发现。
代码亮点
- 分层即契约:Controller 只做 HTTP 与权限、Service 只编排业务、Manager 收敛数据访问——Mapper 进不了 Service,
QueryWrapper出不了 Manager,每条都有门禁与测试守着; - 统一收口:响应
ResponseDTO、异常处理、审计日志、前端错误拦截器,一处定义全站生效,不会出现“每个接口各自为政”; - AI 协作产物即文档:强制规则、专项 Skill、任务契约、验收证据随代码进仓库——新成员和 AI 都能按同一本章程工作;
- 前端工程化:组合式 API + TypeScript 严格模式,组件分层(Fa 布局/反馈 + Element Plus 表单),业务页面自带聚焦测试;
- 质量门禁:
ai-check架构检查 + 后端编译单测 + 前端 lint 单测,一键全量验证,提交前心里有底。
演示图
点进在线演示直接上手体验;下面这张是本地开发环境的控制台截图。
联系我们
- 在线演示:https://start-admin.p.muziseo.cn/
- QQ 交流群:558016858——欢迎提问、反馈、晒你的二开成果,也欢迎聊聊 AI 协作、聊聊代码;
- GitHub:仓库公开后将在官网与文档区提供入口,欢迎 star 与 PR。
愿我们都能把代码写好,保持谦逊,保持学习,热爱代码,也热爱生活。