HR Employee Extensions

Add flight crew capabilities to employee records:

• Flight Crew Type: Assign crew roles (Pilot, First Officer, Cabin Crew, etc.)
• Base Airport: Set crew member's home airport
• Crew Tab: Dedicated section in employee form for aviation data
• Automatic Sync: Changes to employee sync to flight crew records

Enhanced Crew Management

• Employee-Partner Linking: Automatic two-way sync between employees and contacts
• Validation: Ensures either employee or partner is specified for each crew member
• Crew Types: Define custom crew types with codes and HR department links
• Department Integration: Connect crew types to HR departments for reporting

Flight Integration

• Employee Selection: Choose crew from HR employee list when assigning flights
• Contact Fallback: Use contacts for contractors or external crew
• Smart Onchange: Automatically populates employee when selecting partner (and vice versa)
• Priority Logic: Prefers employees with user accounts over work contacts

Requirements

• Odoo 18.0
• flight - Base flight management module
• hr - Odoo HR module

Install

1. Ensure flight and hr modules are installed
2. Install flight_crew from Apps menu
3. Access via Flights > Configuration > Crew and HR > Employees

Setting Up Crew Types

1. Navigate to Flights > Configuration > Crew Types
2. Create crew types:
   • Name: e.g., "Captain", "First Officer", "Flight Attendant"
   • Code: Short code (e.g., "CPT", "FO", "FA")
   • HR Department: Link to relevant department
3. Crew types are used for both employees and standalone crew members

Configuring Employee Crew Data

1. Go to HR > Employees
2. Open an employee record
3. Navigate to Crew tab (or Private Information section)
4. Set:
   • Flight Crew Type: Select from configured types
   • Base Airport: Choose crew member's home base

Adding Crew to Flights via Employees

1. Open a flight record
2. Go to Crew tab
3. Click Add a line
4. Select Employee: System auto-fills partner information
5. Set crew type and role
6. Save

Adding Crew to Flights via Contacts

1. Open a flight record
2. Go to Crew tab
3. Click Add a line
4. Select Partner: System searches for matching employee
5. If employee found, it auto-fills; otherwise, use contact only
6. Set crew type and role
7. Save

Managing Crew Information

From Employee Form:

• Update Flight Crew Type
• Change Base Airport
• View all flights for this employee (if integrated with flight views)

From Flight Crew Form:

• Choose Employee or Partner
• System validates at least one is filled
• Auto-sync keeps data consistent

Models

• hr.employee - Extended with flight_crew_type_id and base_id fields
• flight.crew.type - New model for crew type definitions
• flight.crew - Extended with employee_id field and smart sync logic

Synchronization Logic

Employee → Partner:

When employee selected, finds related partner via:

1. User's partner (if employee has user account)
2. Work contact (if configured)

Partner → Employee:

When partner selected, searches for employee via:

1. User's partner match (priority)
2. Work contact match (fallback)

Uses order="user_id DESC" to prefer employees with user accounts

Validation

• Constraint ensures either employee_id OR partner_id is set (not both empty)
• Prevents incomplete crew records
• Allows flexibility for contractors without employee records

Integration Points

• HR Department: Crew types can link to departments for organizational reporting
• Flight Module: Extends base flight.crew model with employee relationship
• User Accounts: Leverages existing user-employee-partner relationships

Aviation Operations with HR

Perfect for organizations that want to:

• Manage crew as employees with HR records
• Track crew qualifications, certifications, training through HR
• Link crew scheduling to HR time off and availability
• Generate crew reports using HR analytics

Mixed Crew Models

Supports operations with:

• Full-time employee crew members
• Contract pilots without employee records
• Guest crew from partner airlines
• Freelance flight attendants

Department Reporting

• Assign pilots to Flight Operations department
• Assign cabin crew to Cabin Services department
• Generate HR reports by crew type
• Analyze crew costs through HR payroll integration

Authors

• Apexive Solutions LLC

Contributors

• SmartOps Aviation Team

License

OPL-1 (Odoo Proprietary License v1.0)

Copyright 2025 Apexive Solutions LLC