#UI/UX Pro Max — 设计智能系统

// 随手写的颜色常量
public class ThemeConstants {
    public static final String SIDEBAR_BG = "#2C3E50";
    public static final String MENU_ACTIVE = "#3498DB";
    public static final String MENU_TEXT = "#ECF0F1";
    // ... 硬编码一堆 hex，没有语义
}

/**
 * 语义化设计 Token — 来自 UI/UX Pro Max 设计系统
 * 配色方案：Dark Minimalism / Slate scale
 */
public enum DesignToken {
    // Surface 层级
    COLOR_SURFACE_DEFAULT("#0F172A"),        // slate-900 — 侧边栏底色
    COLOR_SURFACE_VARIANT("#1E293B"),        // slate-800 — 菜单项 hover
    COLOR_SURFACE_ELEVATED("#334155"),       // slate-700 — 弹出层

    // On-surface 层级
    COLOR_ON_SURFACE_PRIMARY("#F8FAFC"),     // slate-50 — 菜单文字
    COLOR_ON_SURFACE_SECONDARY("#94A3B8"),   // slate-400 — 次级文字/图标

    // 交互
    COLOR_PRIMARY("#3B82F6"),                // blue-500 — 选中态/CTA
    COLOR_ERROR("#EF4444"),                  // red-500 — 错误/删除
    COLOR_SUCCESS("#22C55E"),                // green-500 — 成功/在线

    // 排版
    FONT_FAMILY("Inter, system-ui, sans-serif"),
    FONT_SIZE_BASE(16),                      // body
    FONT_SIZE_SM(14),                        // 次级文字
    FONT_SIZE_LG(18),                        // 标题

    // 间距 (4pt 递增)
    SPACING_XS(4),
    SPACING_SM(8),
    SPACING_MD(16),
    SPACING_LG(24),
    SPACING_XL(32),

    // 动效
    DURATION_FAST(150),                      // hover 反馈
    DURATION_NORMAL(250),                    // 展开/收起
    BORDER_RADIUS(8);

    private final Object value;

    DesignToken(Object value) { this.value = value; }

    public String str() { return (String) value; }
    public int num() { return (Integer) value; }
}

// Controller 直接返回，没有错误码设计
@PostMapping("/users")
public ResponseEntity<?> createUser(@RequestBody CreateUserRequest req) {
    if (req.getName() == null || req.getName().isEmpty()) {
        return ResponseEntity.badRequest().body("名称错误");
    }
    // 错误信息不明确，前端不知道怎么展示
}

@PostMapping("/users")
public ResponseEntity<ApiResponse> createUser(@RequestBody @Valid CreateUserRequest req) {
    // Spring Validation 已处理字段校验
    // 业务层校验
    if (userService.existsByName(req.getName())) {
        // 错误信息：原因 + 修复路径
        throw new BusinessException(
            ErrorCode.USER_NAME_DUPLICATE,
            "用户名「%s」已被占用，请换一个用户名".formatted(req.getName())
        );
    }

    User user = userService.create(req);
    return ResponseEntity.ok(ApiResponse.success(user));
}

// 全局异常处理 — 统一错误格式
@RestControllerAdvice
public class ApiExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ApiResponse> handleValidation(MethodArgumentNotValidException ex) {
        List<FieldError> errors = ex.getBindingResult()
            .getFieldErrors()
            .stream()
            .map(e -> new FieldError(
                e.getField(),                     // 字段名 — 前端定位用
                e.getDefaultMessage()              // "手机号格式错误" — 原因 + 修复
            ))
            .toList();

        return ResponseEntity.badRequest()
            .body(ApiResponse.error(ErrorCode.VALIDATION_FAILED, "请检查表单中的错误", errors));
    }
}

// 统一错误响应体
public record ApiResponse(
    boolean success,
    String message,                               // 面向用户的摘要
    String errorCode,                             // 程序定位用
    List<FieldError> fieldErrors                  // 前端就近展示
) {
    // 字段级错误 — 前端在对应字段下方展示
    public record FieldError(String field, String message) {}
}

// DashboardService.java
@Service
public class DashboardService {

    public DashboardVO getDashboard(LocalDate from, LocalDate to) {
        List<DailyStats> stats = statsRepository.findByDateRange(from, to);

        return new DashboardVO(
            formatNumber(stats.stream().mapToLong(DailyStats::getRegistrations).sum()),
            formatNumber(stats.stream().mapToLong(DailyStats::getActiveUsers).sum()),
            formatCurrency(stats.stream().mapToDouble(DailyStats::getRevenue).sum()),
            stats.stream().map(this::toTrendPoint).toList()   // 给图表用
        );
    }

    // 数字格式化 — 来自 UX 准则 number-formatting
    private String formatNumber(long n) {
        return NumberFormat.getIntegerInstance(Locale.CHINA).format(n);
        // 输出：12,847 而不是 12847
    }

    private String formatCurrency(double n) {
        return NumberFormat.getCurrencyInstance(Locale.CHINA).format(n);
        // 输出：¥128,470.00
    }

    public record DashboardVO(
        String totalRegistrations,
        String activeUsers,
        String totalRevenue,
        List<TrendPoint> trend
    ) {}
}