thinkgem 后端开发手册
JeeSite 后端开发指南，包括安装部署、代码生成、持久层、业务层、控制层、权限认证等。
使用流程
- 匹配文档：根据用户问题，在「文档映射」表中查找最相关的 permalink
- 获取缓存：在 jeesite skills 根目录下执行
python3 scripts/cache_docs.py --skill backend-dev --permalink <permalink>脚本，缓存目录为references/.cache/backend-dev/，不存在时自动回退到~/.cache/jeesite/backend-dev/ - 读取内容：先读
__00.md目录索引文件，了解章节结构，按需读取__01.md~`__NN.md` - 回答问题：缓存文件有效期3天，自动更新缓存，并基于读取的文档内容回答
关键词
安装、部署、环境搭建、代码生成、DAO、MyBatis、@Table、数据权限、Service、Shiro、权限、工具类、数据库管理、REST API、FAQ、JDK、Maven、MySQL、IDEA、新建模块、修改包名、正式部署、war、初始化数据库、多数据源、SQL映射、数据范围、事务、角色权限、按钮权限、控制层、Swagger、接口开发、移动端接口、问题排查、常见问题
触发场景
- 如何安装部署JeeSite
- 如何生成代码
- DAO怎么写
- MyBatis怎么用
- 数据权限怎么配置
- Shiro权限怎么控制
- 系统工具类有哪些
- 数据库管理怎么用
- REST API接口
- 后端常见问题
- 环境要求
- JDK版本
- 初始化数据库
- 新建模块
- 修改包名
- 正式部署
- 多数据源配置
- SQL映射
- 事务管理
- 角色权限配置
- 按钮权限
- Swagger文档
- 移动端接口开发
AI 强制触发（代码生成前置条件）
以下场景必须先加载 quick-start Skill 并读取 /standard/ 规范文档：
- 代码生成 / 创建 Entity / DAO / Service / Controller / Mapper XML
- @Table / @Column / @JoinTable 注解使用
- 字段类型选择（String/Long/BigDecimal/Date/User/Office 等）
- Service 继承选择（CrudService vs TreeService vs CrudServiceApi）
- 树结构实体设计
- 主子表（一对多）设计
- 文件上传 / 导入导出 Excel
- 权限注解 @RequiresPermissions 格式
- 数据/字段权限过滤
- 事务注解 @Transactional 使用
文档映射
| 文档标题 | sidebarTitle | permalink | 摘要与关键章节 | 关联文档 |
|---|---|---|---|---|
| 安装部署 | 快速开始、安装部署 | /install-deploy/ | 环境搭建、新建模块、修改包名、正式部署。关键章节：开发环境、初始化数据库、部署 | /vue-install-deploy/、/faq/ |
| 代码生成 | 代码生成、表结构ER图 | /code-gen/ | 代码生成器、自动生成业务代码、ER图。关键章节：生成步骤、配置说明。⚠️ 生成代码前先读 /standard/ 开发规范 | /standard/、/dao-mybatis/、/vue-crud-view/ |
| DAO与MyBatis | 持久层、@Table、多数据源 | /dao-mybatis/ | MyBatis DAO、@Table注解、多数据源、SQL映射。关键章节：实体类、DAO接口、多数据源。⚠️ 注解使用参照 /standard/ 规范 | /standard/、/code-gen/、/service-datascope/ |
| 数据权限 | 业务层、数据权限、库事务 | /service-datascope/ | 数据权限、数据范围、Service层、事务管理。⚠️ Service写法参照 /standard/ 规范 | /standard/、/permi-shiro/、/dao-mybatis/ |
| 权限与Shiro | 控制层、功能权限、Shiro | /permi-shiro/ | Shiro权限认证、角色权限、按钮权限、控制层。⚠️ Controller/权限参照 /standard/ 规范 | /standard/、/service-datascope/、/vue-auth/ |
| 系统工具类 | 系统工具类 | /sys-utils/ | 系统工具类、常用API。关键章节：字符串工具、日期工具、文件工具 | /faq/ |
| 数据库管理 | 动态维护数据、表、实体 | /dbm/ | 数据库管理、数据表建模、数据源管理。关键章节：表建模、实体生成 | /code-gen/、/dao-mybatis/ |
| REST API | REST API | /mobile-rest-api/ | REST接口开发、API规范、移动端接口。关键章节：接口规范、认证方式 | /uniapp/、/permi-shiro/ |
| 常见问题 | 常见问题 | /faq/ | 后端常见问题排查。关键章节：环境问题、配置问题、运行问题 | /install-deploy/、/config/ |
常见问题映射
| 用户问题 | 推荐文档 | WebFetch URL |
|---|---|---|
| 如何安装部署？ | 安装部署 | https://jeesite.com/docs/install-deploy/ |
| 如何使用代码生成？ | 代码生成 | https://jeesite.com/docs/code-gen/ |
| DAO层怎么写？ | DAO与MyBatis | https://jeesite.com/docs/dao-mybatis/ |
| 数据权限怎么配？ | 数据权限 | https://jeesite.com/docs/service-datascope/ |
| Shiro权限怎么用？ | 权限与Shiro | https://jeesite.com/docs/permi-shiro/ |
| 有哪些工具类？ | 系统工具类 | https://jeesite.com/docs/sys-utils/ |
| 数据库管理怎么用？ | 数据库管理 | https://jeesite.com/docs/dbm/ |
| REST API怎么写？ | REST API | https://jeesite.com/docs/mobile-rest-api/ |
| 后端常见问题？ | 常见问题 | https://jeesite.com/docs/faq/ |