目前已具备的功能
每一项都写清“给你什么”,不说教。
基础能力
登录 / 登出 / 验证码
一套可直接用的认证闭环
账号 / 邮箱 / 手机多凭据登录;密码方案写死为 BCrypt,不提供弱哈希选项
用户 / 角色 / 菜单
后台管理主链路
三张表讲清一件事;字段注释与实现一致;菜单与前端路由同源
按钮级权限
细到每个按钮的控制
权限码集中定义,禁止散落字面量;构建期校验三处一致
部门 / 数据权限
看得到该看的
按部门 / 本人 / 自定义范围 / 全部;由数据访问层统一注入,业务代码不感知
字典 / 参数配置
日常配置不写死
有缓存且缓存可观测,不是裸查库
操作日志 / 登录日志
出事能追溯
异步写入,不阻塞主链路;与 traceId 可关联
文件上传
通用附件能力
类型 / 大小白名单在服务端校验,不靠前端
接口文档
前后端联调不靠嘴
OpenAPI 构建期导出,与权限码清单同源
前端动态路由与权限指令
前端零鉴权逻辑
前端只做显隐,不做权限判定
定时任务 / 消息消费
非 HTTP 入口同样可观测
与 HTTP 请求共享同一条 traceId
工程质量
架构护栏
约定由机器执行
分层与依赖方向强制;6 类禁用写法(字段注入、Controller 直连 Mapper、System.out、new Date() 等);无循环依赖
契约一致性
文档不会和代码分家
契约登记的接口数、权限码、错误码号段与源码实时比对,不一致即构建失败
鉴权默认拒绝
不会漏掉鉴权
未标注鉴权的接口启动即失败;匿名访问返回固定错误码
全链路 traceId
五分钟定位问题
HTTP / 定时任务 / 消息消费 / 线程池,五处取值全等
结构化日志
日志可查可聚合
traceId 与 userId 是一级字段;手机号与密码默认脱敏
操作审计
敏感操作留痕
权限变更、删除、导出、登录,可追溯到人 / 时间 / IP / traceId
查询与写入质量
不做会出事的那几件事
条件白名单 + 通配符转义;类型不符抛错而非静默丢条件;无排序时补稳定次级排序;统一分页返回 + 深分页保护
事务与迁移纪律
数据口径唯一
写操作统一出口;事务边界由架构断言守住;逻辑删除列非空默认 0;迁移脚本只增不改
骨架生成器
新模块 30 分钟起步
生成目录 / 迁移脚本 / 测试骨架,自动登记模块、权限码、菜单;生成物自带测试,一次过构建
审批实例层(能力包)
外包 OA 刚需即刻可用
流程定义 + 固定链节点、实例与任务、审批留痕(含 traceId)、会签 / 或签、驳回;可插拔,卸载后核心无依赖
一条命令起环境
新机器 10 分钟可登录
迁移脚本自动建表 + 种子数据 + 初始管理员;只需自备 JDK 21 与 MySQL 8,不依赖内网地址与人工建表
CI 与质量闸门
提交即体检
构建、测试、守护规则、格式化与提交钩子,一次命令跑完
交付物一览
一套可登录的后台 + 一套可复现的工程质量指标 + 一条命令起环境 + 一个能生成“可直接过构建代码”的生成器。
顺带一提:过不了架构校验的代码,合不进去。
明确不做清单
| 不做 | 为什么不 | 若你需要怎么办 |
|---|---|---|
| 工作流引擎与可视化设计器 | 十年工程;当前只提供实例层 | 用审批实例层覆盖固定链;复杂流程走能力包扩展 |
| 多租户 | 当前核心仓不引入租户维度 | 用行级数据权限按部门隔离;租户能力列入后续方向 |
| 字段级权限与脱敏体系 | 当前只做日志默认脱敏 | 敏感字段在序列化层自行处理;后续作为能力包 |
| 性能压测基线 | 当前“更好维护”体现在约定与质量,不是压测数字 | 看查询与写入质量一节;压测基线在后续方向 |
| 框架内嵌调用大模型 | 成本、密钥、模型换代都是坑,且等于替模型质量背锅 | 用任何 AI 工具写代码,由本框架的构建关卡守住 |
| 传输 / 存储加密与国密 | 密钥外置的纪律当前先立 | 在网关与数据库层解决,不进核心仓 |
| 多数据库与信创适配 | 接受“MySQL 优先”的取舍 | 需要时按能力包适配,不改核心 |
| 低代码与在线表单 | 定位一旦是“零代码”,复杂场景必然翻车 | 用骨架生成器 + 手写业务实现 |
| 自带业务模块(商城 / CRM / 会员) | 核心仓零业务代码;这正是把用户锁死的根因 | 业务放在你的业务仓,以能力包形式扩展 |
| 容器镜像与编排文件 | 交付形态是 jar + 数据库;替用户选运维方式反而增加承诺面 | 按你们自己的规范封装;部署文档只讲非容器化路径 |
| (官网)任何竞品对比 | 对外叙事只讲我们自己 | 我们提供维度与测法,数字你自己跑 |
| (官网)客户案例与 logo 墙 | 当前没有真实授权背书 | 看工程质量与构建证据;有真实案例后再上 |