arelenglish/arelplane

Arelplane 应用文档

概述

Arelplane是一个基于Rails框架开发的应用程序，主要功能是管理机场和导航辅助设施数据，并通过MapSnap服务生成地图图像。该应用依赖PostgreSQL数据库进行数据存储，适用于需要处理航空数据和地图可视化的场景。

核心功能与特性

• 机场和导航辅助设施数据管理
• 集成MapSnap服务生成地图图像
• 支持PostgreSQL数据库的数据持久化
• 提供数据库迁移功能
• 可导入外部航空数据源

使用场景与适用范围

• 航空数据管理系统
• 机场信息查询平台
• 导航辅助设施可视化应用
• 航空相关地图服务开发

依赖项

• PostgreSQL：数据存储服务，推荐使用Homebrew管理安装
• MapSnap：地图图像生成服务，需单独部署
• Rails依赖库：详见应用Gemfile

使用方法与配置说明

基础启动步骤

1. 克隆代码仓库
2. 执行bundle install安装依赖
3. 执行rake db:migrate进行数据库迁移
4. 启动Rails服务器：rails server

数据导入

如需填充机场和导航辅助设施数据，可使用以下数据源，但需自行编写导入脚本：

• 机场数据：[***]
• 导航辅助数据：[***]

MapSnap服务配置

1. 下载MapSnap服务：https://github.com/arelenglish/map-snap
2. 启动MapSnap服务
3. 在Arelplane项目中创建config/local_env.yml文件，添加以下配置：

yaml
MAPSNAP_ROOT_URL: 'http://localhost:8080'
MAP_SNAP_API_KEY: 'your_api_key'

PostgreSQL配置

安装与启动（使用Homebrew）

bash
# 安装PostgreSQL
brew install postgresql

# 启动服务并设置开机自启
brew services start postgresql

# 或临时启动（不设置自启）
pg_ctl -D /usr/local/var/postgres start

Docker部署示例

docker-compose.yml配置

yaml
version: '3'
services:
  app:
    build: .
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgres://postgres:password@db:5432/arelplane
    depends_on:
      - db
    volumes:
      - ./config/local_env.yml:/app/config/local_env.yml

  db:
    image: postgres:13
    environment:
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=arelplane
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

启动命令

bash
# 构建并启动服务
docker-compose up -d

# 执行数据库迁移
docker-compose exec app rake db:migrate