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 - 查询物业资产指标

部署配置

依赖关系

<!-- 查看 pom.xml 获取详细依赖配置 -->

启动配置

# 启动服务
java -jar service-store.jar

开发指南

命令接口开发规范

1. 命名规范：命令类命名采用"动词+名词+Cmd"格式
2. 接口实现：每个命令类必须实现validate()和execute()方法
3. 单一职责：每个命令类专注于单一业务职责
4. 异常处理：统一使用CmdException进行异常处理
5. 服务标识：使用@Java110Cmd注解标识服务代码

接口调用方式

通过统一的命令分发器调用各命令接口，确保接口调用的统一性和可维护性。

版本历史

• v1.0.0 - 初始版本，包含186个核心命令接口
• 采用命令驱动架构设计，提升系统可扩展性

---

最后更新: 2024年 总接口数: 186个 业务领域: 29个