乐启助手
open-leqi-assistant
by allanseven
|
安装
claude skill add --url https://github.com/openclaw/skills文档
乐企(open-leqi)项目分析助手
技能概述
本技能基于百望乐企数字开放平台项目,专注于帮助开发者快速理解项目架构、定位代码、解答业务问题。
项目结构
D:/leqi/open-leqi/
├── open-leqi-api/ # API模块 - Feign客户端定义
│ └── src/main/java/com/baiwang/platform/openleqi/
│ ├── api/ # 29个Feign Client接口
│ ├── model/ # 数据模型(163个)
│ └── farm/ # 农业相关API
│
├── open-leqi-service/ # 服务模块 - 核心业务实现
│ └── src/main/java/com/baiwang/platform/openleqi/
│ ├── web/ # 60个Controller控制器
│ ├── service/impl/ # 122个Service实现
│ ├── dao/ # 数据访问层(109个)
│ ├── common/ # 公共工具(508个)
│ ├── config/ # 配置类
│ ├── job/ # 定时任务(19个)
│ └── intergration/ # 外部集成(48个)
│
└── startup/ # 启动模块
核心业务模块
发票管理
| 模块 | Controller | Service | Client | 说明 |
|---|---|---|---|---|
| 发票主表 | LqInvoiceMainController | LqInvoiceMainService | LqInvoiceMainClient | 全电发票核心数据 |
| 发票明细 | LqInvoiceDetailController | LqInvoiceDetailService | LqInvoiceDetailClient | 发票商品明细 |
| 发票抵扣 | LqInvoiceDeductController | LqInvoiceDeductService | LqInvoiceDeductClient | 增值税抵扣勾选 |
| 发票作废 | - | LqWarrantPoolService | LqWarrantSyncClient | 发票作废管理 |
勾选能力
| 模块 | Controller | Service | 说明 |
|---|---|---|---|
| 抵扣勾选 | LqWithholdDeductController | LqWithholdDeductService | 勾选用于抵扣 |
| 退税勾选 | LqWarrantDeductController | LqWarrantDeductService | 勾选用于退税 |
| 不抵扣勾选 | LqNotdeductInitTaskController | LqNotdeductInitTaskService | 不抵扣处理 |
| 农产品抵扣 | LqFarmInvoiceDeductWeightController | LqFarmInvoiceDeductWeightService | 农产品加计扣除 |
用票能力
| 模块 | Controller | Service | 说明 |
|---|---|---|---|
| 实时用票 | LqSyncController | LqSyncService | 发票开具 |
| 下载发票 | LqDownloadTaskController | LqDownloadTaskService | 发票下载 |
| 发票池 | LqInvoicePoolTaskController | LqInvoicePoolTaskService | 发票池管理 |
代码定位规则
根据功能查询Controller
// 发票相关: 搜索 "LqInvoice*Controller"
com.baiwang.platform.openleqi.web.LqInvoiceMainController
com.baiwang.platform.openleqi.web.LqInvoiceDetailController
com.baiwang.platform.openleqi.web.LqInvoiceDeductController
// 勾选相关: 搜索 "Lq*DeductController" 或 "Lq*WarrantController"
com.baiwang.platform.openleqi.web.LqWithholdDeductController
com.baiwang.platform.openleqi.web.LqWarrantDeductController
根据功能查询Service
// 服务接口: com.baiwang.platform.openleqi.service.Lq*Service
// 服务实现: com.baiwang.platform.openleqi.service.impl.Lq*ServiceImpl
根据功能查询DAO
// Entity: com.baiwang.platform.openleqi.dao.entity.Lq*
// Mapper: com.baiwang.platform.openleqi.dao.mapper.Lq*Mapper
常用业务场景
场景1: 查询发票信息
- Controller:
LqInvoiceMainController→/web/lqInvoiceMain/queryPageList - Service:
LqInvoiceMainService - DAO:
LqInvoiceMainMapper
场景2: 抵扣勾选处理
- Controller:
LqWithholdDeductController→ 抵扣接口 - Service:
LqWithholdDeductService - 核心方法:
deduct()/undoDeduct()
场景3: 发票开具
- Controller:
LqSyncController - Service:
LqSyncService.syncInvoice() - 调用链: OFS系统 → 乐企 → 返回结果
项目规范
Spring Boot规范
- 使用
@RequiredArgsConstructor代替构造函数注入 - 使用Lombok简化代码
- 分层清晰: Controller → Service → DAO
命名规范
- Controller:
Lq{业务}Controller(例:LqInvoiceMainController) - Service:
Lq{业务}Service(例:LqInvoiceMainService) - Entity:
Lq{业务}(例:LqInvoiceMain) - Mapper:
Lq{业务}Mapper(例:LqInvoiceMainMapper)
API规范
- 使用Swagger
@Api@ApiOperation注解 - 使用
BWJsonResultDto统一返回格式 - 使用
@Validated进行参数校验
外部依赖
- 百望BOP SDK:
com.baiwang.bop:baiwang-bopsdk:3.4.822 - 父工程:
com.baiwang.basictools:bw-spring-boot-starter-parent-security:2.7.196 - 数据库: MyBatis-Plus
快速查询
当用户提问时,按以下顺序响应:
- 理解问题: 识别用户询问的业务场景
- 定位代码: 根据上表找到对应的Controller/Service/DAO
- 给出路径: 提供完整的文件路径
- 分析问题: 简要说明代码逻辑
- 建议方案: 提供问题解决思路
参考文档
references/project-architecture.md- 详细项目架构说明references/business-flows.md- 业务流程图说明references/api-guide.md- API接口文档索引
相关 Skills
Claude接口
by anthropics
面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景,自动识别项目语言并给出对应示例与默认配置,快速搭建 LLM 应用。
✎ 想把Claude能力接进应用或智能体,用claude-api上手快、兼容Anthropic与Agent SDK,集成路径清晰又省心
RAG架构师
by alirezarezvani
聚焦生产级RAG系统设计与优化,覆盖文档切块、检索链路、索引构建、召回评估等关键环节,适合搭建可扩展、高准确率的知识库问答与检索增强应用。
✎ 面向RAG落地,把知识库、向量检索和生成链路系统串联起来,做架构设计时更清晰,也更少踩坑。
多智能体架构
by alirezarezvani
聚焦多智能体系统架构设计,梳理 Supervisor、Swarm、分层和 Pipeline 等模式,覆盖角色定义、通信协作与性能评估,适合规划稳健可扩展的 AI agent 编排方案。
✎ 帮你系统解决多智能体应用的架构设计与协同编排难题,适合构建复杂 AI 工作流,成熟度高、社区认可也很亮眼。
相关 MCP 服务
知识图谱记忆
编辑精选by Anthropic
Memory 是一个基于本地知识图谱的持久化记忆系统,让 AI 记住长期上下文。
✎ 帮 AI 和智能体补上“记不住”的短板,用本地知识图谱沉淀长期上下文,连续对话更聪明,数据也更可控。
顺序思维
编辑精选by Anthropic
Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。
✎ 这个服务器展示了如何让 Claude 像人类一样逐步推理,适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例,别指望直接用在生产环境里。
by deusdata
持久化的代码库知识图谱,可跨会话保留上下文,在 session 重启或上下文压缩后仍能继续使用。
✎ 专治 AI 编程助手“会话失忆”,把代码库沉淀为持久知识图谱,重启或压缩上下文后也能无缝续上开发状态。