预约记录关联查询接口说明

功能概述

新增了一个接口,通过业主姓名关联 ownerinfo 表和 appointment 表,筛选出与当前巡逻员相同车场(community)的数据,返回 appointment 表中的记录。

🌟 主要特性

  • 关联查询 : 通过车牌号关联 ownerinfoappointment
  • 权限过滤: 巡逻员只能查看自己负责社区的数据
  • 多维搜索: 支持车牌号、业主姓名、电话号码搜索
  • 分页支持: 支持分页查询,提高性能
  • 数据丰富: 返回预约信息和业主信息的完整数据

📊 接口详情

后端接口

URL : GET /api/violations/appointment-records-by-owner

参数:

复制代码
{
  "keyword": "搜索关键词(车牌号或业主姓名)", // 可选
  "page": 1,                               // 页码,默认1
  "size": 50                              // 每页数量,默认50
}

响应数据:

复制代码
{
  "code": 200,
  "message": "成功",
  "data": [
    {
      "appointmentId": 123,
      "plateNumber": "京A12345",
      "arriveDate": "2025-01-31 10:00:00",
      "leaveDate": "2025-01-31 12:00:00",
      "parkingSpace": "A-001",
      "appointmentStatus": "confirmed",
      "appointmentCreatedAt": "2025-01-30 15:30:00",
      "ownerId": 456,
      "ownerName": "张三",
      "ownerPhone": "13800138000",
      "community": "阳光花园",
      "parkingDuration": 2.0  // 停车时长(小时)
    }
  ]
}

前端 API 调用

复制代码
import { appointmentAnalysisApi } from '@/api/violation-api.js';

// 查询预约记录
const result = await appointmentAnalysisApi.getAppointmentRecordsByOwner({
  keyword: '京A12345',
  page: 1,
  size: 20
});

🔧 实现细节

后端实现

  1. Controller 层 (ViolationsController.java)
    • 新增 getAppointmentRecordsByOwner 接口方法
    • 处理参数验证和异常处理
    • 记录详细的操作日志
  1. Service 层 (ViolationsService.java & ViolationsServiceImpl.java)
    • 实现业务逻辑
    • 权限控制:巡逻员只能查看自己负责社区的数据
    • 数据关联查询和格式化
  1. SQL 查询逻辑

    SELECT DISTINCT
    a.id as appointment_id,
    a.plate_number,
    a.arrive_date,
    a.leave_date,
    a.parking_space,
    a.status as appointment_status,
    a.created_at as appointment_created_at,
    o.id as owner_id,
    o.name as owner_name,
    o.phone as owner_phone,
    o.community,
    TIMESTAMPDIFF(HOUR, a.arrive_date, a.leave_date) as parking_hours
    FROM appointment a
    INNER JOIN ownerinfo o ON a.plate_number = o.plate_number
    WHERE 1=1
    AND o.community = '当前巡逻员小区' -- 🔒 严格的小区权限过滤
    AND (a.community IS NULL OR a.community = '' OR a.community = '当前巡逻员小区') -- 🔒 appointment表小区一致性检查
    AND o.isaudit = '是' -- 🔍 只查询已审核的业主
    AND (
    a.plate_number LIKE '%关键词%'
    OR o.name LIKE '%关键词%'
    OR o.phone LIKE '%关键词%'
    ) -- 🔍 搜索条件
    ORDER BY a.created_at DESC
    LIMIT 50 OFFSET 0; -- 📄 分页

前端实现

  1. API 封装 (violation-api.js)
    • 新增 getAppointmentRecordsByOwner 方法
    • 统一参数处理和错误处理
  1. 测试页面 (appointment-owner-test.vue)
    • 完整的测试界面
    • 搜索功能和分页控制
    • 详细的数据展示和状态反馈

🔐 权限控制

  • 巡逻员权限: 严格限制只能查看自己负责小区的预约记录
  • 其他角色: 可以查看所有小区的预约记录(根据实际需求调整)

🔒 严格的小区权限控制逻辑:

  1. 巡逻员身份验证
    • 从 Token 中解析用户角色
    • 如果是巡逻员,从 patrolinfo 表获取其负责的小区
    • 如果巡逻员没有小区信息,直接返回空结果
  1. 小区数据过滤
    • 在 SQL 查询中强制添加 o.community = '巡逻员小区' 条件
    • 额外检查 appointment 表的小区字段(如果存在)
    • 只查询已审核的业主数据 o.isaudit = '是'
  1. 双重保险机制
    • SQL 级别的小区过滤
    • 业务层的二次过滤确认
    • 确保 100% 的数据都与巡逻员小区一致

📱 使用方式

1. 测试接口

访问测试页面:/pages/test/appointment-owner-test

2. 集成到现有功能

复制代码
// 在违规录入页面中使用
const searchOwnerRecords = async (keyword) => {
  try {
    const records = await appointmentAnalysisApi.getAppointmentRecordsByOwner({
      keyword: keyword,
      page: 1,
      size: 20
    });
    
    // 处理返回的数据
    console.log('预约记录:', records);
  } catch (error) {
    console.error('查询失败:', error);
  }
};
相关推荐
寻星探路2 小时前
Java EE初阶启程记12---synchronized 原理
java·java-ee
qq_574656252 小时前
java代码随想录day50|图论理论基础
java·算法·leetcode·图论
算法与编程之美2 小时前
探索flatten的其他参数用法及对报错异常进行修正
人工智能·pytorch·python·深度学习·机器学习
蒋星熠2 小时前
Maven项目管理与构建自动化完全指南
java·前端·python·自动化·maven
sheji34162 小时前
【开题答辩全过程】以 ssm框架的智能校园服务系统为例,包含答辩的问题和答案
java·eclipse
byte轻骑兵2 小时前
Windows 安全分割利器:strtok_s () 详解
c语言·开发语言·windows·安全
Ykkk_2 小时前
小土堆pytorch
人工智能·pytorch·python
FriendshipT2 小时前
图像分割:PyTorch从零开始实现SegFormer语义分割
人工智能·pytorch·python·深度学习·目标检测·语义分割·实例分割
shelter -唯2 小时前
基于selenium库的爬虫实战:京东手机数据爬取
爬虫·python·selenium