# SkyView Database Management

SkyView includes a comprehensive database management system for enriching aircraft callsigns with airline and airport information.

## Quick Start

### 1. Check Current Status
```bash
skyview-data status
```

### 2. Import Safe Data (Recommended)
```bash
# Import public domain sources automatically
skyview-data update
```

### 3. Enable Automatic Updates (Optional)
```bash
# Weekly updates on Sunday at 3 AM
sudo systemctl enable --now skyview-database-update.timer
```

## Available Data Sources

### Safe Sources (Public Domain)
These sources are imported automatically with `skyview-data update`:
- **OurAirports**: Comprehensive airport database (public domain)
- **FAA Registry**: US aircraft registration data (public domain)

### License-Required Sources  
These require explicit acceptance:
- **OpenFlights**: Airline and airport data (AGPL-3.0 license)

## Commands

### Basic Operations
```bash
skyview-data list                    # Show available sources
skyview-data status                  # Show database status  
skyview-data update                  # Update safe sources
skyview-data import openflights     # Import licensed source
skyview-data clear <source>         # Remove source data
```

### Systemd Timer Management
```bash
# Enable weekly automatic updates
systemctl enable skyview-database-update.timer
systemctl start skyview-database-update.timer

# Check timer status
systemctl status skyview-database-update.timer

# View update logs
journalctl -u skyview-database-update.service

# Disable automatic updates
systemctl disable skyview-database-update.timer
```

## License Compliance

SkyView maintains strict license separation:
- **SkyView binary**: Contains no external data (stays MIT licensed)
- **Runtime import**: Users choose which sources to import
- **Safe defaults**: Only public domain sources updated automatically
- **User choice**: Each person decides their own license compatibility

## Troubleshooting

### Check Service Status
```bash
systemctl status skyview-database-update.timer
journalctl -u skyview-database-update.service -f
```

### Manual Database Reset
```bash
systemctl stop skyview-database-update.timer
skyview-data reset --force
skyview-data update
systemctl start skyview-database-update.timer
```

### Permissions Issues
```bash
sudo chown skyview:skyview /var/lib/skyview/
sudo chmod 755 /var/lib/skyview/
```

## Files and Directories

- `/usr/bin/skyview-data` - Database management command
- `/var/lib/skyview/skyview.db` - Database file  
- `/usr/share/skyview/scripts/update-database.sh` - Cron helper script
- `/lib/systemd/system/skyview-database-update.*` - Systemd timer files

For detailed information, see `man skyview-data`.