leniu-dev 2.0.0

package/src/skills/project-navigator/SKILL.md

@@ -0,0 +1,211 @@
+---
+name: project-navigator
+description: |
+  当需要了解项目结构、查找文件、定位代码时自动使用此 Skill。提供 leniu 云食堂项目的精确导航。
+
+  触发场景：
+  - 询问某个功能/文件在哪里
+  - 新建模块时需要确认目录位置
+  - 查找参考代码（Controller/Service/Mapper/Entity 示例）
+  - 了解项目整体结构和模块划分
+  - 查找技能、命令、Hook 的位置
+
+  触发词：项目结构、文件在哪、代码位置、目录结构、模块在哪、参考代码、怎么找、哪个文件、路径、在哪里
+---
+
+# leniu 项目导航指南
+
+## 工程化配置项目
+
+```
+ai-engineering-init/      # 当前工作目录（本仓库根目录）
+├── CLAUDE.md              # 项目规范（核心约束必读）
+├── AGENTS.md              # Agent 配置文档
+├── .claude/
+│   ├── skills/            # 73 个技能模块
+│   ├── commands/          # 10 个快速命令（/dev /crud /check 等）
+│   ├── hooks/             # Hooks（skill-forced-eval.js 强制技能评估）
+│   └── docs/              # 开发文档
+└── .codex/skills/         # Codex CLI 技能同步目录
+```
+
+---
+
+## 后端 Java 项目
+
+**根路径**：由用户在 `CLAUDE.md` 中配置，各安装者路径不同
+
+### 业务模块（25 个 core-* 模块）
+
+| 模块 | 职责 |
+|------|------|
+| `core-order` | 订单管理 |
+| `core-menu` | 菜品管理 |
+| `core-marketing` | 营销（充值/优惠） |
+| `core-report` | 报表统计 |
+| `core-pay` | 支付 |
+| `core-account` | 账号管理 |
+| `core-merchant` | 商户配置 |
+| `core-customer` | 用户/员工 |
+| `core-device` | 设备管理 |
+| `core-attendance` | 考勤 |
+| `core-kitchen` / `core-backfield` | 后场厨房 |
+| `core-drp` | 供应链 |
+| `core-dorm` | 宿舍管理 |
+| `core-notice` | 通知消息 |
+| `core-open` | 开放接口 |
+| `core-nutrition` | 营养管理 |
+| `core-supermarket` | 超市 |
+| `core-common` / `core-base` | 公共基础 |
+| `core-auth` / `core-starter` | 认证/启动 |
+
+### 标准包结构（四层架构）
+
+```
+net.xnzn.core.{module}/
+├── controller/
+│   ├── web/          # Web 管理端（/api/v2/web/{module}）
+│   ├── mobile/       # 移动端（/api/v2/mobile/{module}）
+│   ├── android/      # 设备端（/api/v2/android/{module}）
+│   └── open/         # 开放接口（/api/v2/open/{module}）
+├── business/impl/    # Business 层（跨 Service 编排）
+├── service/impl/     # Service 层（单表 CRUD、事务）
+├── mapper/           # Mapper + XML（同目录！非 resources/mapper/）
+├── model/            # Entity
+├── vo/               # 响应对象
+├── dto/              # 请求参数（含 Param）
+├── constants/        # 枚举、常量
+├── mq/               # 消息队列
+└── task/             # 定时任务
+```
+
+### 参考代码位置
+
+| 需要参考 | 路径 |
+|---------|------|
+| Controller 写法 | `core-order/.../order/web/controller/OrderInfoWebController.java` |
+| Business 层写法 | `core-order/.../order/web/business/impl/OrderWebBusiness.java` |
+| Service 写法 | `core-order/.../order/common/service/impl/OrderInfoService.java` |
+| Entity 写法 | `core-order/.../order/common/model/OrderInfo.java` |
+| 枚举写法 | `core-order/.../order/common/constants/OrderStateEnum.java` |
+| 配置文件 | `core-base/src/main/resources/bootstrap.yml` |
+
+---
+
+## 前端项目
+
+**根路径**：由用户在 `CLAUDE.md` 中配置，各安装者路径不同
+
+### src/ 核心目录
+
+| 目录 | 说明 | 规模 |
+|------|------|------|
+| `api/` | 接口定义 | 63 个文件 |
+| `leniuview/` | 业务模块页面 | 33 个模块 |
+| `leniu-components/` | 业务组件库 | 12 个组件包 |
+| `components/` | 通用组件 | ~87 个 |
+| `store/` | Vuex 状态管理 | 30+ 个模块 |
+| `utils/` | 工具函数 | 37 个文件 |
+
+### 常用前端文件
+
+| 需要查找 | 路径 |
+|---------|------|
+| 主入口 | `src/main.js` |
+| 权限路由守卫 | `src/permission.js` |
+| 请求封装 | `src/utils/request.js` |
+| Token/租户工具 | `src/utils/auth.js` |
+| 全局工具 | `src/utils/index.js` |
+| Vuex 根配置 | `src/store/index.js` |
+| 构建配置 | `vue.config.js` |
+
+### 前端业务模块（leniuview 33 个）
+
+```
+accountCenter、canteenBackcourt、cost、dashboard、dataScreen、
+deviceMange、dormitory、marketing、menudish、orderCenter、
+purchase、reportCenter、stock、supplyChain、attendance、
+campus、approvalManage、noticeV2、personalV2 ...
+```
+
+---
+
+## 技能系统导航
+
+**技能路径**：`.claude/skills/{技能名}/SKILL.md`
+
+### 按开发场景选择技能
+
+| 场景 | 技能 |
+|------|------|
+| 新建 CRUD 模块 | `leniu-crud-development` |
+| API 接口设计 | `leniu-api-development` |
+| 建表/SQL | `leniu-database-ops` |
+| Entity/VO/DTO | `leniu-java-entity` |
+| MyBatis/Mapper | `leniu-java-mybatis` |
+| 异常处理 | `leniu-error-handler` |
+| 工具类使用 | `leniu-utils-toolkit` |
+| 注解使用 | `leniu-backend-annotations` |
+| 代码规范 | `leniu-code-patterns` |
+| 数据权限/双库 | `leniu-data-permission` |
+| 定制报表 | `leniu-report-customization` |
+| 标准报表 | `leniu-report-standard-customization` |
+| 金额处理 | `leniu-java-amount-handling` |
+| 并发/异步 | `leniu-java-concurrent` |
+| 导出功能 | `leniu-java-export` |
+| 定时任务 | `leniu-java-task` |
+| 消息队列 | `leniu-java-mq` |
+| Redis 缓存 | `leniu-redis-cache` |
+| 合计行查询 | `leniu-java-total-line` |
+| 报表查询入参 | `leniu-java-report-query-param` |
+| 营销计费规则 | `leniu-marketing-price-rule-customizer` |
+| 营销充值规则 | `leniu-marketing-recharge-rule-customizer` |
+| 餐次处理 | `leniu-mealtime` |
+| 定制开发位置 | `leniu-customization-location` |
+| Bug 排查 | `bug-detective`（数据问题自动联动 `mysql-debug`） |
+| 数据库查询验证 | `mysql-debug` |
+| Codex 代码审查 | `codex-code-review` |
+| 前端组件/权限 | `ui-pc` |
+| 前端 Vuex | `store-pc` |
+| 方案设计 | `leniu-brainstorm` |
+| 架构设计 | `leniu-architecture-design` |
+| 安全认证 | `leniu-security-guard` |
+
+### 快速命令
+
+| 命令 | 用途 |
+|------|------|
+| `/dev` | 开发新功能 |
+| `/crud` | 快速生成 CRUD |
+| `/check` | 代码规范检查 |
+| `/start` | 项目快速了解 |
+| `/progress` | 查看项目进度 |
+| `/next` | 下一步建议 |
+| `/add-todo` | 添加待办事项 |
+
+---
+
+## 常用搜索模式
+
+```bash
+# 查找某模块的 Controller
+Glob core-order/**/*Controller*.java
+
+# 查找 Service 实现类
+Glob core-order/**/impl/*Service*.java
+
+# 查找 Mapper XML
+Glob core-order/**/*Mapper.xml
+
+# 查找 Entity
+Glob core-order/**/model/*.java
+
+# 查找某接口路由
+Grep "/api/v2/web/order" --type java
+
+# 查找前端某页面
+Glob src/leniuview/**/index.vue
+
+# 查找前端接口定义
+Glob src/api/*.js
+```

