# ounce

**Repository Path**: wqscms/ounce

## Basic Information

- **Project Name**: ounce
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-08
- **Last Updated**: 2026-02-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Redis缓存工具类 - 高频使用，提升开发效率
API文档集成(Knife4j) - 必备的接口文档工具
文件上传下载 - 几乎所有项目都需要
Excel导入导出 - 数据处理必备
数据字典管理 - 标准中后台功能
操作日志持久化 - 审计需求
代码生成器 - 提升开发效率

务代码组织结构
1️⃣ 核心原则：按业务模块划分
根据您的数据库表，业务代码应该放在 ounce-plugin 下的各个插件模块中：
plaintext
ounce-plugin/
├── ounce-plugin-sys/      # 系统管理模块（核心业务）
│   └── src/main/java/com/ounce/sys/
│       ├── modular/       # 业务模块目录（重点）
│       │   ├── config/    # 系统配置管理（对应 sys_config 表）
│       │   │   ├── controller/
│       │   │   ├── service/
│       │   │   ├── mapper/
│       │   │   └── entity/
│       │   ├── dict/      # 数据字典管理（对应 sys_dict 表）
│       │   ├── email/     # 邮件管理（对应 sys_email 表）
│       │   ├── file/      # 文件管理（对应 sys_file 表）
│       │   ├── log/       # 日志管理（对应 sys_log 表）
│       │   ├── message/   # 消息管理（对应 sys_message 表）
│       │   ├── org/       # 组织管理（对应 sys_org 表）
│       │   ├── position/  # 职位管理（对应 sys_position 表）
│       │   ├── resource/  # 资源权限管理（对应 sys_resource 表）
│       │   ├── role/      # 角色管理（对应 sys_role 表）
│       │   └── user/      # 用户管理（对应 sys_user 表）
│       └── core/          # 系统核心配置（非业务）
│
├── ounce-plugin-dev/      # 开发工具模块
│   └── src/main/java/com/ounce/dev/
│       └── modular/
│           └── gen/       # 代码生成（对应 gen_basic、gen_config 表）
│
└── ounce-plugin-ai/       # AI功能模块（后续扩展）
    └── src/main/java/com/ounce/ai/
        └── modular/
2️⃣ 单个业务模块的标准结构
以 用户管理（sys_user） 为例：
plaintext
ounce-plugin-sys/src/main/java/com/ounce/sys/modular/user/
├── controller/
│   └── SysUserController.java       # 控制器：处理HTTP请求
├── service/
│   ├── SysUserService.java          # 服务接口：定义业务方法
│   └── impl/
│       └── SysUserServiceImpl.java  # 服务实现：业务逻辑
├── mapper/
│   └── SysUserMapper.java           # Mapper接口：数据库操作
├── entity/
│   ├── SysUser.java                 # 实体类：对应数据库表
│   ├── dto/                         # 数据传输对象
│   │   ├── SysUserAddDTO.java       # 新增用户DTO
│   │   ├── SysUserUpdateDTO.java    # 更新用户DTO
│   │   └── SysUserQueryDTO.java     # 查询用户DTO
│   └── vo/                          # 视图对象
│       └── SysUserVO.java           # 用户视图VO
└── enums/                           # 该模块专用枚举
    └── UserStatusEnum.java          # 用户状态枚举
对应的 Mapper XML 文件：
plaintext
ounce-plugin-sys/src/main/resources/mapper/user/
└── SysUserMapper.xml                # SQL映射文件
3️⃣ 模块依赖关系
plaintext
ounce-start（启动模块）
    ↓ 依赖
ounce-plugin-sys（系统模块）
ounce-plugin-dev（开发工具模块）
ounce-plugin-ai（AI模块）
    ↓ 依赖
ounce-framework（基础框架）
    - 提供通用工具类、异常处理、分页等
4️⃣ 数据库表与业务模块映射
数据库表	业务模块路径	功能说明
sys_config	ounce-plugin-sys/modular/config	系统配置管理
sys_dict	ounce-plugin-sys/modular/dict	数据字典管理
sys_email	ounce-plugin-sys/modular/email	邮件管理
sys_file	ounce-plugin-sys/modular/file	文件管理
sys_log	ounce-plugin-sys/modular/log	操作日志
sys_message	ounce-plugin-sys/modular/message	消息管理
sys_sms	ounce-plugin-sys/modular/sms	短信管理
sys_org	ounce-plugin-sys/modular/org	组织机构
sys_position	ounce-plugin-sys/modular/position	职位管理
sys_resource	ounce-plugin-sys/modular/resource	资源权限
sys_role	ounce-plugin-sys/modular/role	角色管理
sys_user	ounce-plugin-sys/modular/user	用户管理
gen_basic、gen_config	ounce-plugin-dev/modular/gen	代码生成
5️⃣ 建议的开发顺序
根据依赖关系，建议按以下顺序开发：第一阶段：基础数据模块
✅ sys_dict（数据字典）- 其他模块会用到
✅ sys_config（系统配置）- 系统级配置
第二阶段：权限体系
✅ sys_org（组织机构）
✅ sys_position（职位）
✅ sys_role（角色）
✅ sys_resource（资源权限）
✅ sys_user（用户）- 依赖前面所有
第三阶段：功能模块
✅ sys_file（文件管理）
✅ sys_log（日志）
✅ sys_message（消息）
✅ sys_email（邮件）
✅ sys_sms（短信）
第四阶段：开发工具
✅ gen_basic、gen_config（代码生成器）
6️⃣ 代码生成器方案
由于您有现成的数据库表，强烈建议：使用 MyBatis-Plus 代码生成器或 IDEA 插件生成基础代码
自动生成 Entity、Mapper、Service、Controller
节省大量重复编码工作
保证代码规范统一
推荐工具：
MyBatis X 插件（IDEA插件）- 可视化操作，直接连数据库生成
EasyCode 插件（IDEA插件）- 自定义模板
MyBatis-Plus Generator（代码方式）- 可编程控制
🎯 总结
业务代码位置：
📂 ounce-plugin/ounce-plugin-sys/src/main/java/com/ounce/sys/modular/ - 系统管理相关
📂 ounce-plugin/ounce-plugin-dev/src/main/java/com/ounce/dev/modular/ - 开发工具相关
标准结构：每个业务模块包含 controller → service → mapper → entity 四层建议：先实现数据字典和系统配置等基础模块，再逐步完成用户权限体系。需要我帮您生成第一个业务模块的完整代码示例吗（比如从 sys_dict 开始）？