AirTrail数据库设计揭秘：航班数据存储与关联关系详解-平芜编程栈

AirTrail数据库设计揭秘：航班数据存储与关联关系详解

【免费下载链接】AirTrailA modern, open-source personal flight tracking system项目地址: https://gitcode.com/gh_mirrors/ai/AirTrail

AirTrail作为现代开源个人航班跟踪系统，其高效的数据管理能力源于精心设计的数据库架构。本文将深入剖析AirTrail的数据库设计理念，揭示航班数据的存储结构与关联关系，帮助开发者和用户更好地理解系统背后的数据组织方式。

数据库整体架构概览

AirTrail采用PostgreSQL作为数据库引擎，通过Prisma ORM实现数据模型的定义与管理。核心数据模型集中定义在prisma/schema.prisma文件中，包含16个主要模型，涵盖用户管理、航班信息、机场数据、航空器信息等关键实体。

数据库设计遵循以下原则：

采用关系型数据库存储结构化航班数据
通过外键约束确保数据完整性
使用索引优化查询性能
支持自定义字段扩展
实现多用户数据隔离

图1：AirTrail系统中的航班数据可视化展示，体现了数据库中存储的航线关系

核心数据模型解析

用户与权限模型

用户模型是AirTrail数据架构的基础，定义在schema.prisma的第21-54行：

model user { id String @id username String @unique display_name String password String? role String /// @kyselyType('user' | 'admin' | 'owner') oauth_id String? // 单位偏好设置... sessions session[] seats seat[] visited_countries visited_country[] api_keys api_key[] public_share public_share[] }

该模型不仅存储用户基本信息，还通过关系字段关联用户的航班记录、会话信息、访问过的国家等数据。角色字段(role)实现了基于角色的访问控制，支持用户、管理员和所有者三种权限级别。

机场与地理位置数据

机场模型是航班跟踪的核心地理参考点，定义在第56-75行：

model airport { id Int @id @default(autoincrement()) icao String iata String? lat Float lon Float tz String name String municipality String? type String /// @kyselyType('large_airport' | 'medium_airport' | ...) continent String /// @kyselyType('EU' | 'NA' | 'SA' | 'AS' | 'AF' | 'OC' | 'AN') country String custom Boolean @default(false) flights_from flight[] @relation("flights_from") flights_to flight[] @relation("flights_to") }

AirTrail通过ICAO代码唯一标识机场，并存储经纬度、时区、名称等关键信息。2025年8月的迁移prisma/migrations/20250824233100_airport_foreign_keys/migration.sql引入了机场外键约束，将航班与机场的关系从字符串引用改为ID关联，显著提升了数据完整性和查询性能。

航班数据模型

航班模型是AirTrail的核心业务实体，定义在第102-149行：

model flight { id Int @id @default(autoincrement()) date String date_precision String @default("day") /// @kyselyType('day' | 'month' | 'year') departure String? /// YYYY-MM-DDTHH:mm:ss.sssZ (ISO-8601) arrival String? /// YYYY-MM-DDTHH:mm:ss.sssZ (ISO-8601) // 其他时间字段... duration Int? departure_terminal String? departure_gate String? arrival_terminal String? arrival_gate String? flight_number String? flight_reason String? /// @kyselyType('leisure' | 'business' | 'crew' | 'other') aircraft_reg String? note String? from_id Int? to_id Int? aircraft_id Int? airline_id Int? from airport? @relation("flights_from", fields: [from_id], references: [id]) to airport? @relation("flights_to", fields: [to_id], references: [id]) aircraft aircraft? @relation(fields: [aircraft_id], references: [id]) airline airline? @relation(fields: [airline_id], references: [id]) seats seat[] }

该模型设计体现了以下特点：

支持不同精度的日期记录（天、月、年）
存储多种时间戳（计划时间、实际时间）
包含机场终端和登机口信息
通过外键关联出发/到达机场、航空公司和航空器
支持多乘客记录（通过seat关系）

图2：添加航班界面展示了与flight模型对应的用户输入项

航空公司与航空器模型

航空公司和航空器模型分别定义在第89-100行和第77-87行：

model airline { id Int @id @default(autoincrement()) name String icao String? iata String? icon_path String? source_id String? flights flight[] } model aircraft { id Int @id @default(autoincrement()) name String icao String? /// ICAO aircraft type code source_id String? flights flight[] }

这两个模型存储了航空公司和航空器的基本信息，并通过一对多关系与航班模型关联。航空公司模型还支持图标路径存储，用于在UI中显示航空公司标志。

数据关系网络

AirTrail数据库中的实体通过精心设计的关系形成一个有机整体：

航班-机场关系：一个航班从一个机场出发(from)，到达另一个机场(to)，形成一对多关系
航班-航空公司关系：一个航空公司可以运营多个航班
航班-航空器关系：一个航空器可以执行多个航班
用户-航班关系：通过seat模型实现多对多关系，一个用户可以有多个航班，一个航班可以有多个乘客
用户-访问国家关系：记录用户访问过的国家信息

图3：亮色主题下的航班数据可视化，展示了数据库中存储的多航线网络关系

数据扩展性设计

AirTrail通过custom_field_definition和custom_field_value模型实现了灵活的数据扩展机制：

model custom_field_definition { id Int @id @default(autoincrement()) entity_type String /// @kyselyType('flight') key String label String field_type String /// @kyselyType('text' | 'textarea' | 'number' | ...) // 其他字段定义属性... values custom_field_value[] } model custom_field_value { id Int @id @default(autoincrement()) field_id Int field custom_field_definition @relation(fields: [field_id], references: [id], onDelete: Cascade) entity_type String /// @kyselyType('flight') entity_id String value Json }

这种设计允许用户为航班等实体添加自定义字段，而无需修改数据库结构，极大增强了系统的灵活性和适应性。