package/src/skills/redis-cache/SKILL.md

@@ -0,0 +1,282 @@
+---
+name: redis-cache
+description: |
+  当需要使用Redis缓存、分布式锁、限流等功能时自动使用此Skill。包含 Redisson API、Spring Cache 注解使用规范、分布式锁实现、缓存key命名规范等。
+
+  触发场景：
+  - 使用Redis缓存数据
+  - 配置Spring Cache缓存注解
+  - 实现分布式锁
+  - 实现接口限流
+  - Redis发布订阅
+  - 缓存key设计和命名
+  - 缓存清理和刷新
+
+  触发词：Redis、缓存、Cache、@Cacheable、@CacheEvict、@CachePut、Redisson、分布式锁、RLock、限流、RateLimiter、发布订阅、缓存key、缓存过期
+
+  核心警告：
+  - @Cacheable返回值不能使用不可变集合（List.of()、Set.of()、Map.of()）
+  - 分布式锁必须在finally中释放，且需注入RedissonClient
+---
+
+# Redis 缓存开发指南
+
+## 快速索引
+
+| 功能 | 工具类/注解 | 说明 |
+|------|-------------|------|
+| 对象缓存 | `RedissonClient` / `[你的RedisUtils]` | 基于 Redisson |
+| Spring Cache | `@Cacheable/@CachePut/@CacheEvict` | 声明式缓存 |
+| 分布式锁 | `redissonClient.getLock()` | 需注入 RedissonClient |
+| 限流控制 | Redisson `RRateLimiter` | 基于 Redisson |
+| 原子操作 | Redisson `RAtomicLong` | 原子递增/递减 |
+| 发布订阅 | Redisson `RTopic` | 消息通信 |
+
+---
+
+## 一、Redisson 基础操作
+
+### 1.1 基础缓存操作
+
+```java
+import org.redisson.api.RedissonClient;
+import org.redisson.api.RBucket;
+
+@Service
+@RequiredArgsConstructor
+public class CacheService {
+
+    private final RedissonClient redissonClient;
+
+    // 设置缓存
+    public void set(String key, Object value, Duration ttl) {
+        RBucket<Object> bucket = redissonClient.getBucket(key);
+        bucket.set(value, ttl);
+    }
+
+    // 获取缓存
+    public <T> T get(String key) {
+        RBucket<T> bucket = redissonClient.getBucket(key);
+        return bucket.get();
+    }
+
+    // 删除缓存
+    public boolean delete(String key) {
+        return redissonClient.getBucket(key).delete();
+    }
+
+    // 判断是否存在
+    public boolean exists(String key) {
+        return redissonClient.getBucket(key).isExists();
+    }
+
+    // 不存在时设置（原子操作）
+    public boolean setIfAbsent(String key, Object value, Duration ttl) {
+        RBucket<Object> bucket = redissonClient.getBucket(key);
+        return bucket.trySet(value, ttl);
+    }
+}
+```
+
+### 1.2 集合操作
+
+```java
+// List
+RList<String> list = redissonClient.getList("myList");
+list.addAll(dataList);
+List<String> result = list.readAll();
+
+// Set
+RSet<String> set = redissonClient.getSet("mySet");
+set.addAll(dataSet);
+Set<String> result = set.readAll();
+
+// Map
+RMap<String, Object> map = redissonClient.getMap("myMap");
+map.putAll(dataMap);
+map.put("key3", "value3");
+Object value = map.get("key1");
+```
+
+### 1.3 发布订阅
+
+```java
+// 发布消息
+RTopic topic = redissonClient.getTopic("notification:channel");
+topic.publish(messageObj);
+
+// 订阅消息
+RTopic topic = redissonClient.getTopic("notification:channel");
+topic.addListener(MessageDTO.class, (channel, msg) -> {
+    // 处理消息
+});
+```
+
+### 1.4 限流控制
+
+```java
+import org.redisson.api.RRateLimiter;
+import org.redisson.api.RateType;
+import org.redisson.api.RateIntervalUnit;
+
+RRateLimiter limiter = redissonClient.getRateLimiter("api:limit:user:" + userId);
+// 每10秒最多100个请求
+limiter.trySetRate(RateType.OVERALL, 100, 10, RateIntervalUnit.SECONDS);
+
+if (!limiter.tryAcquire()) {
+    throw new [你的异常类]("请求过于频繁");
+}
+```
+
+### 1.5 原子操作
+
+```java
+RAtomicLong counter = redissonClient.getAtomicLong("counter:view");
+counter.set(0L);
+long value = counter.get();
+long newVal = counter.incrementAndGet();
+long newVal = counter.decrementAndGet();
+```
+
+---
+
+## 二、Spring Cache 注解使用规范
+
+### @Cacheable - 查询缓存
+
+```java
+@Cacheable(value = "dictData", key = "#dictType")
+@Override
+public List<DictDataVo> listDictDataByType(String dictType) {
+    if (dictType == null || dictType.isBlank()) {
+        return Collections.emptyList();
+    }
+    List<DictData> dictDataList = dictDataMapper.selectByType(dictType);
+    if (dictDataList.isEmpty()) {
+        return Collections.emptyList();  // 返回空列表防止缓存穿透
+    }
+    return dictDataList.stream()
+        .map(d -> BeanUtil.copyProperties(d, DictDataVo.class))
+        .toList();
+}
+```
+
+### @CachePut / @CacheEvict
+
+```java
+@CachePut(value = "dictData", key = "#bo.dictType")
+public List<DictDataVo> insertDictType(DictTypeBo bo) { ... }
+
+@CacheEvict(value = "dictData", key = "#dictType")
+public void deleteDictType(String dictType) { ... }
+
+@CacheEvict(value = "dictData", allEntries = true)
+public void clearAllDictCache() { ... }
+```
+
+### 返回值禁止使用不可变集合
+
+```java
+// ❌ 禁止! @Cacheable 返回值序列化失败
+return List.of(data1, data2);
+return Set.of("admin", "user");
+return Map.of("key1", "value1");
+
+// ✅ 正确：使用可变集合
+List<DictDataVo> result = new ArrayList<>();
+result.add(data1);
+return result;
+```
+
+---
+
+## 三、CacheNames 命名规范
+
+### 推荐格式
+
+```
+cacheNames#ttl#maxIdleTime#maxSize
+- ttl: 过期时间（0=不过期，默认0）
+- maxIdleTime: 最大空闲时间（0=不检测，默认0）
+- maxSize: 最大条数（0=无限，默认0）
+```
+
+```java
+"test#60s"                // 60秒过期
+"test#0#60s"              // 不过期，60秒空闲清理
+"test#0#1m#1000"          // 不过期，1分钟空闲，最大1000条
+"test#1h#0#500"           // 1小时过期，最大500条
+```
+
+### 常量定义示例
+
+```java
+public interface CacheNames {
+    String SYS_CONFIG = "sys_config";
+    String SYS_DICT = "sys_dict";
+    String SYS_USER_NAME = "sys_user_name#30d";
+    String SYS_DEPT = "sys_dept#30d";
+}
+```
+
+---
+
+## 四、分布式锁
+
+> 直接注入 `RedissonClient` 使用。
+
+```java
+@Service
+@RequiredArgsConstructor
+public class OrderServiceImpl {
+
+    private final RedissonClient redissonClient;
+
+    public void submitOrder(OrderBo orderBo) {
+        String lockKey = "lock:submit:order:" + orderBo.getUserId();
+        RLock lock = redissonClient.getLock(lockKey);
+
+        try {
+            boolean locked = lock.tryLock(3, 10, TimeUnit.SECONDS);
+            if (!locked) {
+                throw new [你的异常类]("请勿重复提交订单");
+            }
+            try {
+                orderMapper.insert(orderBo);
+            } finally {
+                if (lock.isLocked() && lock.isHeldByCurrentThread()) {
+                    lock.unlock();  // 必须在 finally 中释放
+                }
+            }
+        } catch (InterruptedException e) {
+            Thread.currentThread().interrupt();
+            throw new [你的异常类]("订单提交被中断");
+        }
+    }
+}
+```
+
+---
+
+## 五、缓存 Key 命名规范
+
+```
+格式：{业务模块}:{功能}:{具体标识}
+
+示例：
+user:info:123              user:roles:123            user:permissions:123
+dict:data:sys_user_sex     order:info:20240101001    order:status:20240101001
+lock:order:20240101001     lock:stock:123            lock:submit:order:456
+limit:api:user:123         limit:sms:18888888888
+```
+
+---
+
+## 六、注意事项速查
+
+1. **@Cacheable 返回值不能使用不可变集合**（List.of()、Set.of()、Map.of()）
+2. **分布式锁必须在 finally 中释放**
+3. **返回空列表而不是 null**，防止缓存穿透
+4. **设置随机过期时间偏移**，避免缓存雪崩
+5. **热点数据用分布式锁 + 双重检查**，防止缓存击穿
+6. **keys() 模式匹配要谨慎**，生产环境避免大范围扫描

package/src/skills/redis-cache/references/listeners.md

@@ -0,0 +1,23 @@
+# Redis 监听机制
+
+## 过期/删除监听器
+
+```java
+import org.redisson.api.listener.ExpiredObjectListener;
+import org.redisson.api.listener.DeletedObjectListener;
+
+// 注册过期监听器（需要开启Redis的notify-keyspace-events配置）
+RedisUtils.addObjectListener("user:123", (ExpiredObjectListener) name -> {
+    log.info("缓存已过期: {}", name);
+});
+
+// 注册删除监听器
+RedisUtils.addObjectListener("user:123", (DeletedObjectListener) name -> {
+    log.info("缓存已删除: {}", name);
+});
+
+// 注册List/Set/Map监听器
+RedisUtils.addListListener("myList", (ExpiredObjectListener) name -> { ... });
+RedisUtils.addSetListener("mySet", (DeletedObjectListener) name -> { ... });
+RedisUtils.addMapListener("myMap", (ExpiredObjectListener) name -> { ... });
+```