// 對(duì)應(yīng)數(shù)據(jù)庫(kù)表 `user`
import javax.persistence.*;
import java.util.Date;

@Entity
@Table(name = "user")
public class UserPO {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(name = "username")
    private String username;
    
    @Column(name = "password")
    private String password;
    
    @Column(name = "email")
    private String email;
    
    @Column(name = "create_time")
    private Date createTime;
    
    @Column(name = "update_time")
    private Date updateTime;
    
    // 只有g(shù)etter/setter，沒(méi)有業(yè)務(wù)方法
    // getter/setter...
}

// 業(yè)務(wù)對(duì)象 - 組合多個(gè)實(shí)體完成業(yè)務(wù)場(chǎng)景
public class OrderBO {
    // 組合多個(gè)DO/PO
    private OrderDO order;           // 訂單信息
    private List<OrderItemDO> items; // 訂單項(xiàng)列表
    private UserDO user;             // 用戶(hù)信息
    private AddressDO address;       // 收貨地址
    
    // 業(yè)務(wù)方法
    public BigDecimal calculateTotalAmount() {
        BigDecimal total = BigDecimal.ZERO;
        for (OrderItemDO item : items) {
            total = total.add(item.getPrice().multiply(new BigDecimal(item.getQuantity())));
        }
        // 可能還有優(yōu)惠券、運(yùn)費(fèi)等計(jì)算
        return total;
    }
    
    public boolean isAvailable() {
        return order.getStatus() == 1 && user.isActive();
    }
    
    public void applyCoupon(CouponDO coupon) {
        // 應(yīng)用優(yōu)惠券的業(yè)務(wù)邏輯
        if (coupon.isValid() && calculateTotalAmount().compareTo(coupon.getMinAmount()) >= 0) {
            // 應(yīng)用優(yōu)惠
        }
    }
    
    // getter/setter...
}

// 用于Service層返回給Controller層的數(shù)據(jù)
public class UserDTO {
    private Long id;
    private String username;
    private String email;
    private String statusDesc; // 狀態(tài)描述（非數(shù)據(jù)庫(kù)字段）
    private Date createTime;
    
    // 通常只有g(shù)etter/setter，沒(méi)有業(yè)務(wù)邏輯
    // getter/setter...
    
    // 轉(zhuǎn)換方法（可選）
    public static UserDTO fromDO(UserDO userDO) {
        if (userDO == null) return null;
        
        UserDTO dto = new UserDTO();
        dto.setId(userDO.getId());
        dto.setUsername(userDO.getUsername());
        dto.setEmail(userDO.getEmail());
        dto.setCreateTime(userDO.getCreateTime());
        
        // 狀態(tài)碼轉(zhuǎn)描述
        dto.setStatusDesc(userDO.getStatus() == 1 ? "正常" : "禁用");
        
        return dto;
    }
}

// 專(zhuān)門(mén)為前端頁(yè)面定制的對(duì)象
public class UserVO {
    private Long userId;          // 前端需要的字段名
    private String userName;      // 前端需要的字段名
    private String userEmail;
    private String createTime;    // 格式化的字符串，非Date類(lèi)型
    private String lastLoginTime; // 可能來(lái)自其他表的數(shù)據(jù)
    private Integer orderCount;   // 聚合數(shù)據(jù)
    
    // 可能包含前端需要的特定字段
    private Boolean canEdit;
    private String avatarUrl;
    
    // 轉(zhuǎn)換方法
    public static UserVO fromDTO(UserDTO userDTO, UserStatsDTO stats) {
        UserVO vo = new UserVO();
        vo.setUserId(userDTO.getId());
        vo.setUserName(userDTO.getUsername());
        vo.setUserEmail(userDTO.getEmail());
        
        // 格式化日期
        vo.setCreateTime(DateUtil.format(userDTO.getCreateTime(), "yyyy-MM-dd HH:mm:ss"));
        
        // 組合其他數(shù)據(jù)
        vo.setOrderCount(stats.getOrderCount());
        vo.setLastLoginTime(DateUtil.format(stats.getLastLoginTime(), "yyyy-MM-dd HH:mm:ss"));
        
        // 業(yè)務(wù)邏輯判斷
        vo.setCanEdit("正常".equals(userDTO.getStatusDesc()));
        
        return vo;
    }
    
    // getter/setter...
}

