添加开发规和skill

.kiro/steering/code-with-standards.md

@@ -0,0 +1,27 @@
+---
+inclusion: always
+---
+
+# 项目规范执行指引
+
+## 方案讨论前
+
+必读 `#[[file:.kiro/steering/项目结构说明.md]]`，全面了解：
+- 三层模块职责与依赖关系：`client-api` → `manager` → `common`
+- 所有业务实体及其关联
+- 权限体系设计、邀请模块设计
+- 现有的公共能力（工具类、配置、拦截器），避免重复造轮子
+
+方案讨论时，说明涉及哪些现有模块和实体，新增内容放在哪个模块，做好解耦。
+
+## 开发方案输出前 / 写代码前
+
+必读 `#[[file:.kiro/steering/代码开发风格文档.md]]`，严格遵守：
+- 命名约定、注解与依赖注入规范
+- POJO 分包规则（dto/vo/po/param 按功能模块建子目录）
+- Service 类注释规范（主要功能、依赖服务、使用的表、方法逻辑流程）
+- 接口规范、异常处理、Redis 使用、数据库设计风格、分页规范
+
+## 写完代码后
+
+涉及新增文件、新增模块或目录结构变更时，必须同步更新 `#[[file:.kiro/steering/项目结构说明.md]]`，保持文档与实际代码一致。

.kiro/steering/代码开发风格文档.md

@@ -1,5 +1,5 @@
 ---
-inclusion: always
+inclusion: manual
 ---
 
 # 代码开发风格文档
@@ -11,12 +11,12 @@ inclusion: always
 - `common` — 公共模块：配置、拦截器、工具类、统一响应、异常体系
 - `client-api` — C 端接口模块，依赖 manager
 - `manager` — 业务共享模块：实体、Mapper、业务服务，B 端和 C 端共用，依赖 common
-- 各模块内按职责分包：`controller`、`server`、`pojo`（dto/vo/po/param）、`mapper`、`config`、`aop`、`annotation`、`tool`、`constant`、`interceptor`
+- 各模块内按职责分包：`controller`、`service`、`pojo`（dto/vo/po/param）、`mapper`、`config`、`aop`、`annotation`、`tool`、`constant`、`interceptor`
 
 ## 命名约定
 
 ### 类命名
-- 服务层以 `Server` 结尾（不用 Service），如 `LoginServer`、`SmsServer`
+- 服务层以 `Service` 结尾，如 `LoginService`、`SmsService`
 - DTO 以 `Dto` 结尾，VO 以 `Vo` 结尾，Param 以 `Param` 结尾，PO 无后缀直接用业务名
 - Controller 以 `Controller` 结尾
 - 工具类以 `Tool` 结尾，如 `RedisServerTool`、`HttpIpTool`
@@ -32,7 +32,7 @@ inclusion: always
 ## 注解与依赖注入
 
 - Controller 层：`@RestController` + `@RequestMapping`，构造器注入（`@AllArgsConstructor`）
-- Server 层：`@Service`，字段注入（`@Autowired`）
+- Service 层：`@Service`，字段注入（`@Autowired`）
 - 配置值：`@Value("${app.xxx:默认值}")`，始终提供默认值
 - 参数校验：类上 `@Validated`，字段上 `@NotBlank`、`@Pattern` 等
 - 写操作方法加 `@Transactional(rollbackFor = Exception.class)`
@@ -48,13 +48,13 @@ inclusion: always
 - 类注释说明对应的表名和用途
 - 特殊字段（状态码、标志位、枚举值等）在注释中说明每个值的含义，如 `/** 状态 0=正常 1=禁用 */`
 
