feat: V/R 유지보수 시스템 전환 및 대시보드 테이블 형태 완성

- V/R 시스템 완전 전환: WARRANTY/CONTRACT/INSPECTION → V(방문)/R(원격)
- 유지보수 대시보드 카드 → StandardDataTable 테이블 형태 전환
- "조회중..." 문제 해결: 백엔드 직접 필드 사용 (equipment_model, company_name)
- MaintenanceDto 신규 필드 추가: company_id, company_name, equipment_serial, equipment_model
- preloadEquipmentData 비활성화로 불필요한 equipment-history API 호출 제거
- CO-STAR 프레임워크 적용 및 CLAUDE.md v3.0 업데이트
- Flutter Analyze ERROR: 0 유지, 100% shadcn_ui 컴플라이언스

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

lib/screens/maintenance/controllers/maintenance_controller.dart

@@ -1,5 +1,7 @@
 import 'package:flutter/material.dart';
 import 'package:superport/data/models/maintenance_dto.dart';
+import 'package:superport/data/models/equipment_history_dto.dart';
+import 'package:superport/data/repositories/equipment_history_repository.dart';
 import 'package:superport/domain/usecases/maintenance_usecase.dart';
 
 /// 정비 우선순위
@@ -36,12 +38,16 @@ class MaintenanceSchedule {
 /// 유지보수 컨트롤러 (백엔드 API 완전 호환)
 class MaintenanceController extends ChangeNotifier {
   final MaintenanceUseCase _maintenanceUseCase;
+  final EquipmentHistoryRepository _equipmentHistoryRepository;
   
   // 상태 관리
   List<MaintenanceDto> _maintenances = [];
   bool _isLoading = false;
   String? _error;
   
+  // EquipmentHistory 캐시 (성능 최적화)
+  final Map<int, EquipmentHistoryDto> _equipmentHistoryCache = {};
+  
   // 페이지네이션
   int _currentPage = 1;
   int _totalCount = 0;
@@ -69,8 +75,11 @@ class MaintenanceController extends ChangeNotifier {
   // Form 상태
   bool _isFormLoading = false;
   
-  MaintenanceController({required MaintenanceUseCase maintenanceUseCase})
-      : _maintenanceUseCase = maintenanceUseCase;
+  MaintenanceController({
+    required MaintenanceUseCase maintenanceUseCase,
+    required EquipmentHistoryRepository equipmentHistoryRepository,
+  }) : _maintenanceUseCase = maintenanceUseCase,
+       _equipmentHistoryRepository = equipmentHistoryRepository;
 
   // Getters
   List<MaintenanceDto> get maintenances => _maintenances;
@@ -124,6 +133,12 @@ class MaintenanceController extends ChangeNotifier {
       _totalCount = response.totalCount;
       _totalPages = response.totalPages;
       
+      // TODO: V/R 시스템에서는 maintenance API에서 직접 company_name 제공
+      // 기존 equipment-history 개별 호출 비활성화
+      // if (_maintenances.isNotEmpty) {
+      //   preloadEquipmentData();
+      // }
+      
     } catch (e) {
       _error = e.toString();
     } finally {
@@ -452,12 +467,10 @@ class MaintenanceController extends ChangeNotifier {
   
   String _getMaintenanceTypeDisplayName(String maintenanceType) {
     switch (maintenanceType) {
-      case 'WARRANTY':
-        return '무상보증';
-      case 'CONTRACT':
-        return '유상계약';
-      case 'INSPECTION':
-        return '점검';
+      case 'V':
+        return '방문';
+      case 'R':
+        return '원격';
       default:
         return maintenanceType;
     }
@@ -572,9 +585,93 @@ class MaintenanceController extends ChangeNotifier {
   // 통계 정보
   int get activeMaintenanceCount => _maintenances.where((m) => m.isActive).length;
   int get expiredMaintenanceCount => _maintenances.where((m) => m.isExpired).length;
-  int get warrantyMaintenanceCount => _maintenances.where((m) => m.maintenanceType == 'WARRANTY').length;
-  int get contractMaintenanceCount => _maintenances.where((m) => m.maintenanceType == 'CONTRACT').length;
-  int get inspectionMaintenanceCount => _maintenances.where((m) => m.maintenanceType == 'INSPECTION').length;
+  int get visitMaintenanceCount => _maintenances.where((m) => m.maintenanceType == 'V').length;
+  int get remoteMaintenanceCount => _maintenances.where((m) => m.maintenanceType == 'R').length;
+
+  // Equipment 정보 조회 (캐시 지원)
+  Future<EquipmentHistoryDto?> getEquipmentHistoryForMaintenance(MaintenanceDto maintenance) async {
+    if (maintenance.equipmentHistoryId == null) return null;
+    
+    final equipmentHistoryId = maintenance.equipmentHistoryId!;
+    
+    // 캐시에서 먼저 확인
+    if (_equipmentHistoryCache.containsKey(equipmentHistoryId)) {
+      return _equipmentHistoryCache[equipmentHistoryId];
+    }
+    
+    try {
+      // API에서 조회
+      final equipmentHistory = await _equipmentHistoryRepository.getEquipmentHistoryById(equipmentHistoryId);
+      
+      // 캐시에 저장
+      _equipmentHistoryCache[equipmentHistoryId] = equipmentHistory;
+      
+      return equipmentHistory;
+    } catch (e) {
+      debugPrint('Equipment History 조회 실패: $e');
+      return null;
+    }
+  }
+  
+  // 장비명 조회 (UI용 헬퍼)
+  String getEquipmentName(MaintenanceDto maintenance) {
+    // 백엔드에서 직접 제공하는 equipment_model 사용
+    if (maintenance.equipmentModel != null && maintenance.equipmentModel!.isNotEmpty) {
+      return maintenance.equipmentModel!;
+    }
+    return 'Equipment #${maintenance.equipmentHistoryId ?? 'N/A'}';
+  }
+  
+  // 시리얼번호 조회 (UI용 헬퍼)  
+  String getEquipmentSerial(MaintenanceDto maintenance) {
+    // 백엔드에서 직접 제공하는 equipment_serial 사용
+    if (maintenance.equipmentSerial != null && maintenance.equipmentSerial!.isNotEmpty) {
+      return maintenance.equipmentSerial!;
+    }
+    return '-';
+  }
+  
+  // 고객사명 조회 (UI용 헬퍼)
+  String getCompanyName(MaintenanceDto maintenance) {
+    // 백엔드에서 직접 제공하는 company_name 사용
+    debugPrint('getCompanyName - ID: ${maintenance.id}, companyName: "${maintenance.companyName}", companyId: ${maintenance.companyId}');
+    
+    if (maintenance.companyName != null && maintenance.companyName!.isNotEmpty) {
+      return maintenance.companyName!;
+    }
+    return '-';
+  }
+  
+  // 특정 maintenance의 equipment 정보가 로드되었는지 확인
+  bool isEquipmentDataLoaded(MaintenanceDto maintenance) {
+    return maintenance.equipmentHistoryId != null && 
+           _equipmentHistoryCache.containsKey(maintenance.equipmentHistoryId!);
+  }
+  
+  // 모든 maintenance의 equipment 정보 미리 로드
+  Future<void> preloadEquipmentData() async {
+    final maintenancesWithHistoryId = _maintenances
+        .where((m) => m.equipmentHistoryId != null && !_equipmentHistoryCache.containsKey(m.equipmentHistoryId!))
+        .toList();
+    
+    if (maintenancesWithHistoryId.isEmpty) return;
+    
+    // 동시에 최대 5개씩만 로드 (API 부하 방지)
+    const batchSize = 5;
+    for (int i = 0; i < maintenancesWithHistoryId.length; i += batchSize) {
+      final batch = maintenancesWithHistoryId
+          .skip(i)
+          .take(batchSize)
+          .toList();
+      
+      await Future.wait(
+        batch.map((maintenance) => getEquipmentHistoryForMaintenance(maintenance)),
+      );
+      
+      // UI 업데이트
+      notifyListeners();
+    }
+  }
 
   // 오류 관리
   void clearError() {
@@ -601,6 +698,7 @@ class MaintenanceController extends ChangeNotifier {
     _error = null;
     _isLoading = false;
     _isFormLoading = false;
+    _equipmentHistoryCache.clear();  // 캐시도 초기화
     notifyListeners();
   }