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

添加待办事项

常用搜索模式

查找某模块的 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