ContiNew Admin 开发技能

ContiNew Admin 是一个持续迭代优化的前后端分离中后台管理系统框架，基于 Spring Boot 3.x 构建，提供企业级的功能模块和开发体验。

概述

本技能包提供完整的开发指导、代码模板和最佳实践，帮助开发者快速上手和高效开发 ContiNew Admin 项目。

核心信息

• 版本: 4.2.0-SNAPSHOT
• 框架: continew-starter 2.15.0
• Java: 17+
• 技术栈: Spring Boot 3.x + MyBatis-Plus + Sa-Token

技能包内容

📚 开发指南 (development-guide.md)

全面介绍项目的架构、技术栈、模块结构、开发模式和最佳实践。

主要内容:

• 项目概述和技术栈
• 模块结构和职责
• MVC + Service 分层架构
• CRUD 注解驱动开发
• 权限控制和认证授权
• Model 层设计（四层模型）
• 配置管理
• 常用工具和注解
• 开发工作流
• 调试和测试
• 性能优化
• 最佳实践

适用场景:

• 了解项目整体架构
• 学习开发模式和规范
• 新手入门指导
• 代码审查参考

🛠️ 代码模板 (code-templates.md)

提供快速开发使用的代码模板、脚本和工作流程。

主要内容:

• 完整的 CRUD 模块模板
• 数据库迁移脚本模板
• 常用工具方法
• 开发流程检查清单
• 常见问题解决
• 工具和脚本

适用场景:

• 快速创建新模块
• 代码生成参考
• 开发规范检查
• 问题排查

🎨 frontend-standards.md

前端开发范式，基于 Vue 3 + TypeScript + Arco Design + Vite。

主要内容:

• 项目概述和技术栈
• 项目结构说明
• 组件开发模式
• API 调用模式
• 状态管理模式
• 自定义 Hooks 模式
• 权限控制模式
• HTTP 请求模式
• 路由配置模式
• 组件使用示例
• 配置管理
• 样式管理
• 最佳实践

适用场景:

• 前端开发参考
• 组件开发指导
• 状态管理规范
• API 调用规范

📦 dependencies.md

依赖引用规范，优先使用 continew-starter 内置模块和 Hutool 工具类。

主要内容:

• 依赖引用核心原则
• Continew-Starter 模块清单（40+ 个模块）
• Hutool 工具类优先规范
• 第三方依赖推荐（WxJava、支付宝等）
• 依赖管理最佳实践

适用场景:

• 选择依赖时参考
• 工具类使用规范
• 版本管理指导

📊 response-format.md

详细的响应格式说明，包括通用响应和分页响应。

主要内容:

• R 类结构和字段说明
• PageResp 类结构和字段说明
• 配置来源和使用示例
• 常见错误和正确格式
• 异常响应格式

适用场景:

• 理解响应格式
• 接口开发参考
• 前后端联调

📖 参考手册 (reference.md)

技能索引和快速参考，便于快速查阅。

主要内容:

• 技术栈详情
• 开发指南快速参考
• 命名规范
• 权限标识规范
• 接口规范
• 常见问题

适用场景:

• 快速查阅
• 规范参考
• 新手入门

技术栈详情

核心依赖

支持的数据库

• MySQL 8.x
• PostgreSQL（兼容）

快速开始

1. 了解项目架构

# 阅读完整的开发指南
cat development-guide.md

2. 创建新模块

# 参考代码模板
cat code-templates.md

3. 查看快速参考

# 查看参考手册
cat reference.md

使用场景

🎯 场景一：新手入门

1. 阅读 development-guide.md 了解项目架构
2. 学习模块结构和分层设计
3. 实践标准的开发流程
4. 参考最佳实践编写代码

🎯 场景二：快速开发

1. 查阅 code-templates.md 获取代码模板
2. 复制并修改相关模板
3. 按照开发流程检查清单操作
4. 验证代码质量和规范

🎯 场景三：代码审查

1. 使用开发指南中的规范进行代码审查
2. 检查命名规范、注解使用、权限配置等
3. 参考最佳实践进行改进建议
4. 确保代码符合项目标准

🎯 场景四：问题排查

1. 查看常见问题解决方案
2. 检查配置文件和参数
3. 查看日志和调试信息
4. 参考官方文档和社区资源

核心概念

分层架构

Controller (API 层)
    ↓
Service (业务层)
    ↓
Mapper (数据访问层)
    ↓
Database (数据库)

Model 四层模型

Entity (实体) - 映射数据库表
Query (查询) - 查询参数
Req (请求) - 创建/更新请求
Resp (响应) - 列表/详情响应

权限标识

模块:资源:操作
system:user:create  # 创建用户
system:user:update  # 更新用户
system:user:delete  # 删除用户

最佳实践速查

✅ 推荐

• 使用 @RequiredArgsConstructor 进行依赖注入
• 使用 @Validated 进行参数校验
• 使用 @CrudRequestMapping 快速定义 CRUD 接口
• 使用四层模型设计 DTO
• 使用逻辑删除而不是物理删除
• 使用分布式 ID 生成器
• 遵循命名规范

❌ 避免

• 不要在 Controller 中直接访问数据库
• 不要省略参数校验
• 不要在 Service 中直接返回 Entity
• 不要忽略权限检查
• 不要在生产环境开启 SQL 日志
• 不要硬编码配置参数

开发流程

需求分析
    ↓
数据库设计
    ↓
代码生成
    ↓
业务实现
    ↓
权限配置
    ↓
测试验证
    ↓
部署上线

常见问题

Q: 如何快速创建一个 CRUD 模块？

A: 参考 code-templates.md 中的完整模板。

Q: 如何添加新的权限码？

A: 在数据库 sys_menu 表中配置，使用 @SaCheckPermission 注解。

Q: 如何配置多数据源？

A: 在 application.yml 中配置 spring.datasource.dynamic。

Q: 如何进行性能优化？

A: 使用 JetCache 缓存、批量操作、合理索引。

相关资源

• ContiNew Admin 官方文档
• ContiNew Starter 文档
• MyBatis-Plus 文档
• Sa-Token 文档
• Spring Boot 参考
• 项目 GitHub

项目结构

continew-admin-skill/
├── SKILL.md                 # 本文件 - 技能说明
├── development-guide.md     # 完整开发指南
├── code-templates.md        # 代码模板集合
├── response-format.md       # 响应格式说明
├── dependencies.md          # 依赖引用规范
├── frontend-standards.md    # 前端开发范式
└── reference.md             # 参考手册

更新日志

2024-06-09

• ✨ 创建初始技能包
• 📝 添加完整的开发指南
• 🛠️ 添加代码模板集合
• 📊 添加响应格式说明（修正了响应格式描述）
• 📦 添加依赖引用规范（优先使用 continew-starter 和 Hutool）
• 🎨 添加前端开发范式（Vue3 + TypeScript + Arco Design）
• 📖 创建参考手册

贡献

如有改进建议或发现问题，欢迎提交 Issue 或 Pull Request。

许可证

MIT License

创建时间: 2024-06-09 维护者: seewe 版本: 1.0.0 技能包格式: 标准 SKILL.md 格式