-### Server 类注释
+### Service 类注释
 - 类注释说明该服务的主要功能
 - 类注释中列出依赖的其他模块/服务，以及使用到的表和使用目的，格式示例：
   ```java
   /**
    * 登录服务
-   * <p>依赖：SmsServer（验证码发送与校验）、UserRegisterServer（自动注册）</p>
+   * <p>依赖：SmsService（验证码发送与校验）、UserRegisterService（自动注册）</p>
    * <p>使用表：bg_user（查询/创建用户）</p>
    *
    * @author zk
@@ -70,7 +70,7 @@ inclusion: always
 
 ## POJO 规范
 
-- DTO：入参对象 + 校验注解，放在 `pojo/dto/{功能模块}/` 下，功能模块一般是对应 Server 类名的简写，如 `pojo/dto/login/SmsLoginDto.java`
+- DTO：入参对象 + 校验注解，放在 `pojo/dto/{功能模块}/` 下，功能模块一般是对应 Service 类名的简写，如 `pojo/dto/login/SmsLoginDto.java`
 - VO：出参对象，放在 `pojo/vo/{功能模块}/` 下，如 `pojo/vo/login/LoginVo.java`
 - PO：对应数据库表字段，统一放在 `manager` 模块的 `pojo/po/` 下
 - Param：查询参数对象，放在 `pojo/param/{功能模块}/` 下
@@ -89,7 +89,7 @@ inclusion: always
 
 ## 接口规范
 
-- Controller 只负责参数接收和调用 Server，不写业务逻辑
+- Controller 只负责参数接收和调用 Service，不写业务逻辑
 - 无需鉴权的接口放在 `/public` 前缀下
 - POST 用 `@PostMapping`，GET 用 `@GetMapping` ...
 - 复杂参数 `@Validated @RequestBody`，简单参数 `@RequestParam`
@@ -103,7 +103,7 @@ inclusion: always
 
 ## Redis 使用规范
 
-- 统一通过 `RedisServerTool` 操作，不直接使用 `RedisTemplate`
+- 统一通过 `RedisServiceTool` 操作，不直接使用 `RedisTemplate`
 - key 自动拼接应用名前缀：`{appName}:{业务key}`
 - 值统一 JSON 序列化
 - 设置 TTL 时使用 `TimeUnit` 明确单位

.kiro/steering/项目结构说明.md

@@ -1,3 +1,7 @@
+---
+inclusion: manual
+---
+
 # OfferPie Back‑End 项目结构说明
 @zk
 ## 1️⃣ 项目整体层次
@@ -18,11 +22,11 @@ offerpie/back-end
 │           ├─ controller/
 │           │   ├─ LoginController.java    # 登录相关接口（发送验证码、短信登录）
 │           │   └─ RouteMenuController.java # 路由菜单接口（获取用户有效菜单树）
-│           ├─ server/
+│           ├─ service/
-│           │   ├─ LoginServer.java        # 登录业务逻辑（验证码校验、自动注册、JWT生成、Cookie设置）
+│           │   ├─ LoginService.java        # 登录业务逻辑（验证码校验、自动注册、JWT生成、Cookie设置）
-│           │   ├─ UserRegisterServer.java # 用户注册服务（注册逻辑、邀请码生成与绑定）
+│           │   ├─ UserRegisterService.java # 用户注册服务（注册逻辑、邀请码生成与绑定）
-│           │   ├─ FuncPermissionServer.java  # 功能权限服务（校验、扣减、查询、添加库存、回退）
+│           │   ├─ FuncPermissionService.java  # 功能权限服务（校验、扣减、查询、添加库存、回退）
-│           │   ├─ RouteMenuServer.java    # 路由菜单服务（查询、添加库存、获取用户菜单树）
+│           │   ├─ RouteMenuService.java    # 路由菜单服务（查询、添加库存、获取用户菜单树）
 │           │   └─ WxPayNotifyMessageAbstractImpl.java  # 微信支付回调实现
 │           └─ pojo/
 │               ├─ dto/
@@ -71,16 +75,16 @@ offerpie/back-end
             │   │   ├─ UserFuncPermissionStock.java   # 用户功能权限库存表（bg_user_func_permission_stock）
             │   │   └─ UserFuncUsageLog.java          # 用户功能使用记录表（bg_user_func_usage_log）
             │   └─ vo/               # ViewObject（OssUrlVo 等）
-            └─ server/               # 业务 Service（OssServer、SmsServer 等）
+            └─ service/               # 业务 Service（OssService、SmsService 等）
 ```
 > **设计理念** – 业务实体和 Mapper 位于 `manager`，B 端和 C 端共享；C 端特有的注解、切面、权限服务、路由菜单服务位于 `client-api`，避免 B 端误用；`common` 提供统一的技术支撑。
 
 ## 2️⃣ 各层模块职责
 | 层级 | 主要职责 | 关键类/包 |
 |------|----------|-----------|
