Start-Admin-BootStart-Admin-Boot

AI-First 工程脚手架

新一代后台脚手架,
带着 AI 工程体系交付

不止是开箱即用的企业级底座,更是一套约束 AI、带证据交付的协作体系——强制分层契约、规则路由、架构门禁,让 AI 按章程工作,而不是黑箱输出。

start-admin.p.muziseo.cn
Start-Admin-Boot 后台控制台截图
Java 25Spring Boot 4.0MyBatis-FlexSa-TokenVue 3.5PostgreSQLRedis

人类掌舵,AI 执行

从需求到验收,AI 走一条被规则约束的流水线:先论证、再动手、最后补证据。

  1. 01

    业务事实

    人类给定目标、数据与验收标准

  2. 02

    需求规格

    requirements-discovery

  3. 03

    任务契约

    business-task-intake

  4. 04

    规则路由

    skill-routing

  5. 05

    实现

    分层与边界内落地

  6. 06

    测试

    单测 + 集成测试

  7. 07

    验收证据

    ai-check 必须通过

反馈循环:验收发现偏差 → 同步修正任务契约、实现与测试;规范与代码不一致时,同一变更内一起改。

缺事实 → 停下来提问

数据含义、状态流转、权限语义或对外契约不明时,AI 先提出最少且会改变业务行为的问题,而不是替你补齐业务假设。

没跑的检查 → 说明原因

任何未运行的检查都要在交付时说明具体原因,不以「AI 已检查」代替可复现证据——自动化门禁才是质量兜底。

不止允许 AI 参与,而是驾驭 AI

四个环节组成一条人机协作管线:任务按信号路由到最小规则集,产出必须通过机器门禁——让任意 AI 编码助手按同一套契约可靠交付。

01协作入口

AGENTS.md

人机分工、规则优先级与强制边界统一入口;人类负责业务目标与风险边界,AI 在边界内实现与验证。

02强制规则

rules

编码、提交、迁移、日志四类硬约束,任何 AI 编码助手一视同仁。

03任务技能

skills

28 个任务 Skill:CRUD 标准流、数据库变更、数据权限、测试标准……高频任务模板化。

04质量门禁

ai-check

分层依赖与路由契约机器可校验,架构检查不通过即视为未完成,不依赖 AI 自觉。

人类负责业务目标、数据含义与风险边界;AI在既定边界内实现与验证——交付质量由门禁兜底,而不是靠提示词运气。了解 AI 工程体系 →

为什么选 Start-Admin-Boot

产品与工程的双重底气。每一条都有据可查,不是形容词堆砌。

400+
后端测试用例

完整的测试体系

测试是默认门禁,不是被讨要的。主要业务规则均有用例覆盖;集成测试连真实 PostgreSQL,直接查询数据正确性。

测试类75 个
集成测试连真实库
0
外部调度依赖

内置分布式 Job

自研 StartJob 引擎:基于 Redisson 分发、多实例实时同步,自带调度 / 执行 / 日志面板。无需再集成 XXL-Job 或 Quartz。

引擎StartJob
分发Redisson
Java 25
LTS 基线

前瞻技术栈

Spring Boot 4.1.1(Framework 7)· MyBatis-Flex · Jackson 3 · Redisson;前端 Vue 3.5 + Fantastic-admin。站在这一代框架的最前沿。

后端Boot 4.1.1
前端Vue 3.5
40+
自研 Fa 组件

优秀前端体验

Fantastic-admin 骨架 + Element Plus + 40 余个 Fa 组件:搜索栏、工具行、分页、上传各有既定套路,交互一致、明暗主题双端兼顾。

骨架Fantastic-admin
主题明暗双端
4 层
强制分层契约

规范的代码质量

Controller → Service → Manager → Mapper 分层、命名与注释对齐《阿里巴巴 Java 开发手册》,由 ai-check 架构门禁强制把关——不通过即视为未完成。

规范阿里手册
把关ai-check

为核心场景而生

从权限体系到集群通信,从分层契约到 AI 工程化,每一层都为长期演进设计。

前沿技术栈

Java 25 与 Spring Boot 4 全面落地,享受最新特性带来的性能红利。

规格Java 25 / SB 4.0
配套Spring Fw 7

极致的权限控制

Sa-Token 完整 RBAC、JWT 无状态会话、接口权限与行级数据权限。

模型RBAC + JWT
粒度接口 + 行级

高效持久层

MyBatis-Flex 链式 API 提升数据库操作效率,Liquibase 管版本演进。

ORMMyBatis-Flex
版本Liquibase

能力域深度解耦

start-common 沉淀 11 个技术能力域,零业务语义、互不耦合。

能力域11 个
依赖单向

集群全双工通信

分布式优化 WebSocket,支持跨节点消息精准路由与会话管理。

协议WebSocket
路由跨节点

AI 驾驭工程

AGENTS.md + 28 个任务 Skill + ai-check 质量门禁,人机分工可靠交付。

Skills28 个
门禁ai-check

单体部署,模块化演进

共享能力域与业务模块两层拆分:业务模块按端/场景独立,共享 start-common 能力域、互不耦合。 单体部署常驻一个进程,部署运维极简,又能按需拆分演进。

  • · 11 个技术能力域零业务语义,依赖方向单向
  • · 每个业务模块独立启动类,平级扩展零改造
  • · Controller → Service → Manager → Mapper 强制分层契约
阅读模块架构文档 →
start-admin-boot-backend
├── start-common            # 共享能力域(11 个)
│   ├── core / cache / db / satoken
│   ├── log / excel / oss / websocket
│   └── social / job / web
├── start-admin             # 后台管理业务模块
│   ├── auth                # 认证
│   ├── system              # 系统管理
│   ├── monitor             # 系统监控
│   └── social              # 社交账号
└── start-app (规划中)       # APP 端接口服务

start-admin-boot-web-ui
├── apps/example            # 业务主应用(Vue 3 + Fantastic-admin)
└── packages/               # components / settings / themes / types

现代化的全栈技术选型

后端与前端都站在最新稳定版本上,工程体验与长期可维护性兼得。

核心框架

Java25
Spring Boot4.0.7
Spring Framework7

认证与权限

Sa-Token1.45
JWT有状态
接口 / 行级权限@SaCheckPermission / @DataScope

持久化

MyBatis-Flex1.11.8
Liquibase版本演进
PostgreSQL / MySQL主备

缓存与工程

Redis + Redisson + Caffeine一二级缓存
springdoc-openapi接口文档
FastExcel / MapStruct / JustAuth工具链