// 數(shù)據(jù)庫(kù)表對(duì)應(yīng)的PO
public class UserPO { /* 同上 */ }
public class OrderPO { /* 訂單表映射 */ }
public class OrderItemPO { /* 訂單項(xiàng)表映射 */ }
public class AddressPO { /* 地址表映射 */ }

@Repository
public class OrderDao {
    public OrderPO findById(Long orderId) {
        // 使用MyBatis/JPA查詢(xún)數(shù)據(jù)庫(kù)，返回PO
        return orderMapper.selectById(orderId);
    }
}

// 各個(gè)領(lǐng)域?qū)ο蟀约旱臉I(yè)務(wù)邏輯
public class UserDO { /* 包含用戶(hù)相關(guān)業(yè)務(wù)方法 */ }
public class OrderDO { /* 包含訂單相關(guān)業(yè)務(wù)方法 */ }

@Service
public class OrderService {
    
    public OrderBO getOrderDetail(Long orderId) {
        // 1. 查詢(xún)多個(gè)PO
        OrderPO orderPO = orderDao.findById(orderId);
        List<OrderItemPO> itemPOs = orderItemDao.findByOrderId(orderId);
        UserPO userPO = userDao.findById(orderPO.getUserId());
        
        // 2. PO轉(zhuǎn)DO（可能包含業(yè)務(wù)邏輯初始化）
        OrderDO orderDO = convertToDO(orderPO);
        UserDO userDO = convertToDO(userPO);
        
        // 3. 創(chuàng)建BO（業(yè)務(wù)對(duì)象）
        OrderBO orderBO = new OrderBO();
        orderBO.setOrder(orderDO);
        orderBO.setUser(userDO);
        orderBO.setItems(convertToDOs(itemPOs));
        
        // 4. 執(zhí)行業(yè)務(wù)邏輯
        if (!orderBO.isAvailable()) {
            throw new BusinessException("訂單不可用");
        }
        
        return orderBO;
    }
}

@RestController
public class OrderController {
    
    @Autowired
    private OrderService orderService;
    
    @GetMapping("/orders/{orderId}")
    public Result<OrderDTO> getOrderDetail(@PathVariable Long orderId) {
        // 1. 調(diào)用Service獲取BO
        OrderBO orderBO = orderService.getOrderDetail(orderId);
        
        // 2. BO轉(zhuǎn)DTO（數(shù)據(jù)傳輸對(duì)象）
        OrderDTO orderDTO = convertBOToDTO(orderBO);
        
        return Result.success(orderDTO);
    }
    
    private OrderDTO convertBOToDTO(OrderBO bo) {
        OrderDTO dto = new OrderDTO();
        // 拷貝基礎(chǔ)字段
        BeanUtil.copyProperties(bo.getOrder(), dto);
        
        // 計(jì)算展示字段
        dto.setTotalAmount(bo.calculateTotalAmount());
        dto.setItemCount(bo.getItems().size());
        
        return dto;
    }
}

// 前端需要的特定數(shù)據(jù)結(jié)構(gòu)
public class OrderVO {
    private String orderNumber;    // 格式化訂單號(hào)
    private String customerName;   // 客戶(hù)姓名
    private String totalAmount;    // 格式化的金額："￥199.00"
    private List<OrderItemVO> items; // 定制化的訂單項(xiàng)
    private String statusText;     // 狀態(tài)文本
    private String createTime;     // 格式化時(shí)間
    // ... 其他前端特定字段
}

@RestController
public class OrderController {
    
    @GetMapping("/api/v1/orders/{orderId}")
    public Result<OrderVO> getOrderForFrontend(@PathVariable Long orderId) {
        // 1. 獲取DTO
        OrderDTO orderDTO = orderService.getOrderDetail(orderId);
        
        // 2. DTO轉(zhuǎn)VO（為前端定制）
        OrderVO orderVO = convertDTOToVO(orderDTO);
        
        return Result.success(orderVO);
    }
}

// 簡(jiǎn)單項(xiàng)目可以PO、DO合一
@Entity
public class User {
    @Id
    private Long id;
    private String username;
    
    // 也可以包含簡(jiǎn)單業(yè)務(wù)方法
    public boolean isActive() {
        return status == 1;
    }
}

// 甚至可以PO、DTO、VO合一（不推薦用于正式項(xiàng)目）