乐企(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 | 发票池管理 |
// 发票相关: 搜索 "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
// 服务接口: com.baiwang.platform.openleqi.service.Lq*Service
// 服务实现: com.baiwang.platform.openleqi.service.impl.Lq*ServiceImpl
// Entity: com.baiwang.platform.openleqi.dao.entity.Lq*
// Mapper: com.baiwang.platform.openleqi.dao.mapper.Lq*Mapper
LqInvoiceMainController → /web/lqInvoiceMain/queryPageListLqInvoiceMainServiceLqInvoiceMainMapperLqWithholdDeductController → 抵扣接口LqWithholdDeductServicededuct() / undoDeduct()LqSyncControllerLqSyncService.syncInvoice()@RequiredArgsConstructor代替构造函数注入Lq{业务}Controller (例: LqInvoiceMainController)Lq{业务}Service (例: LqInvoiceMainService)Lq{业务} (例: LqInvoiceMain)Lq{业务}Mapper (例: LqInvoiceMainMapper)@Api @ApiOperation 注解BWJsonResultDto统一返回格式@Validated进行参数校验com.baiwang.bop:baiwang-bopsdk:3.4.822com.baiwang.basictools:bw-spring-boot-starter-parent-security:2.7.196当用户提问时，按以下顺序响应:
references/project-architecture.md - 详细项目架构说明references/business-flows.md - 业务流程图说明references/api-guide.md - API接口文档索引