master/service-store/README.md

# Service-Store 模块技术文档
## 模块概述
Service-Store 是微社区系统中的店铺管理微服务模块，采用命令驱动架构设计，提供完整的店铺运营管理功能。本模块包含186个命令接口，覆盖29个业务领域，包括店铺管理、资源调度、投诉处理、预约服务、采购管理、排班管理等核心业务功能。
## 技术架构
### 命令驱动架构
本模块采用命令驱动架构设计，所有业务操作通过cmd目录下的命令接口实现：
- **命令模式**：每个业务操作对应一个具体的命令类，实现高内聚低耦合
- **统一接口**：所有命令类继承自Cmd基类，实现validate()和execute()方法
- **服务标识**：通过@Java110Cmd注解标识服务代码，实现统一路由
- **职责分离**：命令类专注于业务逻辑处理，实现清晰的业务边界
### 核心包结构
```
src/main/java/com/java110/store/
├── cmd/          # 命令接口层（186个核心业务接口）
├── api/          # API接口层
├── bmo/          # 业务模型对象
├── dao/          # 数据访问层
├── rest/         # REST接口
└── smo/          # 服务模型对象
```
## 核心命令接口清单
### 1. 店铺管理 (shop) - 3个接口
- `ApplyShopCodeCmd` - 申请店铺临时票据
- `ListMyEnteredShopsCmd` - 查询用户入驻店铺
- `QueryShopCmd` - 通用店铺查询
### 2. 店铺基础管理 (store) - 8个接口
- `ListStoresCmd` - 查询店铺列表
- `SaveStoreInfoCmd` - 保存店铺信息
- `UpdateStoreInfoCmd` - 更新店铺信息
- `UpdateStoreAttrCmd` - 更新店铺属性
- `QueryStoreByUserCmd` - 根据用户查询店铺
- `ListStoresByCommunityCmd` - 按社区查询店铺
- `ListCommunityStoreShopCmd` - 查询社区店铺
- `PropertySaveStoreAndShopCmd` - 物业保存店铺和商店
- `PropertyDeleteStoreAndShopCmd` - 物业删除店铺和商店
### 3. 投诉管理 (complaint) - 11个接口
- `SaveComplaintCmd` - 保存投诉
- `UpdateComplaintCmd` - 更新投诉
- `DeleteComplaintCmd` - 删除投诉
- `ListComplaintsCmd` - 查询投诉列表
- `ListAdminComplaintsCmd` - 管理员查询投诉列表
- `AuditComplaintCmd` - 审核投诉
- `ListComplaintEventCmd` - 查询投诉事件
- `ListAdminComplaintEventCmd` - 管理员查询投诉事件
- `ListPhoneComplaintEventCmd` - 电话投诉事件查询
- `QueryPhoneComplaintTypeCmd` - 查询电话投诉类型
- `QueryUserComplaintsCmd` - 查询用户投诉
### 4. 投诉类型管理 (complaintType) - 6个接口
- `ListComplaintTypeCmd` - 查询投诉类型
- `SaveComplaintTypeCmd` - 保存投诉类型
- `DeleteComplaintTypeCmd` - 删除投诉类型
- `UpdateComplaintTypeCmd` - 更新投诉类型
- `ListComplaintTypeUserCmd` - 查询用户投诉类型
- `ListAdminComplaintTypeCmd` - 管理员查询投诉类型
### 5. 投诉评价管理 (complaintAppraise) - 5个接口
- `ListComplaintAppraiseCmd` - 查询投诉评价
- `SaveComplaintAppraiseCmd` - 保存投诉评价
- `ReplyComplaintAppraiseCmd` - 回复投诉评价
- `DeleteComplaintAppraiseCmd` - 删除投诉评价
- `ListAdminComplaintAppraiseCmd` - 管理员查询投诉评价
### 6. 资源管理 (resourceStore) - 37个接口
**资源库存管理**
- `SaveResourceStoreCmd` - 保存资源库存
- `UpdateResourceStoreCmd` - 更新资源库存
- `DeleteResourceStoreCmd` - 删除资源库存
- `ListResourceStoresCmd` - 查询资源库存列表
- `ImportResourceStoreCmd` - 导入资源库存
- `ListResourceStoresAndTimesCmd` - 查询资源和时间
**资源规格管理**
- `SaveResourceStoreSpecificationCmd` - 保存资源规格
- `UpdateResourceStoreSpecificationCmd` - 更新资源规格
- `DeleteResourceStoreSpecificationCmd` - 删除资源规格
- `ListResourceStoreSpecificationsCmd` - 查询资源规格列表
**仓库管理**
- `SaveStorehouseCmd` - 保存仓库
- `UpdateStorehouseCmd` - 更新仓库
- `DeleteStorehouseCmd` - 删除仓库
- `ListStorehousesCmd` - 查询仓库列表
- `ListUserStorehousesCmd` - 查询用户仓库
**资源调拨管理**
- `SaveAllocationStorehouseCmd` - 保存调拨申请
- `UpdateAllocationStorehouseCmd` - 更新调拨申请
- `DeleteAllocationStorehouseCmd` - 删除调拨申请
- `ListAllocationStorehousesCmd` - 查询调拨申请列表
- `AuditAllocationStoreOrderCmd` - 审核调拨订单
- `ListAllocationStoreAuditOrdersCmd` - 查询调拨审核订单
- `ListAllocationStoreHisAuditOrdersCmd` - 查询调拨历史审核订单
- `ListAllocationStorehouseApplysCmd` - 查询调拨申请
- `SaveAllocationUserStorehouseCmd` - 保存用户调拨仓库
- `ListAllocationUserStorehousesCmd` - 查询用户调拨仓库
- `AllocationStoreEnterCmd` - 调拨入库
**资源使用记录**
- `SaveResourceStoreUseRecordCmd` - 保存资源使用记录
- `UpdateResourceStoreUseRecordCmd` - 更新资源使用记录
- `DeleteResourceStoreUseRecordCmd` - 删除资源使用记录
- `ListResourceStoreUseRecordsCmd` - 查询资源使用记录
- `ListAdminStoreUseRecordsCmd` - 管理员查询使用记录
**资源审核流程**
- `SaveResourceAuditFlowCmd` - 保存资源审核流程
- `UpdateResourceAuditFlowCmd` - 更新资源审核流程
- `DeleteResourceAuditFlowCmd` - 删除资源审核流程
- `ListResourceAuditFlowCmd` - 查询资源审核流程
**资源类型管理**
- `ListResourceStoreTypesCmd` - 查询资源类型
- `ListResourceStoreTypeTreeCmd` - 查询资源类型树
### 7. 资源类型管理 (resourceStoreType) - 3个接口
- `SaveResourceStoreTypeCmd` - 保存资源类型
- `UpdateResourceStoreTypeCmd` - 更新资源类型
- `DeleteResourceStoreTypeCmd` - 删除资源类型
### 8. 资源时间管理 (resourceStoreTimes) - 4个接口
- `SaveResourceStoreTimesCmd` - 保存资源时间
- `UpdateResourceStoreTimesCmd` - 更新资源时间
- `DeleteResourceStoreTimesCmd` - 删除资源时间
- `ListResourceStoreTimesCmd` - 查询资源时间
### 9. 资源供应商管理 (resourceSupplier) - 4个接口
- `SaveResourceSupplierCmd` - 保存资源供应商
- `UpdateResourceSupplierCmd` - 更新资源供应商
- `DeleteResourceSupplierCmd` - 删除资源供应商
- `ListResourceSuppliersCmd` - 查询资源供应商
### 10. 预约管理 (reserve) - 13个接口
**预约目录管理**
- `SaveReserveCatalogCmd` - 保存预约目录
- `UpdateReserveCatalogCmd` - 更新预约目录
- `DeleteReserveCatalogCmd` - 删除预约目录
- `ListReserveCatalogCmd` - 查询预约目录
**预约商品管理**
- `SaveReserveGoodsCmd` - 保存预约商品
- `UpdateReserveGoodsCmd` - 更新预约商品
- `DeleteReserveGoodsCmd` - 删除预约商品
- `ListReserveGoodsCmd` - 查询预约商品
**预约参数管理**
- `SaveReserveParamsCmd` - 保存预约参数
- `UpdateReserveParamsCmd` - 更新预约参数
- `DeleteReserveParamsCmd` - 删除预约参数
- `ListReserveParamsCmd` - 查询预约参数
- `UpdateReserveParamsOpenTimeCmd` - 更新预约开放时间
### 11. 预约订单管理 (reserveOrder) - 7个接口
- `DoDiningCmd` - 用餐操作
- `ListReserveGoodsOrderCmd` - 查询预约商品订单
- `SaveReserveGoodsOrderCmd` - 保存预约商品订单
- `DeleteReserveGoodsPersonCmd` - 删除预约人员
- `ListMyReserveGoodsOrderTimeCmd` - 查询我的预约时间
- `ListReserveGoodsConfirmOrderCmd` - 查询预约确认订单
- `SaveReserveGoodsConfirmOrderCmd` - 保存预约确认订单
### 12. 采购管理 (purchase) - 4个接口
- `PurchaseApplyCmd` - 采购申请
- `PurchaseStorageCmd` - 采购入库
- `ResourceEnterCmd` - 资源入库
- `UrgentPurchaseApplyCmd` - 紧急采购申请
### 13. 采购申请管理 (purchaseApply) - 6个接口
- `AuditApplyOrderCmd` - 审核申请订单
- `SavePurchaseApplyCmd` - 保存采购申请
- `ListPurchaseApplysCmd` - 查询采购申请
- `DeletePurchaseApplyCmd` - 删除采购申请
- `UpdatePurchaseApplyCmd` - 更新采购申请
- `ListAdminPurchaseApplysCmd` - 管理员查询采购申请
### 14. 采购申请详情管理 (purchaseApplyDetail) - 1个接口
- `ListPurchaseApplyDetailsCmd` - 查询采购申请详情
### 15. 排班管理 (scheduleClasses) - 11个接口
**班次管理**
- `SaveScheduleClassesCmd` - 保存班次
- `UpdateScheduleClassesCmd` - 更新班次
- `DeleteScheduleClassesCmd` - 删除班次
- `ListScheduleClassesCmd` - 查询班次列表
- `UpdateScheduleClassesStateCmd` - 更新班次状态
**班次人员管理**
- `SaveScheduleClassesStaffCmd` - 保存班次人员
- `UpdateScheduleClassesStaffCmd` - 更新班次人员
- `DeleteScheduleClassesStaffCmd` - 删除班次人员
- `ListScheduleClassesStaffCmd` - 查询班次人员
**排班查询**
- `ListScheduleClassesDayCmd` - 查询每日排班
- `StaffMonthScheduleClassesCmd` - 员工月度排班
- `StaffAdminMonthScheduleClassesCmd` - 管理员月度排班
### 16. 班次管理 (classes) - 5个接口
- `ListClassesCmd` - 查询班次
- `SaveClassesCmd` - 保存班次
- `DeleteClassesCmd` - 删除班次
- `UpdateClassesCmd` - 更新班次
- `UpdateClassesStateCmd` - 更新班次状态
### 17. 合同管理 (contract) - 4个接口
- `QueryContractCmd` - 查询合同
- `QueryAdminContractCmd` - 管理员查询合同
- `QueryAdminOwnerContractCmd` - 管理员查询业主合同
- `QueryContractByRoomIdCmd` - 根据房间ID查询合同
### 18. 资产盘点管理 (assetInventory) - 4个接口
- `SaveAssetInventoryCmd` - 保存资产盘点
- `UpdateAssetInventoryCmd` - 更新资产盘点
- `DeleteAssetInventoryCmd` - 删除资产盘点
- `ListAssetInventoryCmd` - 查询资产盘点列表
### 19. 资产盘点详情管理 (assetInventoryDetail) - 5个接口
- `ListAssetInventoryDetailCmd` - 查询资产盘点详情
- `SaveAssetInventoryDetailCmd` - 保存资产盘点详情
- `ListAssetInventoryDetailsCmd` - 查询资产盘点详情列表
- `DeleteAssetInventoryDetailCmd` - 删除资产盘点详情
- `UpdateAssetInventoryDetailCmd` - 更新资产盘点详情
### 20. 收藏管理 (collection) - 3个接口
- `GoodsCollectionCmd` - 商品收藏
- `ResourceOutCmd` - 资源出库
- `GetCollectionAuditOrderCmd` - 获取收藏审核订单
### 21. 微信管理 (smallWechat) - 10个接口
- `SaveSmallWechatCmd` - 保存微信配置
- `UpdateSmallWechatCmd` - 更新微信配置
- `DeleteSmallWeChatCmd` - 删除微信配置
- `ListSmallWeChatsCmd` - 查询微信配置列表
- `ListAdminSmallWeChatsCmd` - 管理员查询微信配置
- `SaveAdminSmallWechatCmd` - 管理员保存微信配置
- `UpdateAdminSmallWechatCmd` - 管理员更新微信配置
- `ListSmallWechatAttrsCmd` - 查询微信属性
- `UpdateSmallWechatAttrCmd` - 更新微信属性
- `ListSmallWeChatOnlyAppIdCmd` - 仅查询AppId
### 22. 微信属性管理 (smallWechatAttr) - 3个接口
- `ListSmallWechatAttrCmd` - 查询微信属性
- `SaveSmallWechatAttrCmd` - 保存微信属性
- `DeleteSmallWechatAttrCmd` - 删除微信属性
### 23. 微信菜单管理 (wechatMenu) - 5个接口
- `SaveWechatMenuCmd` - 保存微信菜单
- `ListWechatMenusCmd` - 查询微信菜单
- `DeleteWechatMenuCmd` - 删除微信菜单
- `UpdateWechatMenuCmd` - 更新微信菜单
- `PublishWechatMenuCmd` - 发布微信菜单
### 24. 店铺用户管理 (storeUser) - 7个接口
- `ListStoreUserCmd` - 查询店铺用户
- `SaveStoreUserCmd` - 保存店铺用户
- `DeleteStoreUserCmd` - 删除店铺用户
- `UpdateStoreUserCmd` - 更新店铺用户
- `ListAdminStoreUserCmd` - 管理员查询店铺用户
- `ListStoreStaffLeaderCmd` - 查询店铺员工领导
- `SaveStoreStaffLeaderCmd` - 保存店铺员工领导
- `DeleteStoreStaffLeaderCmd` - 删除店铺员工领导
### 25. 店铺员工领导管理 (storeStaffLeader) - 已包含在storeUser中
### 26. 组织员工关系管理 (orgStaffRel) - 4个接口
- `ListOrgStaffRelCmd` - 查询组织员工关系
- `SaveOrgStaffRelCmd` - 保存组织员工关系
- `DeleteOrgStaffRelCmd` - 删除组织员工关系
- `UpdateOrgStaffRelCmd` - 更新组织员工关系
### 27. 物业属性管理 (property) - 7个接口
- `ListPropertyCmd` - 查询物业
- `SavePropertyCmd` - 保存物业
- `DeletePropertyCmd` - 删除物业
- `UpdatePropertyCmd` - 更新物业
- `MemberJoinCommunityCmd` - 成员加入社区
- `MemberQuitCommunityCmd` - 成员退出社区
- `CheckPropertyStaffHasPropertyCmd` - 检查物业员工是否有物业
### 28. 物业指标管理 (propertyIndex) - 4个接口
- `QueryRepairIndexCmd` - 查询维修指标
- `QueryComplaintIndexCmd` - 查询投诉指标
- `QueryOwnerRegisterIndexCmd` - 查询业主注册指标
- `QueryPropertyAssetsIndexCmd` - 查询物业资产指标
## 部署配置
### 依赖关系
```xml
<!-- 查看 pom.xml 获取详细依赖配置 -->
```
### 启动配置
```bash
# 启动服务
java -jar service-store.jar
```
## 开发指南
### 命令接口开发规范
1. **命名规范**：命令类命名采用"动词+名词+Cmd"格式
2. **接口实现**：每个命令类必须实现validate()和execute()方法
3. **单一职责**：每个命令类专注于单一业务职责
4. **异常处理**：统一使用CmdException进行异常处理
5. **服务标识**：使用@Java110Cmd注解标识服务代码
### 接口调用方式
通过统一的命令分发器调用各命令接口，确保接口调用的统一性和可维护性。
## 版本历史
- v1.0.0 - 初始版本，包含186个核心命令接口
- 采用命令驱动架构设计，提升系统可扩展性
---
*最后更新: 2024年*
*总接口数: 186个*
*业务领域: 29个*