πŸ“š EAS Station Documentation

Welcome! This is your complete guide to the EAS Station emergency alert system.

> ⚠️ IMPORTANT: This software is experimental and for laboratory use only. Not FCC-certified for production emergency alerting.


πŸš€ Getting Started

Quick Start Path:
  1. Installation - One command to get running
  2. Setup Wizard - First-run configuration
  3. User Guide - Daily operations

πŸ“– Documentation by Role

🎯 For Operators

Daily operations and monitoring
Guide What You'll Learn
User Guide Dashboard, alerts, monitoring
Setup Instructions First-time configuration
HTTPS Setup Secure access configuration

πŸ”§ For Administrators

Deployment, security, and maintenance
Guide What You'll Learn
Portainer Deployment Complete deployment guide
SDR Setup Radio receiver configuration
Hardware Build Raspberry Pi setup
Database Troubleshooting PostgreSQL issues

πŸ’» For Developers

Architecture, APIs, and contributing
Guide What You'll Learn
Developer Guidelines Code standards, architecture, testing
Frontend Documentation UI components, theming
JavaScript API REST API reference
Contributing How to contribute

πŸ—ΊοΈ System Overview

Architecture

EAS Station integrates multiple alert sources (NOAA Weather, IPAWS Federal) and processes them through a sophisticated pipeline that includes:

  • 🌐 Multi-source alert aggregation
  • πŸ“» FCC-compliant SAME encoding
  • πŸ—ΊοΈ PostGIS spatial filtering
  • πŸ“‘ SDR broadcast verification
  • πŸ”’ Built-in HTTPS with Let's Encrypt
  • ⚑ GPIO relay and LED sign control
View Full Architecture Details β†’View Visual Diagrams β†’

πŸ“‚ Documentation Structure

docs/
β”œβ”€β”€ guides/              ← Essential operator guides (5 files)
β”œβ”€β”€ hardware/            ← SDR, GPIO, Raspberry Pi setup
β”œβ”€β”€ audio/               ← Audio system documentation
β”œβ”€β”€ deployment/          ← Deployment and maintenance guides
β”œβ”€β”€ evaluations/         ← Hardware evaluation reports
β”œβ”€β”€ troubleshooting/     ← Problem-solving guides
β”œβ”€β”€ development/         ← Developer documentation
β”œβ”€β”€ architecture/        ← System design and theory
β”œβ”€β”€ frontend/            ← Web UI documentation
β”œβ”€β”€ reference/           ← Technical reference materials
β”œβ”€β”€ security/            ← Security documentation
β”œβ”€β”€ roadmap/             ← Future features and planning
└── resources/           ← Vendor PDFs and external docs
Complete Index - Searchable list of all documentation

🎯 Common Tasks

Setup & Configuration

Daily Operations

Troubleshooting


πŸ†˜ Getting Help

  1. Check the documentation - Start with INDEX
  2. Review troubleshooting - See Common Issues
  3. Run diagnostics - Use built-in diagnostic tools
  4. Ask for help - GitHub Discussions
  5. Report bugs - GitHub Issues

πŸ“Š Project Information

Resource Link
About Project Overview
Changelog Version History
Roadmap Future Features
License AGPL v3 (Open Source) / Commercial

Legal & Compliance


🀝 Contributing

We welcome contributions! See:


Last Updated: 2025-11-25 Documentation Version: 3.0 (Reorganized Structure)Return to Main README | View Complete Index

This document is served from docs/README.md in the EAS Station installation.