packages/crew-scheduler/
├── src/
│   ├── types.ts              # CrewMember, EventShow, ShiftAssignment, CrewRole, CrewLevel
│   ├── shift-roster.ts       # hasShiftConflict, findShiftConflict, validateRoster, getRequiredTravelBuffer
│   ├── skill-matcher.ts      # findQualifiedCrew, suggestOptimalRoster, extractRoleSlots
│   ├── payout-calculator.ts  # calculatePayout, calculateNightHours, calculateShowRosterPayout
│   ├── workforce-payroll.ts  # groupWorkforcePayroll, calculateCategoryTotals, WORKFORCE_CATEGORIES
│   └── index.ts              # SSoT Unified Barrel

import {
  findShiftConflict,
  findQualifiedCrew,
  calculatePayout,
  calculateNightHours,
  groupWorkforcePayroll,
  type CrewMember,
  type Venue,
  type ShiftAssignment,
} from '@kido/crew-scheduler';

// 1. Define Venues with Travel Transit Requirements
const venueInterconDanang: Venue = {
  name: 'InterContinental Danang Sun Peninsula',
  city: 'DA_NANG',
  address: 'Bãi Bắc, Sơn Trà, Đà Nẵng',
};

const venueNovotelDanang: Venue = {
  name: 'Novotel Danang Premier Han River',
  city: 'DA_NANG',
  address: '36 Bạch Đằng, Hải Châu, Đà Nẵng',
};

// 2. Define Crew Pool
const seniorAudioEngineer: CrewMember = {
  id: 'crew-audio-01',
  name: 'Trần Minh Tuấn',
  role: 'AUDIO_ENGINEER',
  level: 'SENIOR',
  city: 'DA_NANG',
  hourlyRateVnd: 150_000,
  isActive: true,
  rating: 4.9,
};

// 3. Existing Morning Assignment at Novotel (08:00 - 12:00)
const existingAssignments: ShiftAssignment[] = [
  {
    id: 'asgn-morning-01',
    crewMemberId: seniorAudioEngineer.id,
    showId: 'show-conference-morning',
    startTime: new Date('2026-11-20T08:00:00+07:00'),
    endTime: new Date('2026-11-20T12:00:00+07:00'),
    venue: venueNovotelDanang,
    status: 'CONFIRMED',
  },
];

// 4. Proposed Afternoon Assignment at InterContinental (Requires travel from city to Son Tra)
// Proposed Start: 12:30 (Only 30 min buffer; minimum required is 60 mins!)
const conflict = findShiftConflict(
  seniorAudioEngineer,
  existingAssignments,
  new Date('2026-11-20T12:30:00+07:00'),
  new Date('2026-11-20T17:00:00+07:00'),
  venueInterconDanang
);

if (conflict) {
  console.warn('Shift Conflict Detected:', conflict.reason);
  // Re-adjust schedule to 13:30 to allow 90 minutes transit
}

// 5. Calculate Night Shift Payout (Gala from 18:00 to 02:00 = 8 total hours)
// 18:00 - 22:00 = 4 daytime hours
// 22:00 - 02:00 = 4 night hours (subject to +30% night bonus)
const shiftStart = new Date('2026-11-20T18:00:00+07:00');
const shiftEnd = new Date('2026-11-21T02:00:00+07:00');

const nightHours = calculateNightHours(shiftStart, shiftEnd); // 4.0 hours
console.log(`Night hours worked (22:00 - 06:00): ${nightHours} hrs`);

const payout = calculatePayout({
  crewMember: seniorAudioEngineer,
  startTime: shiftStart,
  endTime: shiftEnd,
  kpiBonusVnd: 200_000, // Client praise bonus
});

console.log('Crew Payout Breakdown:', {
  crewName: payout.crewMemberName,
  totalHours: payout.totalHours,          // 8.0 hrs
  regularHours: payout.regularHours,      // 4.0 hrs
  nightHours: payout.nightHours,          // 4.0 hrs
  regularPay: `${payout.regularPayVnd.toLocaleString()}₫`,
  nightBonus: `${payout.nightBonusVnd.toLocaleString()}₫`, // 4h * 150k * 0.3 = 180,000₫
  kpiBonus: `${payout.kpiBonusVnd.toLocaleString()}₫`,     // 200,000₫
  totalGrossPay: `${payout.grossPayoutVnd.toLocaleString()}₫`, // 1,580,000₫
});

// 6. Aggregate Workforce Payroll into 5 Standard Categories
const groupedPayroll = groupWorkforcePayroll([
  {
    memberId: seniorAudioEngineer.id,
    name: seniorAudioEngineer.name,
    category: 'FREELANCE_SENIOR',
    grossPayVnd: payout.grossPayoutVnd,
    hoursWorked: payout.totalHours,
  },
  {
    memberId: 'crew-intern-02',
    name: 'Nguyễn Văn Phúc',
    category: 'PART_TIME_HOURLY',
    grossPayVnd: 450_000,
    hoursWorked: 6.0,
  },
]);

console.log('Workforce Category Rollup:', {
  grandTotal: `${groupedPayroll.grandTotalVnd.toLocaleString()}₫`,
  totalHeadcount: groupedPayroll.totalHeadcount,
  categories: Object.keys(groupedPayroll.byCategory),
});