| docs/点位管理/点位管理接口文档.md | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| src/service/api/point.ts | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| src/typings/api/point.d.ts | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| src/typings/entities/point.d.ts | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 | |
| src/views/operationsManagement/pointManagement/index.vue | ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 |
docs/点位管理/点位管理接口文档.md
New file @@ -0,0 +1,273 @@ # 点位管理接口文档 ## 接口概览 | 接口名称 | 接口路径 | 请求方式 | 说明 | |---------|---------|---------|------| | 获取点位列表 | `/map/api/v1/point/list` | POST | 获取点位列表 | | 新增点位 | `/map/api/v1/point/add` | POST | 创建新点位 | | 更新点位信息 | `/map/api/v1/point/edit` | POST | 编辑点位 | | 启用/禁用点位 | `/map/api/v1/point/enableDisable` | POST | 启用/禁用点位 | | 获取所有运营中的区域 | `/map/api/v1/point/listElectronicFenceArea` | POST | 获取所有运营中的区域 | | 点位详情 | `/map/api/v1/point/queryById` | GET | 获取点位详情 | --- ## 1. 获取点位列表 ### 接口信息 - **接口路径**: `/map/api/v1/point/list` - **请求方式**: `POST` - **接口说明**: 获取点位列表，支持按类型、状态筛选和关键词搜索 ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | queryParams | string | 否 | 搜索关键词（点位名称或地址） | | pointType | integer($int32) | 否 | 点位类型1运营点位 2测试点位 | | operationStatus | integer($int32) | 否 | 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 | **请求示例**: ```javascript { "queryParams": "天河", "pointType": 1, "operationStatus": 1,2、3、4 } ``` ### 响应参数 | 参数名 | 类型 | 说明 | |-------|------|------| | code | number | 响应状态码 | | msg | string | 响应消息 | | data | array | 响应数据 --点位列表| **点位对象结构**: ```javascript { createBy string 记录创建人，前端忽略 createTime string($date-time) 记录创建时间，前端忽略 deleted boolean 是否删除 0未删除 1已删除 distance number 距离 单位米 effectivePeriod integer($int32) 生效周期 1=“每日生效”、2=“仅工作日生效”、3=“仅非工作日生效”、4=“仅节假日生效” effectiveTimePeriod string 生效时间段 electronicAreaId integer($int64) 电子围栏区域id id integer($int64) operationStatus integer($int32) 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 operationType integer($int32) 运营类型 1=与运营区同步 2=自定义时间段 parkingTimeLimit integer($int32) 限停时长 pointAddress string 点位地址 pointLat number($double) 纬度 pointLon number($double) 经度 pointName string 点位名称 pointNumber string 点位编号唯一 pointPictures string 点位照片 pointPoi string 点位poi pointType integer($int32) 点位类型 1=运营点位 2=测试点位 remarks string 备注 updateBy string 记录修改人，前端忽略 updateTime string($date-time) 记录修改时间，前端忽略 verificationStatus integer($int32) 验证状态 1=待验证、2=验证中、3=已验证 4验证失败 } ``` **响应示例**: ```javascript { "code": 200, "msg": "success", "data": { [ { "id": 1, "name": "天河体育中心站点", "address": "广州市天河区天河路299号", "status": "待启用", "type": "运营", "isOpen": false, "poi": "113.264499,23.130061", "longitude": 113.264499, "latitude": 23.130061, "limitTime": 60, "images": ["https://example.com/image1.jpg"], "operationTimeType": "sync", "customTimeRanges": [] } ] } ``` --- ## 2. 新增点位 ### 接口信息 - **接口路径**: `/map/api/v1/point/add` - **请求方式**: `POST` - **接口说明**: 创建新点位 ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | effectivePeriod | string | 是 | 生效周期 1=“每日生效”、2=“仅工作日生效”、3=“仅非工作日生效”、4=“仅节假日生效” | | effectiveTimePeriod | string | 是 | 生效时间段 | | electronicAreaId | string | 是 | 电子围栏区域ID | | operationStatus | string | 是 | 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 | | operationType | string | 是 | 运营类型 1=与运营区同步 2=自定义时间段 | | parkingTimeLimit | string | 是 | 限停时长 | | pointAddress | string | 是 | 点位地址 | | pointLat | number | 是 | 纬度 | | pointLon | number | 是 | 经度 | | pointName | string | 是 | 点位名称 | | pointNumber | string | 是 | 点位编号唯一 | | pointPictures | string | 是 | 点位照片 | | pointPoi | string | 否 | 点位POI | | pointType | integer($int32) | 是 | 点位类型 1=运营点位 2=测试点位 | | remarks | string | 否 | 备注 | | verificationStatus | string | 否 | 验证状态 1=待验证、2=验证中、3=已验证 4=验证失败 | ## 启用/禁用点位 ### 接口信息 - **接口路径**: `/api/points/toggle` - **请求方式**: `POST` - **接口说明**: 切换点位的启用/禁用状态 ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| | id | number | 是 | 点位ID | | operationStatus | integer($int32) | 是 | 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 | **请求示例**: ```javascript { "id": 1, "operationStatus": 3, // 3=已停用 } ``` ### 响应参数 | 参数名 | 类型 | 说明 | |-------|------|------| | code | number | 响应状态码 | | message | string | 响应消息 | **响应示例**: ```javascript { "code": 200, "message": "点位已停用" } ``` --- ## 获取所有运营中的区域 ### 接口信息 - **接口路径**: `/map/api/v1/point/listElectronicFenceArea` - **请求方式**: `POST` - **接口说明**: 获取所有运营中的区域 ### 请求参数 | 参数名 | 类型 | 必填 | 说明 | |-------|------|------|------| **请求示例**: ```javascript { } ``` ### 响应参数 | 参数名 | 类型 | 说明 | |-------|------|------| | code | number | 响应状态码 | | message | string | 响应消息 | **响应示例**: ```javascript { "code": 200, "msg": "success", "data": [ { "areaDescription": "天河体育中心运营区", "areaName": "天河体育中心", "areaStatus": 1, "areaType": 1, "createBy": "admin", "createTime": "2023-08-01T00:00:00Z", "deleted": false, "electronicId": 123456, "id": 123456, "fencePoints": "113.264499,23.130061,113.264499,23.130061", } ] } ``` --- ## 附录 ### 点位状态说明 | 状态值 | 说明 | 适用类型 | |-------|------|---------| | 待测试 | 点位创建后等待测试 | 测试 | | 测试中 | 点位正在测试中 | 测试 | | 测试不通过 | 测试未通过 | 测试 | | 可运营 | 测试通过，可以运营 | 测试 | | 待生效 | 等待生效 | 测试 | | 待启用 | 等待启用 | 运营 | | 启用中 | 正在启用中 | 运营 | | 已停用 | 已停用 | 运营 | | 失效 | 失效 | 运营/测试 | ### 点位类型说明 | 类型值 | 说明 | |-------|------| | 测试 | 测试点位 | | 运营 | 运营点位 | ### 错误码说明 | 错误码 | 说明 | |-------|------| | 200 | 成功 | | 400 | 请求参数错误 | | 401 | 未授权 | | 403 | 禁止访问 | | 404 | 资源不存在 | | 500 | 服务器错误 | src/service/api/point.ts
New file @@ -0,0 +1,62 @@ import { createEncryptedRequest, request } from '../http' export function fetchPointList(params: Api.Point.ListParams) { return createEncryptedRequest<Entity.Point[]>(request, { path: '/map/api/v1/point/list', data: params, options: { sensitiveFields: [], }, }) } export function createPoint(data: Api.Point.CreateData) { return createEncryptedRequest<any>(request, { path: '/map/api/v1/point/add', data, options: { sensitiveFields: [], }, }) } export function updatePoint(data: Api.Point.UpdateData) { return createEncryptedRequest<any>(request, { path: '/map/api/v1/point/edit', data, options: { sensitiveFields: [], }, }) } export function enableDisablePoint(data: Api.Point.EnableDisableData) { return createEncryptedRequest<any>(request, { path: '/map/api/v1/point/enableDisable', data, options: { sensitiveFields: [], }, }) } export function fetchPointDetail(id: number) { return createEncryptedRequest<Entity.Point>(request, { path: '/map/api/v1/point/queryById', method: 'GET', data: { id }, options: { sensitiveFields: [], }, }) } export function fetchElectronicFenceAreaList() { return createEncryptedRequest<Entity.ElectronicFenceArea[]>(request, { path: '/map/api/v1/point/listElectronicFenceArea', data: {}, options: { sensitiveFields: [], }, }) } src/typings/api/point.d.ts
New file @@ -0,0 +1,93 @@ /// <reference path="../global.d.ts"/> namespace Api { namespace Point { interface ListParams { /** 搜索关键词（点位名称或地址） */ queryParams?: string /** 点位类型 1=运营点位 2=测试点位 */ pointType?: number /** 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 */ operationStatus?: number } interface CreateData { /** 生效周期 1=“每日生效”、2=“仅工作日生效”、3=“仅非工作日生效”、4=“仅节假日生效” */ effectivePeriod: string /** 生效时间段 */ effectiveTimePeriod: string /** 电子围栏区域ID */ electronicAreaId: string /** 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 */ operationStatus: string /** 运营类型 1=与运营区同步 2=自定义时间段 */ operationType: string /** 限停时长 */ parkingTimeLimit: string /** 点位地址 */ pointAddress: string /** 纬度 */ pointLat: number /** 经度 */ pointLon: number /** 点位名称 */ pointName: string /** 点位编号唯一 */ pointNumber: string /** 点位照片 */ pointPictures: string /** 点位POI */ pointPoi?: string /** 点位类型 1=运营点位 2=测试点位 */ pointType: number /** 备注 */ remarks?: string /** 验证状态 1=待验证、2=验证中、3=已验证 4=验证失败 */ verificationStatus?: string } interface UpdateData { /** 点位ID */ id: number /** 生效周期 1=“每日生效”、2=“仅工作日生效”、3=“仅非工作日生效”、4=“仅节假日生效” */ effectivePeriod?: string /** 生效时间段 */ effectiveTimePeriod?: string /** 电子围栏区域ID */ electronicAreaId?: string /** 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 */ operationStatus?: string /** 运营类型 1=与运营区同步 2=自定义时间段 */ operationType?: string /** 限停时长 */ parkingTimeLimit?: string /** 点位地址 */ pointAddress?: string /** 纬度 */ pointLat?: number /** 经度 */ pointLon?: number /** 点位名称 */ pointName?: string /** 点位编号唯一 */ pointNumber?: string /** 点位照片 */ pointPictures?: string /** 点位POI */ pointPoi?: string /** 点位类型 1=运营点位 2=测试点位 */ pointType?: number /** 备注 */ remarks?: string /** 验证状态 1=待验证、2=验证中、3=已验证 4=验证失败 */ verificationStatus?: string } interface EnableDisableData { /** 点位ID */ id: number /** 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 */ operationStatus: number } } } src/typings/entities/point.d.ts
New file @@ -0,0 +1,75 @@ /// <reference path="../global.d.ts"/> namespace Entity { interface Point { /** 点位ID */ id?: number /** 点位名称 */ pointName?: string /** 点位地址 */ pointAddress?: string /** 点位编号唯一 */ pointNumber?: string /** 点位POI */ pointPoi?: string /** 经度 */ pointLon?: number /** 纬度 */ pointLat?: number /** 点位类型 1=运营点位 2=测试点位 */ pointType?: number /** 运营状态 1=待启用 2=启用中 3=已停用 4=已失效 */ operationStatus?: number /** 验证状态 1=待验证、2=验证中、3=已验证 4=验证失败 */ verificationStatus?: number /** 运营类型 1=与运营区同步 2=自定义时间段 */ operationType?: number /** 限停时长 */ parkingTimeLimit?: number /** 点位照片 */ pointPictures?: string /** 电子围栏区域id */ electronicAreaId?: number /** 生效周期 1=“每日生效”、2=“仅工作日生效”、3=“仅非工作日生效”、4=“仅节假日生效” */ effectivePeriod?: number /** 生效时间段 */ effectiveTimePeriod?: string /** 备注 */ remarks?: string /** 距离 单位米 */ distance?: number /** 是否删除 0未删除 1已删除 */ deleted?: boolean /** 记录创建人，前端忽略 */ createBy?: string /** 记录创建时间，前端忽略 */ createTime?: string /** 记录修改人，前端忽略 */ updateBy?: string /** 记录修改时间，前端忽略 */ updateTime?: string } interface ElectronicFenceArea { /** 区域ID */ id?: number /** 电子围栏ID */ electronicId?: number /** 区域名称 */ areaName?: string /** 区域描述 */ areaDescription?: string /** 区域状态 */ areaStatus?: number /** 区域类型 */ areaType?: number /** 围栏点坐标 */ fencePoints?: string /** 是否删除 */ deleted?: boolean /** 创建人 */ createBy?: string /** 创建时间 */ createTime?: string } } src/views/operationsManagement/pointManagement/index.vue
@@ -1,6 +1,7 @@ <script setup lang="tsx"> import { computed, onMounted, onUnmounted, ref } from 'vue' import { useScriptTag } from '@vueuse/core' import { fetchElectronicFenceAreaList } from '@/service/api/point' import PointStatusSteps from '@/components/PointStatusSteps/custom.vue' import ConfirmDialog from '@/components/ConfirmDialog/index.vue' @@ -515,8 +516,23 @@ showDeleteConfirm.value = false } // 获取所有运营中的区域 async function loadElectronicFenceAreaList() { try { const { data, isSuccess } = await fetchElectronicFenceAreaList() if (isSuccess) { console.log('运营区域列表:', data) } } catch (error) { console.error('获取运营区域失败:', error) } } onMounted(() => { initMap() // 获取运营区域列表 loadElectronicFenceAreaList() // 默认选中第一个点位 if (pointList.value.length > 0) { currentPoint.value = pointList.value[0]
