数据字典

概述

本文档定义了好停ParkingLink系统中所有核心实体的数据结构,包括字段名称、类型、说明和约束条件。在对接API时,请严格按照本文档的数据定义进行开发和数据校验。所有字段命名遵循snake_case规范,金额单位统一为分(人民币),时间格式统一使用ISO 8601标准。

停车场实体(ParkingLot)

核心字段说明:parking_lot_id为停车场唯一标识,类型String(32),由系统自动生成不可修改。name为停车场名称,类型String(100),必填。address为详细地址,类型String(200),必填。city为所属城市,类型String(50),必填。total_spaces为总车位数,类型Integer,必填且必须大于0。available_spaces为可用车位数,类型Integer,实时计算。longitude和latitude为经纬度坐标,类型Double,用于地图显示和附近搜索。business_hours为营业时间,类型String,格式如00:00-23:59。status为停车场状态,类型String(20),取值active(运营中)或inactive(已停用)。contact_phone为联系电话,类型String(20)。

设备相关字段:camera_count为相机数量,类型Integer。barrier_count为道闸数量,类型Integer。pricing_rule_id为关联的计费规则ID,类型String(32)。created_at和updated_at为创建和更新时间,类型DateTime,格式ISO 8601。description为停车场描述,类型String(500),可选。tags为标签列表,类型Array of String,可选,用于分类和搜索。

订单实体(ParkingOrder)

核心字段说明:order_id为订单唯一标识,类型String(32),系统自动生成。parking_lot_id为关联停车场ID,类型String(32),必填。plate_number为车牌号,类型String(10),必填。vehicle_type为车辆类型,枚举值car/truck/motorcycle/new_energy。enter_time为入场时间,类型DateTime。exit_time为出场时间,类型DateTime,车辆离场前为null。parking_duration为停车时长(秒),类型Integer,离场时自动计算。total_fee为应收总费用(分),类型Integer。paid_fee为实收费用(分),类型Integer。discount_fee为优惠金额(分),类型Integer。

附加字段:enter_image_url为入场抓拍图片URL,类型String(256)。exit_image_url为出场抓拍图片URL,类型String(256)。payment_status为支付状态,类型String(20),关联Payment实体状态。entry_gate和exit_gate为出入通道编号,类型String(32)。remark为备注,类型String(500),可选。

订单状态枚举

pending:进行中,车辆已入场但未出场。completed:已完成,车辆已出场且费用已结清。cancelled:已取消,订单被取消(如入场后短时间内出场或系统误判)。abnormal:异常,订单存在异常情况需要人工处理(如车牌识别失败、计费异常等)。

支付实体(Payment)

核心字段说明:payment_id为支付记录唯一标识,类型String(32)。order_id为关联订单ID,类型String(32)。payment_method为支付方式,枚举值wechat/alipay/etc/cash/monthly_pass/coupon。payment_amount为支付金额(分),类型Integer。payment_status为支付状态。transaction_id为第三方支付平台交易号,类型String(64)。payment_time为支付完成时间,类型DateTime。refund_status为退款状态,类型String(20)。refund_amount为已退款金额(分),类型Integer。

支付状态枚举

unpaid:未支付。paying:支付处理中。paid:已支付。refunding:退款处理中。refunded:已退款。partially_refunded:部分退款。failed:支付失败。

车辆类型枚举

car:小型车(蓝牌、绿牌小型车)。truck:货车(黄牌货车)。motorcycle:摩托车。new_energy:新能源车(绿牌新能源专用)。coach:客车(黄牌客车)。special:特殊车辆(军车、警车、消防车等,通常免费放行)。

计费规则实体(PricingRule)

rule_id为规则唯一标识。rule_name为规则名称。charge_mode为计费模式,枚举值by_duration(按时长)/by_session(按次)/segmented(分段)/tiered(阶梯)。free_duration为免费时长(分钟)。first_period_duration为首段计费时长(分钟)。first_period_fee为首段计费金额(分)。subsequent_period_duration为续段计费时长(分钟)。subsequent_period_fee为续段计费金额(分)。daily_cap为每日封顶金额(分)。night_start_time和night_end_time为夜间时段起止时间(HH:mm格式)。night_fee为夜间费率(分/时段)。

好停ParkingLink — 智慧停车SaaS平台
兼容80+硬件品牌 · 免费试用半年 · 7×24小时云坐席 · 已服务30+城市