keen-platform
Neel GorasiyaPRODUCT REQUIREMENTS DOCUMENT (PRD) Airline Core Platform (ERP-Agnostic, Commercial-Ready System) 1. Product Overview 1.1 Vision To build a modular, scalable airline platform that powers: Flight operations Passenger & cargo management Commercial offerings (flights, holidays, services) Distribution and booking channels The system will be designed as a commercially viable product, capable of being used internally and later offered to other airlines. 1.2 Core Objective Deliver a fully functional airline system (operations + booking + distribution) Keep ERP systems external and replaceable Enable multi-channel sales (B2C + B2B + API distribution) Ensure high performance, scalability, and compliance 1.3 Key Principles ERP-agnostic system design Modular architecture API-first platform Real-time operations capability Multi-language and multi-currency support Full auditability of all actions 2. Product Scope 2.1 Core Airline Operations 2.1.1 Flight Planning Objective Manage all structural and operational aspects of flights. Features Airport Profiles Codes, timezone, geo data Regional mapping Aircraft Profiles Type, configuration, capacity Linked to ERP assets (via integration layer) Leg & Sector Management Master definitions (routes) Operational sectors (live flight instances) Sub-sector support (bus/truck) Maintenance Management Maintenance scheduling Logs and tracking Spare parts linkage (via ERPNext) Ground Handling Vendor mapping Task tracking Flight-level assignments 2.1.2 Flight Crew Rostering Objective Efficiently manage crew lifecycle and assignments. Features Crew profiles Role definitions (pilot, cabin crew, etc.) Crew scheduling system Flight assignment workflows Availability tracking Tablet-ready crew access 2.1.3 CRS / PSS (Passenger & Cargo System) Objective Serve as the core system of the airline for inventory, booking, and pricing. Features A. Flight & Operational Data Flight instance creation Sector and sub-sector mapping Operational data control B. Inventory Management Passenger seat inventory Cargo weight & volume inventory Seat allocation logic Allotment management (block seats for agents) C. Pricing & Revenue Dynamic pricing engine (rule-based) Fees & taxes per passenger/cargo Revenue rule configuration Pricing tiers and bundles D. Booking System Booking lifecycle: Search → Select → Hold → Confirm → Cancel → Refund Booking state management Multi-service bookings (flight + hotel + services) E. Services & Policies Luggage rules Service catalog (add-ons) Policy enforcement F. In-Flight Systems Menu management Sales tracking Order management ERP inventory sync G. Reporting Systems Pilot reports Maintenance logs Ground handling reports 2.1.4 Departure Control System (DCS) Objective Manage all airport-side operations. Features Web check-in Desk check-in Passenger boarding Cargo boarding Baggage handling Sub-sector boarding (bus/truck) QR-based boarding validation Soft POS integration 2.2 Commercial & Revenue 2.2.1 Holidays & Ancillaries Features Holiday destination management Program/package creation Route-to-holiday mapping 2.2.2 Hotel System Features Hotel profiles Direct contract allotments External API integrations: Hyperguest Webbeds Bedhotels TBO 2.2.3 Additional Services Transfers Tours Visa services Luggage shipping 2.2.4 Customer & Agent Portals Features Customer profiles Agent profiles Role-based access Booking dashboards Agent wallet/credit system Booking and revenue tracking 2.3 Digital & Experience Layer 2.3.1 CMS Backend Features Page management Offer and promotion management Content localization (AR/EN) Currency handling 2.3.2 B2C Platform Features High-performance booking UI Shopping cart experience Offer-driven UI Responsive design 2.3.3 AI Accessibility Features AI-assisted booking conversational interface contextual recommendations 2.3.4 System Requirements High-speed performance CDN-based optimization High-quality PDF/document generation Data protection (EU & Jordan readiness) Backup and disaster recovery 2.4 Enterprise & Integrations 2.4.1 System Settings Region, city, country management Currency system Language system Global configuration 2.4.2 ERP Integration (ERP-Agnostic) Objective Enable integration with ERPNext while supporting future ERP systems. Features Standard integration interfaces: createInvoice() postPayment() createVendor() syncAsset() postJournal() ERPNext adapter implementation Retry and failure handling Logging and audit 2.4.3 Enterprise Modules (via ERP + Integration) Accounting automation Vendor management Asset management Maintenance integration HR system Payroll Attendance 2.4.4 Communication Systems Email notifications SMS notifications Web chat Call center integration Notification engine 2.4.5 AI Support System Chat-based AI support Voice-based AI support Data mapping with bookings and CRM 2.4.6 Marketing Tools Email campaigns Promo codes Campaign tracking 2.4.7 Distribution APIs Outgoing flight inventory APIs Agent APIs (wallet-based) Travel Fusion integration Partner onboarding 2.4.8 Payment Gateways Multi-gateway integration Regional routing Refund and reconciliation 2.5 System Users & Roles User Types Clients Agents Administrators Flight Operations Audit Team Booking Management Revenue Management Pilot Cabin Crew Ground Handling Cargo Management Features Role-based access control Custom role creation Permission engine Full audit logging of user actions 3. Non-Functional Requirements Performance Real-time booking and inventory updates High concurrency handling Low latency APIs Scalability Cloud-native deployment Horizontal scalability Multi-region readiness Security Role-based access encrypted data audit logging GDPR-style compliance readiness Reliability High availability architecture backup and recovery failure handling and retries 4. Data & Infrastructure Databases PostgreSQL → core transactional data Redis → caching and session handling ERPNext DB → enterprise data Infrastructure Cloud (AWS/GCP) containerized deployment CI/CD pipelines monitoring and logging 5. Success Criteria The system will be considered successful when: End-to-end booking and operations are functional ERP integration works without system dependency B2C and agent systems are operational DCS supports real-world flight execution System handles real-time pricing and inventory Platform is scalable and stable 6. Product Readiness Outcome At completion, the platform will provide: Full airline operational capability Commercial booking system Distribution APIs for partners ERP-integrated enterprise workflows AI-enabled customer support Scalable, product-ready architecture 7. Future Expansion (Optional Direction) Multi-airline support (multi-tenant) advanced AI pricing optimization loyalty programs deeper analytics and BI Final Note This PRD defines a complete airline platform built with a product mindset, ensuring: independence from ERP systems flexibility for future integrations scalability for commercialization readiness for real-world airline operations
Comments (0)
Sign in to leave a comment
Project Tasks37
Implement Theme & Structure
As a frontend developer, I want to implement the global color palette, design tokens, typography, spacing, and layout structure across all existing scaffold pages (home, login, signup, welcome, dashboard/overview, dashboard/ai-assistant, dashboard/settings) so that they match the keen-platform mock-design reference exactly. This includes applying CSS variables (--primary: #3498DB, --secondary: #E74C3C, --accent: #F39C12, --bg: #F5F9FC, --surface: rgba(255,255,255,0.98), --text: #2C3E50, --text_muted: #BDC3C7, --border: rgba(52,152,219,0.15)), Inter font family, and removing any pages not required by the user flows. This task must be completed before any other page implementation tasks.
Build Login Page
As a user (Admin, Agent, Ground Handler, Revenue Manager), I want to sign in via the Login page so that I can access my role-specific portal. Implement the Login page (v1) based on the existing JSX design. Includes email/password fields, role-aware redirect logic, and branding. Entry point for all non-passenger user flows. Reference: Login (v1) design page.
Build Home Page
As a passenger, I want to browse flights from the Home page so that I can start my booking journey. Implement the Home page (v2) based on the existing JSX design. Includes the interactive 3D globe with animated flight paths, NavBar with sticky navigation, Hero section with CTA, QuickStats bar, and Footer. The globe transitions from day to night based on user's local timezone. Entry point for the Passenger flow leading to Search Results. Reference: Home (v2) design page.
Build DCS Dashboard Page
As a Ground Handler, I want to view all flights for the day from the DCS Dashboard so that I can manage airport-side operations efficiently. Implement the DCS Dashboard page (v1) based on the existing JSX design. Includes flight list with status badges, departure/arrival times, gate assignments, and quick-access links to Check-In, Boarding, Baggage, and Cargo Boarding. Reference: DCS Dashboard (v1) design page.
Build Revenue Dashboard Page
As a Revenue Manager, I want to view revenue performance from the Revenue Dashboard so that I can monitor KPIs, flight revenue trends, and identify optimization opportunities. Implement the Revenue Dashboard page (v1) based on the existing JSX design. Includes revenue KPI cards, trend charts, flight performance table, and quick-access links to Pricing Engine and Reports. Reference: Revenue Dashboard (v1) design page.
Build Agent Portal Page
As an Agent, I want to view my portal dashboard after login so that I can manage bookings, customer profiles, and wallet credits. Implement the Agent Portal page (v1) based on the existing JSX design. Includes booking summary cards, quick-access links to Flight Search, Customer Profiles, and Wallet, and revenue tracking widgets. Reference: Agent Portal (v1) design page.
Build Search Results Page
As a Passenger, I want to view and select a flight from the Search Results page so that I can proceed to booking my chosen itinerary. Implement the Search Results page (v1) based on the existing JSX design. Includes flight cards with pricing, filters (price, stops, duration), sort options, and CTA to proceed to Booking. Entry from Home page search. Reference: Search Results (v1) design page.
Build Dashboard Page
As an Airline Admin, I want to view an overview dashboard after login so that I can monitor platform-wide operations. Implement the Dashboard page (v1) based on the existing JSX design. Includes KPI cards, flight status summary, quick navigation links to Flight Planning, Crew Rostering, System Settings, and User Management. Reference: Dashboard (v1) design page.
Build Booking Page (Passenger)
As a Passenger, I want to add services to my booking from the Booking page so that I can customize my trip with luggage, meals, and seat upgrades before checkout. Implement the Booking page (v1) based on the existing JSX design. Includes passenger details form, seat map, add-on service selector (luggage, meals, extras), and order summary. Navigates to Checkout. Reference: Booking (v1) design page.
Build Flight Planning Page
As an Airline Admin, I want to manage flight schedules from the Flight Planning page so that I can plan and update routes, sectors, and aircraft assignments. Implement the Flight Planning page (v1) based on the existing JSX design. Includes flight schedule table, route management, airport profiles, and aircraft profile linking. Navigates to Crew Rostering. Reference: Flight Planning (v1) design page.
Build Wallet Page
As an Agent, I want to track my wallet credits from the Wallet page so that I can monitor available credits, transaction history, and top-up options. Implement the Wallet page (v1) based on the existing JSX design. Includes credit balance display, transaction history table, top-up CTA, and commission tracking. Reached from Agent Portal. Reference: Wallet (v1) design page.
Build Pricing Engine Page
As a Revenue Manager, I want to configure pricing rules and bundles from the Pricing Engine page so that I can implement dynamic pricing strategies across flights. Implement the Pricing Engine page (v1) based on the existing JSX design. Includes rule builder UI (fare tiers, conditions, modifiers), bundle configurator, fees & taxes setup, and preview panel. Navigates to Set Bundles sub-section. Reference: Pricing Engine (v1) design page.
Build Check-In Page
As a Ground Handler, I want to process passenger check-ins from the Check-In page so that I can verify passenger details, assign seats, and issue boarding passes. Implement the Check-In page (v1) based on the existing JSX design. Includes passenger lookup, seat assignment, baggage drop inputs, and boarding pass generation. Navigates to Boarding. Reference: Check-In (v1) design page.
Build Flight Search Page
As an Agent, I want to search for flights from the Flight Search page so that I can find and select flights to book on behalf of customers. Implement the Flight Search page (v1) based on the existing JSX design. Includes origin/destination pickers, date selectors, passenger count, and cabin class. Navigates to Booking. Reference: Flight Search (v1) design page.
Build Reports Page
As a Revenue Manager, I want to analyze revenue data from the Reports page so that I can generate and export reports on bookings, revenue, and operational performance. Implement the Reports page (v1) based on the existing JSX design. Includes report type selector, date range filter, data table with export (CSV/PDF), and chart visualizations. Navigates to Promotions. Reference: Reports (v1) design page.
Build System Settings Page
As an Airline Admin, I want to configure platform settings from the System Settings page so that I can manage regions, currencies, languages, and global configurations. Implement the System Settings page (v1) based on the existing JSX design. Includes tabbed sections for region/city/country management, currency system, language system, and global config. Navigates to User Management. Reference: System Settings (v1) design page.
Build Cargo Boarding Page
As a Ground Handler, I want to load and track cargo from the Cargo Boarding page so that I can ensure correct cargo allocation and loading for each flight. Implement the Cargo Boarding page (v1) based on the existing JSX design. Includes cargo manifest list, weight/volume allocation controls, cargo status badges, and loading confirmation. Reached from DCS Dashboard. Reference: Cargo Boarding (v1) design page.
Build Booking Page (Agent)
As an Agent, I want to book a flight for a customer from the Booking page so that I can complete the booking lifecycle on their behalf. Implement the Booking page (v1) based on the existing JSX design. Includes passenger details form, seat selection, add-on services (luggage, meals), pricing summary, and confirm booking CTA. Navigates to Customer Profiles. Reference: Booking (v1) design page.
Implement System Settings API
As a backend developer, I want to implement system configuration APIs so that admins can manage regions, cities, countries, currencies, and languages globally. Endpoints: GET/POST/PUT /settings/regions, /settings/currencies, /settings/languages, /settings/global. Includes validation and cache invalidation.
Build Promotions Page
As a Revenue Manager, I want to manage marketing campaigns from the Promotions page so that I can create, activate, and track promo codes and campaigns. Implement the Promotions page (v1) based on the existing JSX design. Includes campaign list, promo code builder, campaign performance metrics, and activate/deactivate controls. Reached from Reports. Reference: Promotions (v1) design page.
Build Boarding Page
As a Ground Handler, I want to validate passenger boarding from the Boarding page so that I can ensure only authorized passengers board the aircraft. Implement the Boarding page (v1) based on the existing JSX design. Includes QR-code boarding validation, passenger manifest list, boarding status tracker, and gate closure controls. Navigates to Baggage. Reference: Boarding (v1) design page.
Implement Booking & Inventory API
As a backend developer, I want to implement booking lifecycle APIs so that passengers and agents can search, hold, confirm, cancel, and refund flight bookings. Endpoints: POST /bookings, PUT /bookings/{id}/confirm, PUT /bookings/{id}/cancel, POST /bookings/{id}/refund, GET /inventory/{flight_id}. Includes seat inventory management and concurrency control.
Build Checkout Page
As a Passenger, I want to confirm and pay for my booking from the Checkout page so that I can complete my purchase securely. Implement the Checkout page (v1) based on the existing JSX design. Includes order summary, passenger details review, payment gateway selector, promo code input, and booking confirmation CTA. Navigates to My Bookings. Reference: Checkout (v1) design page.
Implement Flight Planning API
As a backend developer, I want to implement REST APIs for flight planning so that the frontend can manage flight schedules, airport profiles, aircraft profiles, sectors, and route data. Endpoints: GET/POST/PUT/DELETE /flights, /airports, /aircraft, /sectors. Includes pagination, filtering, and validation.
Build Crew Rostering Page
As an Airline Admin, I want to assign crew to flights from the Crew Rostering page so that I can manage crew schedules and availability. Implement the Crew Rostering page (v1) based on the existing JSX design. Includes crew profiles list, flight assignment workflows, availability calendar, and role definitions. Reached from Flight Planning. Reference: Crew Rostering (v1) design page.
Build User Management Page
As an Airline Admin, I want to manage user roles from the User Management page so that I can assign, create, and update roles and permissions for all platform users. Implement the User Management page (v1) based on the existing JSX design. Includes user list, role assignment, permission engine controls, and audit log access. Reached from System Settings. Reference: User Management (v1) design page.
Implement Pricing Engine API
As a backend developer, I want to implement dynamic pricing APIs so that revenue managers can configure rules and the system applies them in real-time during booking. Endpoints: GET/POST/PUT /pricing-rules, /bundles, /fees-taxes. Includes rule evaluation engine, tier management, and pricing preview.
Implement Crew Rostering API
As a backend developer, I want to implement REST APIs for crew rostering so that crew profiles, availability, and flight assignments can be managed. Endpoints: GET/POST/PUT /crew, /crew-assignments, /crew-availability. Includes conflict detection and scheduling validation.
Implement Revenue & Reports API
As a backend developer, I want to implement revenue reporting APIs so that revenue managers can query performance data, generate reports, and manage promotions. Endpoints: GET /revenue/summary, GET /reports, POST /promotions, PUT /promotions/{id}/activate. Includes CSV/PDF export capability.
Build My Bookings Page
As a Passenger, I want to manage my bookings from the My Bookings page so that I can view booking details, make changes, and initiate cancellations or refunds. Implement the My Bookings page (v1) based on the existing JSX design. Includes booking list with status filters, booking detail view, modify/cancel/refund actions, and e-ticket download. Reached from Checkout and supports Cancel/Refund flow. Reference: My Bookings (v1) design page.
Implement Payment Gateway Integration
As a backend developer, I want to integrate multi-gateway payment processing so that passengers can pay for bookings using regional payment providers with refund and reconciliation support. Includes gateway routing logic, webhook handlers for payment status, and reconciliation reports.
Implement RBAC & User Management API
As a backend developer, I want to implement role-based access control APIs so that admins can manage users, assign roles, configure permissions, and audit actions. Endpoints: GET/POST/PUT/DELETE /users, /roles, /permissions, GET /audit-logs. Includes JWT role claims and permission middleware.
Build Customer Profiles Page
As an Agent, I want to manage customer profiles from the Customer Profiles page so that I can view, update, and track bookings tied to each customer. Implement the Customer Profiles page (v1) based on the existing JSX design. Includes customer list, profile detail view, booking history, and contact info. Reached from Booking. Reference: Customer Profiles (v1) design page.
Build Baggage Page
As a Ground Handler, I want to manage baggage operations from the Baggage page so that I can track, claim, escalate, and resolve baggage items per flight. Implement the Baggage page (v1) based on the existing JSX design. Includes baggage list with status filters, tracking timeline, baggage detail panel, action buttons (Mark Claimed, Escalate, Print Label), and alerts. Reached from Boarding. Reference: Baggage (v1) design page.
Implement AI Assistant Integration
As an AI Engineer, I want to integrate LangChain and LiteLLM routing into the platform's AI assistant so that users get contextual, role-aware responses using GPT for general queries and Claude for technical/academic queries. Includes LLM routing logic, session context management, and booking data mapping for contextual recommendations.
Implement Agent & Wallet API
As a backend developer, I want to implement agent portal and wallet APIs so that agents can manage credits, commissions, bookings, and customer profiles. Endpoints: GET/PUT /agent/wallet, POST /agent/wallet/topup, GET/POST /agent/customers, GET /agent/bookings. Includes credit deduction on booking and transaction history.
Implement DCS & Baggage API
As a backend developer, I want to implement DCS APIs for check-in, boarding, baggage, and cargo so that ground handlers can process airport operations in real-time. Endpoints: POST /checkin, POST /boarding/validate, GET/PUT /baggage, GET/POST /cargo-manifest. Includes QR code generation and validation.
No comments yet. Be the first!