Home

TrueHour Wiki

Welcome to the TrueHour documentation! TrueHour is a personal aviation expense tracking and flight management application.

Current Status: v2.0 - Production Ready 🚀

TrueHour v2.0 is a complete rewrite featuring:

• Modern React Frontend - React 18 + Vite + Tailwind CSS + TypeScript
• PostgreSQL Database - Full data persistence with async connection pooling
• Budget Card System - Outcome-based budgeting with real-time calculations
• Flight Logging - ForeFlight CSV import with 100+ logbook fields
• Aircraft Management - FAA database with 308K+ aircraft, enriched data (complex, high-performance)
• Expense Tracking - Multi-category expenses with budget card linking
• Training Progress - Certification tracking (PPL, IR, CPL, CFI, etc.)
• Docker Deployment - Multi-platform containers (amd64/arm64) on port 8181
• Automated Testing - 14-test smoke test suite with test data generator
• Data Privacy - Local-first, no cloud dependencies, data never leaves your machine

🚀 Quick Start

• Getting Started - Installation and setup
• Development Guide - Local development workflow
• Architecture Overview - System design and structure

📖 Documentation

User Guides

• Aircraft Management - Managing your aircraft list
• ForeFlight Import - Importing flight logs (coming soon)

Development

• Development Guide - Setting up your environment
• Contributing - How to contribute
• Branch Strategy - Git workflow and branching

Technical Documentation

• Architecture Overview - System architecture
• API Documentation - REST API reference
• Database Design - Database schema
• Deployment Guide - Deployment instructions

DevOps & Infrastructure

• CI/CD Pipeline - Automated builds and deployments
• Dependency Management - Managing dependencies
• Release Process - How releases are created
• Container Setup - Docker configuration

📦 Project Structure

truehour/
├── frontend-react/    # React 18 + Vite + TypeScript frontend
├── backend/           # Python FastAPI application
├── infrastructure/    # Docker configs, Dockerfiles, .env
├── tests/             # Smoke test suite and test data generator
├── data/             # Local config.json (gitignored)
├── archive/          # Legacy v1 code (gitignored)
└── wiki/             # Documentation source

🔗 Links

• GitHub Repository: FliteAxis/TrueHour
• Issues: Report bugs or request features
• Changelog: View release history

📝 Migration Notice

This project consolidates:

• ryakel/flight-budget → Frontend and expense tracking
• ryakel/tail-lookup → FAA aircraft registry backend

Both repositories are now archived. All future development happens here.

🤝 Contributing

We welcome contributions! See our Contributing Guide for details.

📜 License

MIT License - See LICENSE for details