✈️ PilotPath

Your journey to becoming a pilot.

PilotPath is a platform built to accompany pilots throughout their entire journey, from the first aviation certification to their professional career.

The platform combines study management, aviation knowledge, performance tracking and future operational tools into a single ecosystem.

---

---

🚀 Features

📚 Study Management

• Certification enrollments
• Certification curriculum
• Subject management
• Study sessions
• Paginated study history
• Study activity filtering

---

🛫 Aviation Knowledge

• Aviation subjects
• Question bank
• Question practice
• Flashcards
• Mock exams

---

📊 Learning Analytics

• Learning statistics aggregation
• Flashcard performance analysis
• Question performance analysis
• Mock exam analytics
• Subject performance analysis
• Weak subject detection
• Performance trends

---

🔐 Authentication

• User registration
• User login
• JWT authentication
• Protected API routes

---

🛠 Tech Stack

Frontend

• Next.js (App Router)
• React
• TypeScript
• Tailwind CSS
• shadcn/ui
• Base UI
• Lucide Icons
• TanStack Query
• React Hook Form
• Zod

Backend

• NestJS
• TypeScript
• Prisma ORM
• REST API
• Swagger/OpenAPI

Database

• PostgreSQL

Infrastructure

• Docker (optional)
• GitHub Actions (planned)

---

🏗 Architecture

                User
                  │
                  ▼
          Next.js Frontend
                  │
           REST / JSON API
                  │
                  ▼
          NestJS Backend
                  │
      Authentication Layer
                  │
             Prisma ORM
                  │
                  ▼
            PostgreSQL

The frontend follows a feature-based architecture using Next.js App Router.

The backend follows a modular architecture using NestJS modules.

---

📁 Project Structure

pilot-path/
│
├── backend/
│   └── NestJS application
│
├── frontend/
│   └── Next.js application
│
├── docs/
│   ├── architecture.md
│   ├── frontend-architecture.md
│   ├── database.md
│   ├── setup.md
│   ├── roadmap.md
│   ├── decisions.md
│   └── features/
│
├── docker-compose.yml
├── README.md
└── .gitignore

---

📖 Documentation

Project documentation is available in the docs directory.

Includes:

• System Architecture
• Frontend Architecture
• Development Setup
• Roadmap
• Architecture Decision Records (ADR)
• Database Migrations
• Database Seeding

---

🚀 Development

Backend

cd backend

npm install

npm run start:dev

Frontend

cd frontend

npm install

npm run dev

Useful commands:

npm run lint

npm run build

---

🚧 Project Status

Roadmap Milestone: v0.6 - Frontend Application (see docs/roadmap.md)

Package Versions: backend v0.5.5 · frontend v0.1.0

Completed

Backend Foundation

• NestJS backend setup
• PostgreSQL connectivity
• Prisma ORM integration
• Database schema
• Database migrations
• Core domain modeling

Authentication

• User registration
• Login
• JWT authentication
• Password hashing
• Protected API routes
• Swagger authentication

Learning Platform

• Certifications
• Subjects
• Enrollments
• Study sessions
• Study history
• Flashcards
• Flashcard reviews
• Question bank
• Question practice
• Mock exams

Learning Analytics

• Learning statistics API
• Flashcard performance statistics
• Question performance statistics
• Mock exam statistics
• Subject performance analytics

Frontend Foundation

• Next.js App Router setup
• TypeScript configuration
• Tailwind CSS setup
• shadcn/ui integration
• Base UI configuration
• Lucide Icons integration
• Feature-based folder structure
• ESLint configuration
• Prettier configuration
• Provider architecture
• Frontend authentication flow
• Login page
• Registration page
• Protected routes
• Authentication persistence
• Authentication context
• Session restoration
• Application layout (sidebar + protected shell)
• Dashboard interface (learning statistics, certifications overview, recent activity)
• Certification list and detail interface

---

In Progress

• Flashcard review interface
• Mock exam interface
• Learning analytics dashboard visualization

---

📄 License

MIT