# secure-trace

**Repository Path**: bingWeb/secure-trace

## Basic Information

- **Project Name**: secure-trace
- **Description**: 新项目结构
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-05
- **Last Updated**: 2025-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# secure-trace

## **防伪码系统**

* trace-common 通用模块(非业务)
* trace-ruoyi ruoyi模块(公共管理后台)
* trace-domain 领域模块
* trace-app 应用模块
* trace-job 定时任务模块

## **领域模块包结构**
**dao**
  - 模块名称
    - entity 实体类包
    - mapper mybatis-plus mapper包

**service**
  - 模块名称 
    - Service 具体接口
    - impl Service实现类包

**model**
 - 模块名称
   - bo 业务实体类包(一般是继承业务实体类的扩展类)，非必须
   - dto 复用DTO，非必须
## **应用模块结构**
**controller**
- 模块名称
    - 具体业务类

**executor**
- 模块名称
    - query 查询服务
    - update 更新服务

**model**
- 模块名称
    - req 请求参数包
    - vo 响应参数包
   
## 常用实体类

* **Result** 通用响应实体
* **PageResult** 通用响应分页实体
* **PageReq** 通用分页请求实体（继承）
* **BaseErrorCodeEnum** 通用错误码枚举
* **IErrorCode** 错误码接口（自定义业务错误码的时候实现该接口）
* **IRedisService** redis统一使用该服务类禁止直接使用RedisTemplate
* **PageUtil** 可以把PageReq转换成具体的分页对象
* **AssertBusUtils** 业务断言，手动抛异常的时候推荐使用该工具类
* **UserContextHolder** front的接口可以通过该类获取登录的用户ID
* **BusinessException** 业务异常类

## 注意
* domain层不能引用其他service、mapper，解耦业务逻辑、避免循环依赖。跨表业务逻辑请使用executor。
* 禁止直接返回entity的实体类给前端，禁止直接使用entity实体类接收前端参数。
* front的接口分页不用PageResult，而是使用PageHelper不统计总数。返回当前分页list。