-| **client-api** | - 面向终端用户的 REST API <br> - 启动 Spring Boot 应用 <br> - 短信验证码登录（含自动注册、邀请码绑定） <br> - **功能权限校验**：注解 + 切面 + 权限服务（校验、扣减、回退） <br> - **路由菜单**：获取用户有效菜单树 | `ClientApplication`、`LoginController`、`RouteMenuController`、`FuncPermission`、`FuncPermissionAspect`、`FuncPermissionServer`、`RouteMenuServer`、`UserRegisterServer`、`RouteMenuVo` |
+| **client-api** | - 面向终端用户的 REST API <br> - 启动 Spring Boot 应用 <br> - 短信验证码登录（含自动注册、邀请码绑定） <br> - **功能权限校验**：注解 + 切面 + 权限服务（校验、扣减、回退） <br> - **路由菜单**：获取用户有效菜单树 | `ClientApplication`、`LoginController`、`RouteMenuController`、`FuncPermission`、`FuncPermissionAspect`、`FuncPermissionService`、`RouteMenuService`、`UserRegisterService`、`RouteMenuVo` |
 | **common** | - **统一配置**：OSS、Redis、Security、WxPay、Sms 等 <br> - **跨层工具**：HTTP、IP、认证、验证码、Redis Server 等 <br> - **全局拦截/切面**：日志、TraceId、黑名单、SQL 打印 <br> - **统一异常/响应**：`GlobalExceptionAdvice`、`UnifiedResponse` <br> - **业务抽象**：邮件发送、微信支付（Native/JS/Transfer） <br> - **公共 POJO**：登录令牌、防重放信息等 | `config/`, `tool/`, `interceptor/`, `aop/`, `exception/`, `email/`, `wxPay/`, `pojo/` |
-| **manager** | - **业务实体**（`User`、`OssFile`、`UserInvite`、`RouteMenu`、`FuncPermission`、`UserRouteMenuStock`、`UserFuncPermissionStock`、`UserFuncUsageLog`） <br> - **MyBatis Mapper**（`UserMapper`、`OssFileMapper`、`UserInviteMapper`、`RouteMenuMapper`、`FuncPermissionMapper`、`UserRouteMenuStockMapper`、`UserFuncPermissionStockMapper`、`UserFuncUsageLogMapper`） <br> - **业务 API**：文件上传/下载、健康检查等 <br> - **业务逻辑**：服务层、工具类等 <br> - **既供 B 端 UI（待实现）使用，也供 C 端业务直接调用** | `controller/`, `mapper/`, `pojo/po/`, `pojo/vo/`, `server/`, `constant/` |
+| **manager** | - **业务实体**（`User`、`OssFile`、`UserInvite`、`RouteMenu`、`FuncPermission`、`UserRouteMenuStock`、`UserFuncPermissionStock`、`UserFuncUsageLog`） <br> - **MyBatis Mapper**（`UserMapper`、`OssFileMapper`、`UserInviteMapper`、`RouteMenuMapper`、`FuncPermissionMapper`、`UserRouteMenuStockMapper`、`UserFuncPermissionStockMapper`、`UserFuncUsageLogMapper`） <br> - **业务 API**：文件上传/下载、健康检查等 <br> - **业务逻辑**：服务层、工具类等 <br> - **既供 B 端 UI（待实现）使用，也供 C 端业务直接调用** | `controller/`, `mapper/`, `pojo/po/`, `pojo/vo/`, `service/`, `constant/` |
 
 ## 3️⃣ 关键业务实体
 | 实体 | 所属模块 | 作用概述 |
