klg-asutk-app/docs/AI_AGENT_FEATURES.md

Функции ИИ Агента

Обзор

ИИ Агент системы контроля лётной годности теперь поддерживает:

1. Управление доступом операторов через настройки
2. Загрузку и обработку документов (PDF, JPEG, PNG, XLS, XLSX, CSV, TXT, DOC, DOCX)
3. Автоматическое внесение данных из документов в карточки ВС, аудитов и чек-листов
4. Форматы чек-листов и отчетов об аудите согласно требованиям АРМАК, ИКАО, FAA, EASA

Управление доступом к ИИ агенту

Настройка доступа

1. Откройте Настройки (кнопка в правом верхнем углу)
2. Перейдите на вкладку "ИИ Агент"
3. Выберите операторов, которым нужно предоставить доступ
4. Включите опции:
   • Полный доступ ИИ агенту - разрешает автоматическое внесение данных
   • Автоматическая обработка документов - включает автоматическое извлечение данных из файлов

Функции доступа

• Просмотр: Оператор может использовать ИИ агента для поиска информации
• Загрузка документов: Оператор может загружать файлы для анализа
• Автоматическое внесение данных: ИИ агент может автоматически вносить данные в карточки (требует подтверждения)

Загрузка документов

Поддерживаемые форматы

• PDF - документы, сертификаты, отчеты
• Изображения - JPEG, JPG, PNG (требуется OCR для извлечения текста)
• Таблицы - XLS, XLSX, CSV
• Текстовые - TXT, DOC, DOCX

Как использовать

1. Откройте ИИ Агент (кнопка на дашборде)
2. Нажмите кнопку 📎 для выбора файлов
3. Выберите один или несколько файлов
4. Введите команду, например:
   • "Проанализируй эти документы и внеси данные о воздушных судах"
   • "Извлеки информацию об аудитах из файлов"
   • "Создай чек-лист на основе данных из CSV"
5. Нажмите Отправить

Обработка документов

ИИ агент автоматически:

• Извлекает текст из документов
• Анализирует структурированные данные (CSV, Excel)
• Определяет тип информации (ВС, аудиты, чек-листы)
• Предлагает внести данные в соответствующие карточки

Форматы чек-листов

Соответствие стандартам

Система поддерживает форматы чек-листов согласно требованиям:

• ICAO Annex 6 - Международная организация гражданской авиации
• EASA Part-M - Европейское агентство по безопасности авиации
• FAA Part 91/135 - Федеральное управление гражданской авиации США
• АРМАК - Агентство по регулированию гражданской авиации РФ

Структура чек-листа

{
  checklistNumber: string;
  aircraftRegistration: string;
  aircraftType: string;
  operator: string;
  date: string;
  inspector: string;
  checklistType: 'pre-flight' | 'post-flight' | 'maintenance' | 'annual' | 'special';
  standards: {
    icao?: boolean;
    easa?: boolean;
    faa?: boolean;
    armak?: boolean;
  };
  items: ChecklistItem[];
  summary: {
    total: number;
    compliant: number;
    nonCompliant: number;
    notApplicable: number;
    pending: number;
  };
  conclusion: 'approved' | 'conditional' | 'rejected';
  signatures: {
    inspector: { name, license, date, signature };
    operator?: { name, position, date, signature };
  };
}

Категории чек-листов

ICAO Annex 6

• Aircraft Airworthiness
• Flight Operations
• Maintenance
• Cabin Safety

EASA Part-M

• Все категории ICAO +
• Continuing Airworthiness
• Airworthiness Review Certificate (ARC)
• Continuing Airworthiness Management Exposition (CAME)

FAA Part 91/135

• Все категории ICAO +
• FAA Registration
• FAA Operating Certificate
• FAA Maintenance Program

АРМАК

• Все категории ICAO +
• Сертификат лётной годности
• Разрешение на эксплуатацию
• Программа технического обслуживания (ПТО)
• Соответствие ФАП

Форматы отчетов об аудите

Соответствие стандартам

Отчеты об аудите соответствуют требованиям:

• ICAO - стандарты международной гражданской авиации
• EASA - европейские стандарты безопасности
• FAA - стандарты США
• АРМАК - российские стандарты

Структура отчета

{
  reportNumber: string;
  reportType: 'scheduled' | 'unscheduled' | 'follow-up' | 'special';
  auditDate: string;
  auditLocation: string;
  organization: {
    name: string;
    type: string;
    certificate?: string;
    address: string;
  };
  auditTeam: Array<{
    name: string;
    role: 'lead-auditor' | 'auditor' | 'observer';
    license?: string;
    organization: string;
  }>;
  auditScope: {
    description: string;
    standards: {
      icao?: boolean;
      easa?: boolean;
      faa?: boolean;
      armak?: boolean;
    };
    areas: string[];
  };
  findings: AuditFinding[];
  summary: {
    totalFindings: number;
    critical: number;
    major: number;
    minor: number;
    observations: number;
    complianceRate: number;
  };
  conclusion: {
    overall: 'compliant' | 'non-compliant' | 'conditional';
    details: string;
    recommendations: string[];
  };
  actionPlan?: Array<{
    findingId: string;
    action: string;
    responsible: string;
    deadline: string;
    status: 'pending' | 'in-progress' | 'completed';
  }>;
  signatures: {
    leadAuditor: { name, license, date, signature };
    organizationRepresentative: { name, position, date, signature };
  };
}

Категории нарушений

ICAO

• Airworthiness
• Operations
• Maintenance
• Personnel
• Documentation
• Safety Management (SMS)

EASA

• Все категории ICAO +
• Continuing Airworthiness
• Airworthiness Review
• CAME Compliance

FAA

• Все категории ICAO +
• FAA Certification
• FAA Operations
• FAA Maintenance

АРМАК

• Все категории ICAO +
• АРМАК Сертификация
• Соответствие ФАП
• ПТО (Программа технического обслуживания)

Примеры использования

Пример 1: Загрузка CSV с данными о ВС

1. Загрузите CSV файл с колонками: registrationNumber, aircraftType, operator
2. Отправьте команду: "Проанализируй этот CSV и внеси данные о воздушных судах в базу"
3. ИИ агент извлечет данные и предложит создать карточки ВС

Пример 2: Загрузка отчета об аудите

1. Загрузите PDF или Word документ с отчетом об аудите
2. Отправьте команду: "Извлеки информацию об аудите и создай отчет в формате АРМАК"
3. ИИ агент создаст структурированный отчет согласно требованиям АРМАК

Пример 3: Создание чек-листа

1. Загрузите документ с требованиями проверки
2. Отправьте команду: "Создай чек-лист в формате ICAO Annex 6 на основе этого документа"
3. ИИ агент создаст структурированный чек-лист с соответствующими категориями

Безопасность

• Все действия ИИ агента логируются в системе аудита
• Автоматическое внесение данных требует подтверждения пользователя
• Доступ к ИИ агенту контролируется через настройки
• Все загруженные файлы проверяются на безопасность

Технические детали

API Endpoints

• POST /api/ai-chat - Основной endpoint для общения с ИИ агентом
  • Поддерживает FormData для загрузки файлов
  • Обрабатывает JSON запросы без файлов

Библиотеки

• csv-parse - для парсинга CSV файлов
• ai - для работы с Anthropic Claude API
• В будущем: pdf-parse, xlsx, tesseract.js для полной поддержки всех форматов

Файлы

• lib/ai/document-parser.ts - парсер документов
• lib/compliance/checklist-formats.ts - форматы чек-листов
• lib/compliance/audit-report-formats.ts - форматы отчетов об аудите