# escort-service **Repository Path**: chinamd5/escort-service ## Basic Information - **Project Name**: escort-service - **Description**: 陪诊师平台用户端 - **Primary Language**: Java - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 2 - **Created**: 2026-08-06 - **Last Updated**: 2026-08-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # escort-service 陪诊师服务 陪诊师服务,提供陪诊师等级配置等业务功能。 ## 技术栈 - Java 8 - Spring Boot 2.7.14 - MyBatis Plus 3.5.3.1 - MySQL 8.0 - Maven ## 项目结构 ``` escort-service/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/escort/escortservice/ │ │ │ ├── EscortServiceApplication.java # 启动类 │ │ │ ├── config/ # 配置类 │ │ │ │ └── MyBatisPlusConfig.java │ │ │ ├── controller/ # 控制器 │ │ │ │ └── EscortLevelController.java │ │ │ ├── dto/ # 数据传输对象 │ │ │ │ ├── ApiResponse.java │ │ │ │ ├── CommissionRuleDTO.java │ │ │ │ ├── CreateLevelRequest.java │ │ │ │ ├── EscortLevelDTO.java │ │ │ │ ├── LevelListRequest.java │ │ │ │ └── PaginationData.java │ │ │ ├── entity/ # 实体类 │ │ │ │ └── EscortLevel.java │ │ │ ├── exception/ # 异常处理 │ │ │ │ └── GlobalExceptionHandler.java │ │ │ ├── mapper/ # Mapper接口 │ │ │ │ └── EscortLevelMapper.java │ │ │ ├── service/ # 服务接口 │ │ │ │ └── EscortLevelService.java │ │ │ └── util/ # 工具类 │ │ │ └── JsonUtils.java │ │ └── resources/ │ │ ├── application.yml # 主配置 │ │ └── application-dev.yml # 开发环境配置 │ └── test/ # 测试代码 ├── sql/ │ └── init.sql # 数据库初始化脚本 ├── pom.xml # Maven配置 └── README.md # 项目说明 ``` ## 接口文档 ### 1. 获取陪诊师等级列表 **接口**: `GET /escort-levels` **参数**: | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | name | string | 否 | 等级名称(模糊搜索) | | status | string | 否 | 状态:enabled-启用,disabled-禁用 | | startTime | string | 否 | 创建时间范围开始,格式:yyyy-MM-dd HH:mm:ss | | endTime | string | 否 | 创建时间范围结束,格式:yyyy-MM-dd HH:mm:ss | | page | int | 否 | 页码,默认1 | | pageSize | int | 否 | 每页条数,默认10 | **响应示例**: ```json { "code": 0, "message": "success", "data": { "list": [ { "id": "level_junior_001", "name": "初级陪诊师", "code": "junior", "description": "新入职陪诊师,需完成基础培训并通过考核", "upgradeRule": { "minOrders": 100, "minRating": 4.8, "ratingPeriodMonths": 6, "maxComplaintCount": 2, "complaintPeriodMonths": 3, "requireTraining": true, "trainingCourseId": "course_basic_001" }, "commissionRule": { "type": "fixed", "fixedRate": 0.5, "specialScenes": { "night": 1.2, "holiday": 1.3, "emergency": 1.5 } }, "permission": { "dailyOrderLimit": 5, "dispatchWeight": 0.8, "serviceTypes": ["general"], "exclusiveBenefits": { "priorityDispatch": false, "vipCustomerAccess": false, "customServicePrice": false } }, "status": 1, "version": 1, "createTime": "2024-01-15T10:30:00", "modifyTime": "2024-01-15T10:30:00" } ], "total": 3, "page": 1, "pageSize": 10 } } ``` ### 2. 创建陪诊师等级 **接口**: `POST /escort-levels` **请求参数**: | 参数名 | 类型 | 必填 | 说明 | |--------|------|------|------| | name | string | 是 | 等级名称 | | code | string | 是 | 等级编码,唯一 | | description | string | 否 | 等级描述 | | upgradeRule | object | 是 | 升级规则 | | commissionRule | object | 是 | 提成规则 | | permission | object | 是 | 权限配置 | | status | string | 否 | 状态,enabled-启用(默认),disabled-禁用 | **upgradeRule字段说明**: | 参数名 | 类型 | 说明 | |--------|------|------| | minOrders | int | 最少完成订单数 | | minRating | double | 最低评分 | | ratingPeriodMonths | int | 评分统计周期(月) | | maxComplaintCount | int | 最大允许投诉次数 | | complaintPeriodMonths | int | 投诉统计周期(月) | | requireTraining | boolean | 是否需要培训 | | trainingCourseId | string | 培训课程ID | **commissionRule字段说明**: | 参数名 | 类型 | 说明 | |--------|------|------| | type | string | 提成类型:fixed-固定比例,tiered-阶梯提成 | | fixedRate | double | 固定提成比例(type=fixed时有效) | | tiers | array | 阶梯提成配置(type=tiered时有效) | | specialScenes | object | 特殊场景提成加成 | tiers数组元素: - minAmount: 最小金额 - maxAmount: 最大金额(为空表示无上限) - rate: 该阶梯提成比例 specialScenes对象: - night: 夜间服务加成 - holiday: 节假日服务加成 - emergency: 急诊服务加成 **permission字段说明**: | 参数名 | 类型 | 说明 | |--------|------|------| | dailyOrderLimit | int | 每日接单上限 | | dispatchWeight | double | 派单权重 | | serviceTypes | array | 可接服务类型 | | exclusiveBenefits | object | 专属权益 | exclusiveBenefits对象: - priorityDispatch: 优先派单 - vipCustomerAccess: VIP客户权限 - customServicePrice: 自定义服务价格 **请求示例**: ```json { "name": "初级陪诊师", "code": "junior", "description": "新入职陪诊师,需完成基础培训并通过考核", "upgradeRule": { "minOrders": 100, "minRating": 4.8, "ratingPeriodMonths": 6, "maxComplaintCount": 2, "complaintPeriodMonths": 3, "requireTraining": true, "trainingCourseId": "course_basic_001" }, "commissionRule": { "type": "fixed", "fixedRate": 0.5, "specialScenes": { "night": 1.2, "holiday": 1.3, "emergency": 1.5 } }, "permission": { "dailyOrderLimit": 5, "dispatchWeight": 0.8, "serviceTypes": ["general"], "exclusiveBenefits": { "priorityDispatch": false, "vipCustomerAccess": false, "customServicePrice": false } }, "status": "enabled" } ``` **响应示例**: ```json { "code": 0, "message": "success", "data": { "id": "xxx", "name": "初级陪诊师", "code": "junior", ... } } ``` ## 数据库表结构 ### escort_level(陪诊师等级配置表) | 字段名 | 类型 | 说明 | |--------|------|------| | id | VARCHAR(64) | 主键,等级ID | | name | VARCHAR(64) | 等级名称 | | code | VARCHAR(32) | 等级编码,唯一 | | description | VARCHAR(500) | 等级描述 | | upgrade_rule | JSON | 升级规则 | | commission_rule | JSON | 提成规则 | | permission | JSON | 权限配置 | | status | TINYINT | 状态:0-禁用,1-启用 | | version | INT | 版本号,乐观锁 | | create_time | DATETIME | 创建时间 | | modify_time | DATETIME | 修改时间 | ## 启动步骤 1. 创建数据库并执行初始化脚本: ```bash mysql -u root -p < sql/init.sql ``` 2. 修改数据库连接配置(如需要): 编辑 `src/main/resources/application-dev.yml` 中的数据库连接信息 3. 编译项目: ```bash mvn clean compile ``` 4. 启动服务: ```bash mvn spring-boot:run ``` 或使用IDEA直接运行 `EscortServiceApplication` 类 服务默认启动在 http://localhost:8082 ## API测试 可以使用curl或Postman测试接口: ```bash # 查询等级列表 curl "http://localhost:8082/escort-levels?page=1&pageSize=10" # 创建等级 curl -X POST "http://localhost:8082/escort-levels" \ -H "Content-Type: application/json" \ -d '{ "name": "初级陪诊师", "code": "junior", "description": "新入职陪诊师", "upgradeRule": { "minOrders": 100, "minRating": 4.8, "ratingPeriodMonths": 6, "maxComplaintCount": 2, "complaintPeriodMonths": 3, "requireTraining": true, "trainingCourseId": "course_basic_001" }, "commissionRule": { "type": "fixed", "fixedRate": 0.5, "specialScenes": { "night": 1.2, "holiday": 1.3, "emergency": 1.5 } }, "permission": { "dailyOrderLimit": 5, "dispatchWeight": 0.8, "serviceTypes": ["general"], "exclusiveBenefits": { "priorityDispatch": false, "vipCustomerAccess": false, "customServicePrice": false } }, "status": "enabled" }' ```