Skip to main content
The Planning module is the operational heart of the maintenance organization, managing aircraft registry, work order execution, flight control, and maintenance calendar planning.

​
Overview

Planning coordinates all maintenance activities from aircraft tracking through work order execution, including flight hour/cycle monitoring and maintenance scheduling.

​
Key Features

Aircraft Registry

Maintain complete aircraft records with configuration and time tracking

Work Order Management

Create, schedule, and execute maintenance work orders with task tracking

Flight Control

Log flights and automatically update aircraft/component times

Maintenance Calendar

Visual planning of work orders, tasks, and scheduled maintenance

​
Aircraft Registry

​
Aircraft Management

Maintain comprehensive aircraft records: 
Aircraft:
- Identification:
  - Acronym (registration, e.g., "YV-123A")
  - Serial number
  - Model
- Manufacturer
- Configuration:
  - Fabrication date
  - Aircraft parts/components hierarchy
- Time tracking:
  - Total flight hours
  - Total cycles (takeoff/landing)
- Client:
  - Owner or operator
  - Authorizing type: PROPIETARIO or EXPLOTADOR
- Location (current base)
- Comments and notes

​
Aircraft Components Hierarchy

Aircraft parts are organized in a parent-child hierarchy:
Aircraft: YV-3456
  • Engine #1 (parent component)
    • Part: PT6A-21 Engine
    • Serial: PCE-12345
    • TSN: 4,324 hours
    • CSN: 3,890 cycles
    • Sub-components:
      • Fuel Control Unit (child)
      • Compressor Assembly (child)
      • Turbine Section (child)
  • Engine #2 (parent component)
    • Similar structure
  • Propeller #1 (parent component)
    • Propeller Assembly
    • Sub-components:
      • Propeller Blades
      • Hub Assembly
This hierarchy tracks times (hours/cycles) for each component independently.

​
Aircraft Part Tracking

Aircraft Part:
- Part number and name
- Serial number
- Condition type (SV, OH, RP, etc.)
- Time tracking:
  - Time Since New (TSN)
  - Time Since Overhaul (TSO)
  - Cycles Since New (CSN)
  - Cycles Since Overhaul (CSO)
- Hierarchy:
  - Is father (parent component)
  - Aircraft part ID (parent reference)
  - Sub-parts array (children)
- Linked aircraft

​
Component Time Tracking

Automatic Time Updates:When a flight is logged:
  1. Aircraft total hours/cycles increase
  2. All installed components’ times update automatically
  3. Time-based maintenance triggers are evaluated
  4. Maintenance due alerts are generated

​
Work Order Management

​
Work Order Structure

Work Order:
- Order number (auto-generated)
- Aircraft
- Client (aircraft operator/owner)
- Status:
  - OPEN (created)
  - IN_PROGRESS (work started)
  - INSPECTION (awaiting inspection)
  - COMPLETED (work done)
  - CLOSED (finalized and invoiced)
- Dates:
  - Creation date
  - Scheduled start/completion
  - Actual completion
- Description
- Personnel:
  - Elaborated by
  - Reviewed by
  - Approved by
- Work order tasks
- Preliminary inspection
- Work order report pages

​
Work Order Tasks

Each work order contains maintenance tasks: 
Work Order Task:
- Description
- Task number and origin manual
- ATA code (system classification)
- Status:
  - PENDING
  - IN_PROGRESS
  - COMPLETED
  - INSPECTION
- Personnel:
  - Technician responsible
  - Assigned technicians with hours
  - Inspector responsible
- Total man-hours
- Task items (required parts):
  - Article part number
  - Alternative part numbers
  - Serial number
- Task events (scheduling)
- Non-routine items (discrepancies found)

​
Task Assignment

Tasks support multiple technician assignment:
Assigned Technicians:
- Technician name
- Hours worked on this task
This enables:
  • Accurate labor tracking
  • Multiple techs collaborating on one task
  • Precise man-hour calculations
  • Labor cost allocation

​
Non-Routine Items

Discrepancies found during maintenance: 
Non-Routine Item:
- ATA code
- Description of issue found
- Status
- Action taken or required
- Needs additional task flag
- Linked work order task (if created)
- Child non-routine tasks
Workflow: Technician finds issue → Create non-routine → Generate task → Assign and complete

​
Preliminary Inspection

Pre-maintenance inspection documentation: 
Preliminary Inspection:
- Status
- Authorizing person
- Observation/notes
- Inspection items:
  - ATA code
  - Description
  - Location on aircraft

​
Work Order Reports

Document work performed: 
Work Order Report:
- Report pages (multiple entries)
- Each entry:
  - ATA code
  - Report (findings)
  - Action taken
Forms the basis for maintenance release documentation.

​
Flight Control

​
Flight Logging

