乐启助手

open-leqi-assistant

by allanseven

|

4.5kAI 与智能体未扫描2026年4月20日

安装

claude skill add --url https://github.com/openclaw/skills

文档

乐企(open-leqi)项目分析助手

技能概述

本技能基于百望乐企数字开放平台项目,专注于帮助开发者快速理解项目架构、定位代码、解答业务问题。

项目结构

code
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/               # 启动模块

核心业务模块

发票管理

模块ControllerServiceClient说明
发票主表LqInvoiceMainControllerLqInvoiceMainServiceLqInvoiceMainClient全电发票核心数据
发票明细LqInvoiceDetailControllerLqInvoiceDetailServiceLqInvoiceDetailClient发票商品明细
发票抵扣LqInvoiceDeductControllerLqInvoiceDeductServiceLqInvoiceDeductClient增值税抵扣勾选
发票作废-LqWarrantPoolServiceLqWarrantSyncClient发票作废管理

勾选能力

模块ControllerService说明
抵扣勾选LqWithholdDeductControllerLqWithholdDeductService勾选用于抵扣
退税勾选LqWarrantDeductControllerLqWarrantDeductService勾选用于退税
不抵扣勾选LqNotdeductInitTaskControllerLqNotdeductInitTaskService不抵扣处理
农产品抵扣LqFarmInvoiceDeductWeightControllerLqFarmInvoiceDeductWeightService农产品加计扣除

用票能力

模块ControllerService说明
实时用票LqSyncControllerLqSyncService发票开具
下载发票LqDownloadTaskControllerLqDownloadTaskService发票下载
发票池LqInvoicePoolTaskControllerLqInvoicePoolTaskService发票池管理

代码定位规则

根据功能查询Controller

java
// 发票相关: 搜索 "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

java
// 服务接口: com.baiwang.platform.openleqi.service.Lq*Service
// 服务实现: com.baiwang.platform.openleqi.service.impl.Lq*ServiceImpl

根据功能查询DAO

java
// Entity: com.baiwang.platform.openleqi.dao.entity.Lq*
// Mapper: com.baiwang.platform.openleqi.dao.mapper.Lq*Mapper

常用业务场景

场景1: 查询发票信息

  1. Controller: LqInvoiceMainController/web/lqInvoiceMain/queryPageList
  2. Service: LqInvoiceMainService
  3. DAO: LqInvoiceMainMapper

场景2: 抵扣勾选处理

  1. Controller: LqWithholdDeductController → 抵扣接口
  2. Service: LqWithholdDeductService
  3. 核心方法: deduct() / undoDeduct()

场景3: 发票开具

  1. Controller: LqSyncController
  2. Service: LqSyncService.syncInvoice()
  3. 调用链: 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

快速查询

当用户提问时,按以下顺序响应:

  1. 理解问题: 识别用户询问的业务场景
  2. 定位代码: 根据上表找到对应的Controller/Service/DAO
  3. 给出路径: 提供完整的文件路径
  4. 分析问题: 简要说明代码逻辑
  5. 建议方案: 提供问题解决思路

参考文档

  • references/project-architecture.md - 详细项目架构说明
  • references/business-flows.md - 业务流程图说明
  • references/api-guide.md - API接口文档索引

相关 Skills

Claude接口

by anthropics

Universal
热门

面向接入 Claude API、Anthropic SDK 或 Agent SDK 的开发场景,自动识别项目语言并给出对应示例与默认配置,快速搭建 LLM 应用。

想把Claude能力接进应用或智能体,用claude-api上手快、兼容Anthropic与Agent SDK,集成路径清晰又省心

AI 与智能体
未扫描155.3k

RAG架构师

by alirezarezvani

Universal
热门

聚焦生产级RAG系统设计与优化,覆盖文档切块、检索链路、索引构建、召回评估等关键环节,适合搭建可扩展、高准确率的知识库问答与检索增强应用。

面向RAG落地,把知识库、向量检索和生成链路系统串联起来,做架构设计时更清晰,也更少踩坑。

AI 与智能体
未扫描19.1k

多智能体架构

by alirezarezvani

Universal
热门

聚焦多智能体系统架构设计,梳理 Supervisor、Swarm、分层和 Pipeline 等模式,覆盖角色定义、通信协作与性能评估,适合规划稳健可扩展的 AI agent 编排方案。

帮你系统解决多智能体应用的架构设计与协同编排难题,适合构建复杂 AI 工作流,成熟度高、社区认可也很亮眼。

AI 与智能体
未扫描19.1k

相关 MCP 服务

知识图谱记忆

编辑精选

by Anthropic

热门

Memory 是一个基于本地知识图谱的持久化记忆系统,让 AI 记住长期上下文。

帮 AI 和智能体补上“记不住”的短板,用本地知识图谱沉淀长期上下文,连续对话更聪明,数据也更可控。

AI 与智能体
87.7k

顺序思维

编辑精选

by Anthropic

热门

Sequential Thinking 是让 AI 通过动态思维链解决复杂问题的参考服务器。

这个服务器展示了如何让 Claude 像人类一样逐步推理,适合开发者学习 MCP 的思维链实现。但注意它只是个参考示例,别指望直接用在生产环境里。

AI 与智能体
87.7k

by deusdata

热门

持久化的代码库知识图谱,可跨会话保留上下文,在 session 重启或上下文压缩后仍能继续使用。

专治 AI 编程助手“会话失忆”,把代码库沉淀为持久知识图谱,重启或压缩上下文后也能无缝续上开发状态。

AI 与智能体
14.9k

评论