- 扩展 ToolConfig 配置类型，新增 external_api 类型
- 实现接口注册表，包含 90+ 睿美云开放接口定义
- 实现 TPOS SHA256WithRSA 签名鉴权
- 实现睿美云 API 客户端，支持多租户配置
- 新增代理路由 /api/ruimeiyun/call/{api_name}
- 支持接口权限控制和健康检查
This commit is contained in:
885
backend/app/services/ruimeiyun/registry.py
Normal file
885
backend/app/services/ruimeiyun/registry.py
Normal file
@@ -0,0 +1,885 @@
|
||||
"""
|
||||
睿美云接口注册表
|
||||
|
||||
定义所有可用的睿美云开放接口，包括：
|
||||
- 接口路径
|
||||
- 请求方法
|
||||
- 参数说明
|
||||
- 接口分组
|
||||
|
||||
接口命名规则: {模块}.{操作}
|
||||
例如: customer.search, order.list, treat.page
|
||||
"""
|
||||
|
||||
from typing import Dict, Any, Optional, List
|
||||
from dataclasses import dataclass
|
||||
|
||||
|
||||
@dataclass
|
||||
class ApiDefinition:
|
||||
"""接口定义"""
|
||||
method: str # GET / POST
|
||||
path: str # API 路径
|
||||
description: str # 接口描述
|
||||
module: str # 所属模块
|
||||
params: Optional[List[str]] = None # URL 参数列表
|
||||
body_required: bool = False # 是否需要请求体
|
||||
|
||||
|
||||
# 睿美云开放接口注册表
|
||||
RUIMEIYUN_APIS: Dict[str, Dict[str, Any]] = {
|
||||
|
||||
# ========================================
|
||||
# 客户模块 (customer)
|
||||
# ========================================
|
||||
|
||||
"customer.sync": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/info-sync",
|
||||
"description": "客户档案新增/编辑",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
"customer.search": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/customer-search",
|
||||
"description": "获取客户信息列表（支持姓名、电话、档案号模糊查询）",
|
||||
"module": "customer",
|
||||
"params": ["keyword", "createDateStart", "createDateEnd", "tenantId", "page", "size", "lastCustomerId"]
|
||||
},
|
||||
"customer.detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/customer-by-id",
|
||||
"description": "根据客户ID获取详细信息",
|
||||
"module": "customer",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"customer.rebate_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/my-rebate-list",
|
||||
"description": "获取客户返利列表",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
"customer.rebate_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/my-rebate-detail",
|
||||
"description": "获取返利详情",
|
||||
"module": "customer",
|
||||
"params": ["rebateId"]
|
||||
},
|
||||
"customer.clue_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/customer-clue-list",
|
||||
"description": "获取客户线索列表",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
"customer.label_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/customer-label-list",
|
||||
"description": "获取客户标签列表",
|
||||
"module": "customer",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"customer.gold_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/customer-gold-list",
|
||||
"description": "获取金卡客户列表",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
"customer.plan_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/get-all-plan",
|
||||
"description": "获取所有客户计划",
|
||||
"module": "customer",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"customer.transfer_pool": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/transfer-pool",
|
||||
"description": "客户池转移",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
"customer.pool_info": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/get-pool-info",
|
||||
"description": "获取客户池信息",
|
||||
"module": "customer",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"customer.qw_info": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/customer/customer-qw-info",
|
||||
"description": "获取客户企微信息",
|
||||
"module": "customer",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"customer.sign_search": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/customer/customer-sign-search",
|
||||
"description": "客户签到搜索",
|
||||
"module": "customer",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 门店模块 (tenant)
|
||||
# ========================================
|
||||
|
||||
"tenant.list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/common/tenantList",
|
||||
"description": "获取门店信息列表",
|
||||
"module": "tenant",
|
||||
"params": []
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 回访模块 (visit)
|
||||
# ========================================
|
||||
|
||||
"visit.type_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/visit/get-visit-type",
|
||||
"description": "获取回访类型列表",
|
||||
"module": "visit",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"visit.way_type_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/visit/get-visit-way-type",
|
||||
"description": "获取回访方式类型列表",
|
||||
"module": "visit",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"visit.page": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/visit/get-visit-page",
|
||||
"description": "分页获取回访记录",
|
||||
"module": "visit",
|
||||
"body_required": True
|
||||
},
|
||||
"visit.create": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/visit/create-visit",
|
||||
"description": "新增回访记录",
|
||||
"module": "visit",
|
||||
"body_required": True
|
||||
},
|
||||
"visit.template_type": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/visit/visit-template-type",
|
||||
"description": "获取回访模板类型",
|
||||
"module": "visit",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 报备模块 (preparation)
|
||||
# ========================================
|
||||
|
||||
"preparation.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/preparation/add",
|
||||
"description": "新增报备",
|
||||
"module": "preparation",
|
||||
"body_required": True
|
||||
},
|
||||
"preparation.query": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/preparation/get-preparation",
|
||||
"description": "查询报备",
|
||||
"module": "preparation",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 员工模块 (user)
|
||||
# ========================================
|
||||
|
||||
"user.page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/user/get-page",
|
||||
"description": "分页获取员工列表",
|
||||
"module": "user",
|
||||
"params": ["page", "size", "tenantId", "keyword"]
|
||||
},
|
||||
"user.dept_tree": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/dept-tree",
|
||||
"description": "获取部门树结构",
|
||||
"module": "user",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"user.role_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/role/getRoleList",
|
||||
"description": "获取角色列表",
|
||||
"module": "user",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 卡券模块 (coupon)
|
||||
# ========================================
|
||||
|
||||
"coupon.customer_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/coupon/customer-coupon-page",
|
||||
"description": "分页获取客户卡券",
|
||||
"module": "coupon",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"coupon.customer_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/coupon/customer-coupon-list",
|
||||
"description": "获取客户卡券列表",
|
||||
"module": "coupon",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"coupon.use": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/coupon/use-coupon",
|
||||
"description": "使用卡券",
|
||||
"module": "coupon",
|
||||
"body_required": True
|
||||
},
|
||||
"coupon.page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/coupon/coupon-page",
|
||||
"description": "分页获取卡券信息",
|
||||
"module": "coupon",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"coupon.send": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/coupon/send-coupon",
|
||||
"description": "发送卡券",
|
||||
"module": "coupon",
|
||||
"body_required": True
|
||||
},
|
||||
"coupon.gift": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/coupon/gift-coupon",
|
||||
"description": "卡券赠送（小程序分享）",
|
||||
"module": "coupon",
|
||||
"body_required": True
|
||||
},
|
||||
"coupon.receive": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/coupon/receive-coupon",
|
||||
"description": "领取卡券（小程序分享）",
|
||||
"module": "coupon",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 营销模块 (marketing)
|
||||
# ========================================
|
||||
|
||||
"marketing.appoint_card_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/marketing/appoint-card-page",
|
||||
"description": "线上预约-名片管理",
|
||||
"module": "marketing",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"marketing.graphic_message_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/marketing/graphic-message-list",
|
||||
"description": "内容管理-图文消息",
|
||||
"module": "marketing",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 积分模块 (integral)
|
||||
# ========================================
|
||||
|
||||
"integral.customer": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/integral/getCusIntegral",
|
||||
"description": "获取客户积分",
|
||||
"module": "integral",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"integral.score_record_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/integral/score-record-page",
|
||||
"description": "获取客户积分/成长值分页信息",
|
||||
"module": "integral",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"integral.growth_upgrade": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/integral/query-customer-growth-upgrade",
|
||||
"description": "查询客户成长升级信息",
|
||||
"module": "integral",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 订单模块 (order)
|
||||
# ========================================
|
||||
|
||||
"order.billing_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/billing-page",
|
||||
"description": "获取订单信息列表",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size", "startDate", "endDate"]
|
||||
},
|
||||
"order.payment_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/payment-detail",
|
||||
"description": "获取费用单详细信息",
|
||||
"module": "order",
|
||||
"params": ["billingId"]
|
||||
},
|
||||
"order.add_billing": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/add-billing",
|
||||
"description": "开单",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.add_billing_review": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/add-billing-review",
|
||||
"description": "开单审核",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.enable_billing": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/enable-billing",
|
||||
"description": "可操作的订单项",
|
||||
"module": "order",
|
||||
"params": ["billingId"]
|
||||
},
|
||||
"order.refund": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/refund",
|
||||
"description": "订单退款",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.gift_project": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/gift-project",
|
||||
"description": "项目转赠（小程序分享）",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.receive_project": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/receive-project",
|
||||
"description": "领取赠送项目（小程序分享）",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.equity_card_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/billing-equity-card-page",
|
||||
"description": "获取客户权益卡列表",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.balance_recharge_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/balance-recharge-page",
|
||||
"description": "储值充值记录",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.balance_deduction_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/balance-deduction-page",
|
||||
"description": "储值抵扣记录",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.balance_refund_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/balance-refund-page",
|
||||
"description": "储值退款记录",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.balance_transfer_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/balance-transfer-page",
|
||||
"description": "储值转赠记录",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.integral_mall_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/order/integral-mall-exchange-page",
|
||||
"description": "获取积分兑换订单信息列表",
|
||||
"module": "order",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"order.add_external": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/add-order-external",
|
||||
"description": "外部订单创建",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.refund_external": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/refund-order-external",
|
||||
"description": "外部订单退款",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.customer_billing_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/get-customer-billing-list",
|
||||
"description": "获取客户订单列表",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
"order.cashier_record_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/order/get-cashierRecord-list",
|
||||
"description": "获取收银记录列表",
|
||||
"module": "order",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 治疗模块 (treat)
|
||||
# ========================================
|
||||
|
||||
"treat.untreated_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/untreated-page",
|
||||
"description": "查询客户未治疗记录",
|
||||
"module": "treat",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"treat.already_treated_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/already-treated-page",
|
||||
"description": "查询客户已治疗记录",
|
||||
"module": "treat",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"treat.page_review": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/treated-page-review",
|
||||
"description": "分页获取治疗数据",
|
||||
"module": "treat",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"treat.operating_room_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/get-operating-room-list",
|
||||
"description": "获取治疗时查询的手术间信息",
|
||||
"module": "treat",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"treat.begin_info": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/get-begin-treat-info",
|
||||
"description": "获取治疗中和已治疗的数据",
|
||||
"module": "treat",
|
||||
"params": ["treatId"]
|
||||
},
|
||||
"treat.deduct_verify": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/treat/treat-deduct-verify",
|
||||
"description": "进行核销和划扣",
|
||||
"module": "treat",
|
||||
"body_required": True
|
||||
},
|
||||
"treat.cancel_deduct": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/treat/cancel-deduct",
|
||||
"description": "取消划扣",
|
||||
"module": "treat",
|
||||
"body_required": True
|
||||
},
|
||||
"treat.cancel_verify": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/treat/cancel-verify",
|
||||
"description": "取消核销",
|
||||
"module": "treat",
|
||||
"body_required": True
|
||||
},
|
||||
"treat.deduct_verify_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/get-treated-deduct-and-verify-detail",
|
||||
"description": "已治疗的核销和划扣详情信息",
|
||||
"module": "treat",
|
||||
"params": ["treatId"]
|
||||
},
|
||||
"treat.roles": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/treat/get-treatment-roles",
|
||||
"description": "获取所有的治疗岗位列表",
|
||||
"module": "treat",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"treat.scrm_list": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/treat/scrmTreatList",
|
||||
"description": "小程序-我的治疗（新版）",
|
||||
"module": "treat",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 照片模块 (photo)
|
||||
# ========================================
|
||||
|
||||
"photo.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/common/addPhoto",
|
||||
"description": "外部七牛照片转存至睿美云",
|
||||
"module": "photo",
|
||||
"body_required": True
|
||||
},
|
||||
"photo.add_open": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/common/addPhotoOpen",
|
||||
"description": "外部照片路径转存至睿美云",
|
||||
"module": "photo",
|
||||
"body_required": True
|
||||
},
|
||||
"photo.upload": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/common/upload_customer_photo",
|
||||
"description": "上传照片到睿美云",
|
||||
"module": "photo",
|
||||
"body_required": True
|
||||
},
|
||||
"photo.page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/common/photoPage",
|
||||
"description": "通过客户id分页查询照片信息",
|
||||
"module": "photo",
|
||||
"params": ["customerId", "page", "size"]
|
||||
},
|
||||
"photo.skin_update": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/skin_image/update_skin_file",
|
||||
"description": "皮肤检测类图片上传",
|
||||
"module": "photo",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 基础数据模块 (basic)
|
||||
# ========================================
|
||||
|
||||
"basic.project_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/project-page",
|
||||
"description": "分页获取项目列表",
|
||||
"module": "basic",
|
||||
"params": ["page", "size", "tenantId", "keyword"]
|
||||
},
|
||||
"basic.project_type_tree": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/project-type-tree",
|
||||
"description": "获取项目分类树",
|
||||
"module": "basic",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"basic.project_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/project-detail",
|
||||
"description": "获取项目详情",
|
||||
"module": "basic",
|
||||
"params": ["projectId"]
|
||||
},
|
||||
"basic.package_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/package-page",
|
||||
"description": "分页获取套餐列表",
|
||||
"module": "basic",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"basic.package_type_tree": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/package-type-tree",
|
||||
"description": "获取套餐分类树",
|
||||
"module": "basic",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"basic.package_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/package-detail",
|
||||
"description": "获取套餐详情",
|
||||
"module": "basic",
|
||||
"params": ["packageId"]
|
||||
},
|
||||
"basic.annual_card_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/annual-card-page",
|
||||
"description": "分页获取年卡列表",
|
||||
"module": "basic",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"basic.annual_card_type_tree": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/annual-card-type-tree",
|
||||
"description": "获取年卡分类树",
|
||||
"module": "basic",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"basic.annual_card_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/annual-card-detail",
|
||||
"description": "获取年卡详情",
|
||||
"module": "basic",
|
||||
"params": ["cardId"]
|
||||
},
|
||||
"basic.time_card_page": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/time-card-page",
|
||||
"description": "分页获取次卡列表",
|
||||
"module": "basic",
|
||||
"params": ["page", "size", "tenantId"]
|
||||
},
|
||||
"basic.time_card_type_tree": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/time-card-type-tree",
|
||||
"description": "获取次卡分类树",
|
||||
"module": "basic",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"basic.time_card_detail": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/basic/time-card-detail",
|
||||
"description": "获取次卡详情",
|
||||
"module": "basic",
|
||||
"params": ["cardId"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 预约模块 (cusbespeak)
|
||||
# ========================================
|
||||
|
||||
"appointment.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/cusbespeak/add",
|
||||
"description": "新增预约",
|
||||
"module": "appointment",
|
||||
"body_required": True
|
||||
},
|
||||
"appointment.update": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/cusbespeak/update",
|
||||
"description": "修改预约",
|
||||
"module": "appointment",
|
||||
"body_required": True
|
||||
},
|
||||
"appointment.confirm": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/cusbespeak/confirm",
|
||||
"description": "确认预约",
|
||||
"module": "appointment",
|
||||
"body_required": True
|
||||
},
|
||||
"appointment.cancel": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/cusbespeak/cancel",
|
||||
"description": "取消预约",
|
||||
"module": "appointment",
|
||||
"body_required": True
|
||||
},
|
||||
"appointment.page": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/cusbespeak/page",
|
||||
"description": "预约分页查询",
|
||||
"module": "appointment",
|
||||
"body_required": True
|
||||
},
|
||||
"appointment.doctor_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/cusbespeak/doctor-list",
|
||||
"description": "获取可选择的预约医生",
|
||||
"module": "appointment",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"appointment.schedule": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/cusbespeak/schedule",
|
||||
"description": "查询预约专家排班",
|
||||
"module": "appointment",
|
||||
"params": ["doctorId", "date"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 渠道模块 (channel)
|
||||
# ========================================
|
||||
|
||||
"channel.type_select": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/channel/type-select",
|
||||
"description": "整合渠道类型选择（建档，报备）",
|
||||
"module": "channel",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"channel.list_by_type": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/channel/list-by-type",
|
||||
"description": "通过渠道类型获取渠道列表",
|
||||
"module": "channel",
|
||||
"params": ["typeId", "tenantId"]
|
||||
},
|
||||
"channel.info": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/channel/info",
|
||||
"description": "查询渠道信息",
|
||||
"module": "channel",
|
||||
"params": ["channelId"]
|
||||
},
|
||||
"channel.media_info": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/channel/media-info",
|
||||
"description": "查询运营媒体信息",
|
||||
"module": "channel",
|
||||
"params": ["mediaId"]
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 接待模块 (reception)
|
||||
# ========================================
|
||||
|
||||
"reception.triage_list": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/reception/triage-list",
|
||||
"description": "可用的接待分诊人列表",
|
||||
"module": "reception",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"reception.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/reception/add",
|
||||
"description": "新增接待",
|
||||
"module": "reception",
|
||||
"body_required": True
|
||||
},
|
||||
"reception.query": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/reception/query",
|
||||
"description": "查询客户接待信息",
|
||||
"module": "reception",
|
||||
"params": ["customerId"]
|
||||
},
|
||||
"reception.sign_init": {
|
||||
"method": "GET",
|
||||
"path": "/api/v1/tpos/reception/sign-init",
|
||||
"description": "客户扫码签到初始化数据(小程序)",
|
||||
"module": "reception",
|
||||
"params": ["tenantId"]
|
||||
},
|
||||
"reception.sign": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/reception/sign",
|
||||
"description": "客户扫码签到(小程序)",
|
||||
"module": "reception",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 咨询模块 (consult)
|
||||
# ========================================
|
||||
|
||||
"consult.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/consult/add",
|
||||
"description": "新增咨询",
|
||||
"module": "consult",
|
||||
"body_required": True
|
||||
},
|
||||
"consult.update": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/consult/update",
|
||||
"description": "修改咨询",
|
||||
"module": "consult",
|
||||
"body_required": True
|
||||
},
|
||||
|
||||
# ========================================
|
||||
# 病历模块 (medical_record)
|
||||
# ========================================
|
||||
|
||||
"medical_record.add": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/medical-record/add",
|
||||
"description": "新增病历",
|
||||
"module": "medical_record",
|
||||
"body_required": True
|
||||
},
|
||||
"medical_record.update": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/medical-record/update",
|
||||
"description": "修改病历",
|
||||
"module": "medical_record",
|
||||
"body_required": True
|
||||
},
|
||||
"medical_record.delete": {
|
||||
"method": "POST",
|
||||
"path": "/api/v1/tpos/medical-record/delete",
|
||||
"description": "删除病历",
|
||||
"module": "medical_record",
|
||||
"body_required": True
|
||||
},
|
||||
}
|
||||
|
||||
|
||||
def get_api_definition(api_name: str) -> Optional[Dict[str, Any]]:
|
||||
"""
|
||||
获取接口定义
|
||||
|
||||
Args:
|
||||
api_name: 接口名称，如 customer.search
|
||||
|
||||
Returns:
|
||||
接口定义字典，不存在则返回 None
|
||||
"""
|
||||
return RUIMEIYUN_APIS.get(api_name)
|
||||
|
||||
|
||||
def get_api_list_by_module(module: str) -> List[Dict[str, Any]]:
|
||||
"""
|
||||
按模块获取接口列表
|
||||
|
||||
Args:
|
||||
module: 模块名称，如 customer, order
|
||||
|
||||
Returns:
|
||||
该模块下的接口列表
|
||||
"""
|
||||
result = []
|
||||
for name, definition in RUIMEIYUN_APIS.items():
|
||||
if definition.get("module") == module:
|
||||
result.append({"name": name, **definition})
|
||||
return result
|
||||
|
||||
|
||||
def get_all_modules() -> List[str]:
|
||||
"""获取所有模块名称"""
|
||||
modules = set()
|
||||
for definition in RUIMEIYUN_APIS.values():
|
||||
if "module" in definition:
|
||||
modules.add(definition["module"])
|
||||
return sorted(list(modules))
|
||||
|
||||
|
||||
def get_api_summary() -> Dict[str, int]:
|
||||
"""获取接口统计"""
|
||||
summary = {}
|
||||
for definition in RUIMEIYUN_APIS.values():
|
||||
module = definition.get("module", "unknown")
|
||||
summary[module] = summary.get(module, 0) + 1
|
||||
return summary
|
||||
Reference in New Issue
Block a user