Record all flight operations: 
Flight Control:
- Flight number
- Aircraft
- Aircraft operator
- Route:
  - Origin
  - Destination
- Flight date
- Flight hours (this flight)
- Flight cycles (this flight)
- Automatic time updates:
  - Aircraft total hours/cycles
  - All component hours/cycles

​
Flight History

Maintain complete flight records: 
Flight History:
- Flight number
- Linked aircraft part
- Snapshot of part times:
  - TSN before flight
  - TSO before flight
  - CSN before flight
  - CSO before flight
- Flight hours/cycles added
- Created/updated timestamps
Purpose: Historical tracking for maintenance compliance and component life limits

​
Historical Flight Reporting

View flight history with filters:
  • Aircraft Filter: Select specific aircraft
  • Period Filter:
    • By month
    • By custom date range
  • Display: Tabular flight log with cumulative times
  1. Audit Trail: Complete flight log for regulatory compliance
  2. Time Verification: Verify component times for maintenance planning
  3. Utilization Analysis: Track aircraft usage patterns
  4. Billing: Flight hours for operator invoicing
  5. Trend Analysis: Identify heavy vs. light usage periods

​
Maintenance Calendar

Visual planning tool for scheduling:

​
Calendar Features

  • Work Order Events: Scheduled work order dates
  • Task Events: Individual task scheduling within work orders
  • Service Events: Planned maintenance from service library
  • Calendar Views: Day, week, month views
  • Drag-and-Drop: Reschedule events visually
  • Priority Indicators: Color-coding by priority (LOW, MEDIUM, HIGH)

​
Planification Events

Planification Event:
- Title and description
- Start and end dates/times
- Priority: LOW, MEDIUM, HIGH
- Calendar ID (categorization)
- Linked work order (if applicable)
Calendar Integration: Events sync with work order schedules - changes to work order dates update calendar events automatically.

​
Client Management (Operators)

Maintenance clients (aircraft operators): 
Maintenance Client:
- Name
- Contact:
  - Email
  - Phone
  - Address
- Authorizing type:
  - PROPIETARIO (owner)
  - EXPLOTADOR (operator)
- Linked aircraft
Distinguishes between aircraft owners and operators for regulatory compliance.

​
Technician Management

Employee assignment to work orders:
  • Department assignment
  • Job title tracking
  • Task assignment
  • Man-hour tracking
  • Inspector certification

​
Work Order Workflow

1

Create Work Order

  • Select aircraft and client
  • Choose maintenance service (from Maintenance module)
  • System populates tasks from service definition
2

Preliminary Inspection

  • Conduct pre-maintenance inspection
  • Document aircraft condition
  • Identify additional work needed
3

Task Assignment

  • Assign tasks to technicians
  • Schedule task start dates
  • Generate material requisitions for required parts
4

Task Execution

  • Technicians perform work
  • Record man-hours
  • Update task status
  • Create non-routines if discrepancies found
5

Inspection

  • Inspector reviews completed work
  • Verifies task completion
  • Approves or rejects tasks
6

Documentation

  • Complete work order reports
  • Document all actions taken
  • Prepare release to service documentation
7

Close Work Order

  • Final review and approval
  • Update aircraft/component times
  • Generate invoice (if applicable)
  • Archive work order

​
Maintenance Due Tracking

While not explicitly shown in the code, the system supports tracking:
  • Hour-based maintenance: Due at specific flight hours
  • Cycle-based maintenance: Due at specific cycles
  • Calendar-based maintenance: Due on specific dates
  • Component life limits: Track time to component overhaul/replacement

​
User Workflows

​
For Planners

  1. Aircraft Management:
    • Register new aircraft
    • Update component configurations
    • Monitor flight hours and cycles
  2. Work Order Planning:
    • Create work orders from services
    • Schedule maintenance activities
    • Assign technicians and resources
    • Monitor work order progress
  3. Flight Logging:
    • Record daily flights
    • Verify time updates
    • Review flight history

​
For Technicians

  1. View Assigned Tasks:
    • See scheduled work
    • Review task requirements
    • Check parts availability
  2. Execute Work:
    • Update task status
    • Record man-hours
    • Create non-routine items
    • Request additional parts

​
For Inspectors

  1. Review Completed Work:
    • Inspect task completion
    • Verify compliance with procedures
    • Sign off on completed tasks

​
Reporting

Planning module provides:
  • Work order status reports
  • Aircraft utilization reports
  • Flight history by aircraft
  • Maintenance backlog
  • Technician productivity
  • Man-hour summaries
  • Component time reports

​
Integration with Other Modules

Maintenance Integration

Service definitions populate work order tasks automatically

Warehouse Integration

Task items generate dispatch requests for required parts

Purchasing Integration

Work orders trigger requisitions for parts not in stock

Administration

Completed work orders generate client invoices

Build docs developers (and LLMs) love

Get started for freeTalk to us