com.example.project
│
├── bean                      # 實體類統(tǒng)一目錄
│   ├── entity                # 數(shù)據(jù)庫實體
│   ├── vo                    # 接口返回對象
│   ├── dto                   # 接口接收參數(shù)
│   ├── bo                    # 業(yè)務(wù)層聚合對象
│   ├── doc                   # MongoDB 文檔實體
│   ├── cache                 # 緩存實體對象
│   ├── index                 # ES 索引實體
│   ├── message               # MQ 消息體
│   └── event                 # Spring 事件對象
├── controller                # Web 接口層
├── service                   # 業(yè)務(wù)邏輯接口
│   └── impl                  # 業(yè)務(wù)邏輯實現(xiàn)
├── mapper                    # 數(shù)據(jù)訪問層
├── biz                       # 業(yè)務(wù)聚合處理
├── client                    # Feign 客戶端
├── convert                   # 對象轉(zhuǎn)換器
├── aspect                    # AOP 切面
├── config                    # 配置類
├── constant                  # 常量類
├── enums                     # 枚舉類
├── exception                 # 自定義異常
├── util                      # 工具類目錄（含 Util 和 Kit）
└── job                       # 定時任務(wù)
    ├── XxxJob.java
    └── XxxHelper.java        # 輔助類，放在對應(yīng)功能包內(nèi)

// 保存用戶：接收 Dto，返回 Vo
@PostMapping("/save")
public SysUserVo saveUser(@RequestBody @Valid SysUserSaveDto dto) {
    SysUserPo po = userConvert.toPo(dto);
    userMapper.insert(po);
    return userConvert.toVo(po);
}

@RestController
public class UserController {
    
    @PostMapping("/login")
    public Result login(@RequestBody LoginRequest request) {
        // ...
    }
    
    // 內(nèi)部類，僅用于當(dāng)前 Controller
    static class LoginRequest {
        private String username;
        private String password;
    }
}

// 放在使用它的 Service 同包下，但不屬于標(biāo)準(zhǔn) bean 類型
// service/OrderStatContext.java
public class OrderStatContext {
    private Long userId;
    private LocalDateTime startTime;
    private LocalDateTime endTime;
    // 訂單統(tǒng)計的中間計算對象
}

public class DateUtil {
    public static String format(LocalDateTime date, String pattern) {
        // 靜態(tài)方法，不依賴 Spring
    }
}
// 使用
String dateStr = DateUtil.format(now, "yyyy-MM-dd");

@Component
public class RedisKit {
    @Autowired
    private RedisTemplate<String, Object> redisTemplate;
    
    public Object get(String key) {
        return redisTemplate.opsForValue().get(key);
    }
}
// 使用
@Service
public class UserService {
    @Autowired
    private RedisKit redisKit;
}

// job/JobHelper.java
@Component
public class JobHelper {
    @Autowired
    private MailService mailService;
    
    public void sendAlert(String jobName, Exception e) {
        mailService.send("Job Alert", jobName + " 執(zhí)行失?。? + e.getMessage());
    }
}