@@ -164,4 +168,4 @@ offerpie/back-end
 ### 核心逻辑
 - 用户注册时自动生成10位邀请码（大写字母+数字），存入 `User.invite_code`，碰撞检查最多重试3次
 - 注册时可携带 `inviteCode`，有效则写入邀请记录，无效仅日志警告不阻断注册
-- 注册逻辑由 `UserRegisterServer` 独立承担，`LoginServer` 委托调用
+- 注册逻辑由 `UserRegisterService` 独立承担，`LoginService` 委托调用

client-api/src/main/java/org/jiayunet/aop/FuncPermissionAspect.java

@@ -5,7 +5,7 @@ import org.aspectj.lang.ProceedingJoinPoint;
 import org.aspectj.lang.annotation.Around;
 import org.aspectj.lang.annotation.Aspect;
 import org.jiayunet.annotation.FuncPermission;
-import org.jiayunet.server.FuncPermissionServer;
+import org.jiayunet.service.FuncPermissionService;
 import org.jiayunet.tool.UserSecurityTool;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Component;
@@ -22,7 +22,7 @@ import org.springframework.stereotype.Component;
 public class FuncPermissionAspect {
 
     @Autowired
-    private FuncPermissionServer funcPermissionServer;
+    private FuncPermissionService funcPermissionService;
 
     @Around("@annotation(funcPermission)")
     public Object check(ProceedingJoinPoint joinPoint, FuncPermission funcPermission) throws Throwable {
@@ -33,14 +33,14 @@ public class FuncPermissionAspect {
         log.info("功能权限校验 userId:{} funcCode:{}", userId, funcCode);
 
         // 校验权限 + 扣减库存，返回使用记录ID
-        Long logId = funcPermissionServer.checkAndDeduct(userId, funcCode);
+        Long logId = funcPermissionService.checkAndDeduct(userId, funcCode);
 
         // 放行，业务异常时回退使用记录和库存
         try {
             return joinPoint.proceed();
         } catch (Exception e) {
             log.warn("业务异常，回退使用记录 logId:{} userId:{} funcCode:{}", logId, userId, funcCode);
-            funcPermissionServer.rollbackUsage(logId, userId, funcCode);
+            funcPermissionService.rollbackUsage(logId, userId, funcCode);
             throw e;
         }
     }

client-api/src/main/java/org/jiayunet/controller/LoginController.java

@@ -3,7 +3,7 @@ package org.jiayunet.controller;
 import lombok.AllArgsConstructor;
 import org.jiayunet.pojo.dto.SmsLoginDto;
 import org.jiayunet.pojo.vo.LoginVo;
-import org.jiayunet.server.LoginServer;
+import org.jiayunet.service.LoginService;
 import org.springframework.validation.annotation.Validated;
 import org.springframework.web.bind.annotation.*;
 
@@ -22,17 +22,17 @@ import javax.validation.constraints.Pattern;
 @Validated
 public class LoginController {
 
-    private LoginServer loginServer;
+    private LoginService loginService;
 
     @PostMapping("/sms/sendCode")
     public boolean sendCode(@RequestParam @Pattern(regexp = "^1[3-9]\\d{9}$", message = "手机号格式不正确") String mobileNumber) {
-        return loginServer.sendCode(mobileNumber);
+        return loginService.sendCode(mobileNumber);
     }
 
     @PostMapping("/login/smsLogin")
     public LoginVo smsLogin(@Validated @RequestBody SmsLoginDto dto,
                             HttpServletRequest request,
                             HttpServletResponse response) {
-        return loginServer.smsLogin(dto.getMobileNumber(), dto.getCode(), dto.getInviteCode(), request, response);
+        return loginService.smsLogin(dto.getMobileNumber(), dto.getCode(), dto.getInviteCode(), request, response);
     }
 }

client-api/src/main/java/org/jiayunet/controller/RouteMenuController.java

@@ -2,7 +2,7 @@ package org.jiayunet.controller;
 
 import lombok.AllArgsConstructor;
 import org.jiayunet.pojo.vo.RouteMenuVo;
-import org.jiayunet.server.RouteMenuServer;
+import org.jiayunet.service.RouteMenuService;
 import org.jiayunet.tool.UserSecurityTool;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -20,7 +20,7 @@ import java.util.List;
 @AllArgsConstructor
 public class RouteMenuController {
 
-    private RouteMenuServer routeMenuServer;
+    private RouteMenuService routeMenuService;
 
     /**
      * 获取当前用户有效路由菜单（树形结构）
@@ -28,6 +28,6 @@ public class RouteMenuController {
     @GetMapping("/menu")
     public List<RouteMenuVo> getUserRoutes() {
         Long userId = UserSecurityTool.getUserId();
-        return routeMenuServer.getUserRoutes(userId);
+        return routeMenuService.getUserRoutes(userId);
     }
 }

client-api/src/main/java/org/jiayunet/service/FuncPermissionService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
@@ -25,7 +25,7 @@ import java.time.ZoneId;
  */
 @Service
 @Slf4j
-public class FuncPermissionServer {
+public class FuncPermissionService {
 
     @Autowired
     private FuncPermissionMapper funcPermissionMapper;

client-api/src/main/java/org/jiayunet/service/LoginService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.auth0.jwt.JWT;
 import com.auth0.jwt.algorithms.Algorithm;
@@ -39,7 +39,7 @@ import java.util.stream.Collectors;
  */
 @Service
 @Slf4j
-public class LoginServer {
+public class LoginService {
 
     @Value("${app.secret.token:youweiqingnian123}")
     private String secret;
@@ -51,7 +51,7 @@ public class LoginServer {
     private int deviceOnlineQuantity;
 
     @Autowired
-    private SmsServer smsServer;
+    private SmsService smsService;
 
     @Autowired
     private UserMapper userMapper;
@@ -60,7 +60,7 @@ public class LoginServer {
     private RedisServerTool redisServerTool;
 
     @Autowired
-    private UserRegisterServer userRegisterServer;
+    private UserRegisterService userRegisterService;
 
     /**
      * 发送短信验证码
@@ -72,7 +72,7 @@ public class LoginServer {
         String code = String.valueOf((int) ((Math.random() * 9 + 1) * 100000));
         variable.setCode(code);
 
-        return smsServer.send(mobileNumber, SmsTemplateEnum.UNIVERSAL, variable);
+        return smsService.send(mobileNumber, SmsTemplateEnum.UNIVERSAL, variable);
     }
 
     /**
@@ -84,7 +84,7 @@ public class LoginServer {
         Assert.hasText(code, "验证码不能为空");
 
         // 校验验证码
-        boolean verified = smsServer.verify(mobileNumber, SmsTemplateEnum.UNIVERSAL, code);
+        boolean verified = smsService.verify(mobileNumber, SmsTemplateEnum.UNIVERSAL, code);
         if (!verified) {
             throw new BusinessException(BusinessExpCodeEnum.UNKNOWN_ERROR, "验证码错误或已过期");
         }
@@ -94,7 +94,7 @@ public class LoginServer {
 
         // 用户不存在则自动注册
         if (user == null) {
-            user = userRegisterServer.register(mobileNumber, inviteCode);
+            user = userRegisterService.register(mobileNumber, inviteCode);
         }
 
         // 检查用户状态
@@ -147,7 +147,7 @@ public class LoginServer {
         redisServerTool.set(redisKey, info, tokenExceedTime, TimeUnit.SECONDS);
 
         // 清除验证码
-        smsServer.clear(mobileNumber, SmsTemplateEnum.UNIVERSAL);
+        smsService.clear(mobileNumber, SmsTemplateEnum.UNIVERSAL);
 
         // 设置Cookie
         Cookie cookie = new Cookie("Token", token);

client-api/src/main/java/org/jiayunet/service/RouteMenuService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
@@ -23,7 +23,7 @@ import java.util.stream.Collectors;
  */
 @Service
 @Slf4j
-public class RouteMenuServer {
+public class RouteMenuService {
 
     @Autowired
     private UserRouteMenuStockMapper userRouteMenuStockMapper;

client-api/src/main/java/org/jiayunet/service/UserRegisterService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import lombok.extern.slf4j.Slf4j;
@@ -23,7 +23,7 @@ import java.time.Instant;
  */
 @Service
 @Slf4j
-public class UserRegisterServer {
+public class UserRegisterService {
 
     /**
      * 邀请码字符集（大写字母+数字）

client-api/src/main/java/org/jiayunet/service/WxPayNotifyMessageAbstractImpl.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.wechat.pay.java.service.partnerpayments.nativepay.model.Transaction;
 import com.wechat.pay.java.service.refund.model.RefundNotification;

manager/src/main/java/org/jiayunet/controller/OssController.java

@@ -11,7 +11,7 @@ import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.multipart.MultipartFile;
 import org.jiayunet.constant.OssPathEnum;
 import org.jiayunet.pojo.vo.OssUrlVo;
-import org.jiayunet.server.OssServer;
+import org.jiayunet.service.OssService;
 
 import java.io.IOException;
 
@@ -23,7 +23,7 @@ import java.io.IOException;
 @AllArgsConstructor
 @Validated
 public class OssController {
-    private OssServer ossServer;
+    private OssService ossService;
 
 
     /**
@@ -34,7 +34,7 @@ public class OssController {
      */
     @GetMapping("/requestUploadUrl")
     public OssUrlVo requestUploadUrl(@RequestParam String fileName, @RequestParam OssPathEnum pathEnum){
-        return  ossServer.requestUploadUrl(fileName,pathEnum);
+        return  ossService.requestUploadUrl(fileName,pathEnum);
     }
 
     /**
@@ -47,7 +47,7 @@ public class OssController {
     public OssUrlVo simpleUpload(@RequestParam("file") MultipartFile file, @RequestParam OssPathEnum pathEnum) {
 
         try {
-            return ossServer.simpleUpload(file.getOriginalFilename(), pathEnum, file.getInputStream());
+            return ossService.simpleUpload(file.getOriginalFilename(), pathEnum, file.getInputStream());
         } catch (IOException e) {
             throw new RuntimeException(e);
         }

manager/src/main/java/org/jiayunet/service/OssService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.aliyun.oss.HttpMethod;
 import lombok.AllArgsConstructor;
@@ -27,7 +27,7 @@ import java.time.Instant;
 @Service
 @Slf4j
 @AllArgsConstructor
-public class OssServer {
+public class OssService {
 
 
     private AliOssAbility aliOssAbility;

manager/src/main/java/org/jiayunet/service/SmsService.java

@@ -1,4 +1,4 @@
-package org.jiayunet.server;
+package org.jiayunet.service;
 
 import com.fasterxml.jackson.databind.ObjectMapper;
 import lombok.extern.slf4j.Slf4j;
@@ -20,7 +20,7 @@ import java.util.concurrent.TimeUnit;
  */
 @Service
 @Slf4j
-public class SmsServer {
+public class SmsService {
 
     private static final String SMS_KEY_PREFIX = "sms:";