17 篇面向使用者的文档，从准备到排错一次跑通。 · 17 篇
不依赖容器：只用本机 JDK 21 与一个 MySQL 实例，跑起来、登录、生成一个模块。
常用命令、目录导览、配置纪律与故障排查。
常规部署形态：jar + MySQL + 反向代理。本站不提供容器镜像与编排文件。
app → domain → data/infra → common/config，方向只允许向下，由构建强制。
模块名 = 表前缀；命名规范一览；参照实现在哪。
从建表到上线的一条完整路径，也是骨架生成器自动做的事。
单权限表承载目录/菜单/按钮/接口，多角色 RBAC，注解是唯一事实源。
集中定义、禁止字面量、三处一致，由构建校验。
全部 / 部门 / 部门及以下 / 仅本人 / 自定义，由数据访问层统一注入。
只有标注的字段进 WHERE；类型不符即抛错；排序与分页都有护栏。
写方法只放 Repository；事务边界在 app/domain，由断言守住。
基类自带逻辑删除；手写 SQL 必须自己带条件；列非空默认 0。
Liquibase 是唯一入口；已入库脚本冻结，只增不改。
一次请求，五个入口取到同一个 traceId。
敏感操作留痕，异步写入不阻塞主链路，与 traceId 可关联。
统一响应壳、错误码号段、三语文案。
需要 Docker 吗？能不能加业务模块？支持哪些数据库？