feat: Flutter analyze 오류 대폭 개선 및 재고 이력 화면 UI 통일 완료
Some checks failed
Flutter Test & Quality Check / Test on macos-latest (push) Has been cancelled
Flutter Test & Quality Check / Test on ubuntu-latest (push) Has been cancelled
Flutter Test & Quality Check / Build APK (push) Has been cancelled

## 주요 개선사항

### 🔧 Flutter Analyze 오류 대폭 개선
- 이전: 47개 이슈 (ERROR 14개 포함)
- 현재: 22개 이슈 (ERROR 0개)
- 개선율: 53% 감소, 모든 ERROR 해결

### 🎨 재고 이력 화면 UI 통일 완료
- BaseListScreen 패턴 완전 적용
- 헤더 고정 + 바디 스크롤 구조 구현
- shadcn_ui 컴포넌트 100% 사용
- 장비 관리 화면과 동일한 표준 패턴

###  코드 품질 개선
- unused imports 제거 (5개 파일)
- unnecessary cast 제거
- unused fields 제거
- injection container 오류 해결

### 📋 문서화 완료
- CLAUDE.md에 UI 통일성 리팩토링 계획 상세 추가
- 전체 10개 화면의 단계별 계획 문서화

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
JiWoong Sul
2025-08-31 17:37:49 +09:00
parent df7dd8dacb
commit 650cd4be55
15 changed files with 2194 additions and 1246 deletions

176
CLAUDE.md
View File

@@ -413,6 +413,182 @@ ShadSelect<String?>(
- **기술 스택**: Provider, GetIt DI, shadcn_ui
- **영향**: Flutter analyze ERROR 0개 유지
## 🎨 UI 통일성 대규모 리팩토링 계획 (2025-08-31)
> **목표**: 장비 관리 화면 기준으로 모든 화면의 UI 패턴 통일
> **핵심**: 헤더 고정 + 바디 스크롤 구조를 모든 리스트 화면에 적용
> **범위**: 총 10개 화면 (사용자 관련 2개 + 마스터 데이터 4개 + 운영 관리 4개)
### 🎯 표준 UI 패턴 (장비 관리 기준)
```yaml
표준_패턴_정의:
레이아웃: "BaseListScreen 사용"
헤더: "고정 헤더 (스크롤 시 유지)"
테이블: "커스텀 Row/Column 기반 (shadcn_ui 완전 준수)"
스크롤: "헤더 고정 + 바디만 스크롤"
액션바: "StandardActionBar 사용"
페이지네이션: "Pagination 위젯 사용"
검색바: "UnifiedSearchBar 또는 커스텀 shadcn_ui"
버튼: "ShadButton 계열만 사용"
배지: "ShadBadge 계열만 사용"
금지_패턴:
- "Flutter DataTable 사용 절대 금지"
- "StandardDataTable 사용 금지 (Flutter 기반)"
- "Material 위젯 (ElevatedButton, Card 등) 사용 금지"
- "커스텀 UI 컴포넌트 새로 생성 금지"
```
### 📋 화면별 리팩토링 계획
#### **Phase 1: 사용자 관련 화면 (2개)**
```yaml
1.1_사용자_목록:
파일: "lib/screens/user/user_list.dart"
현재_문제: "StandardDataTable 사용 (Flutter 기반)"
변경_작업:
- "StandardDataTable → 커스텀 Row/Column 테이블"
- "헤더 고정 구조 적용"
- "_buildTableHeader(), _buildTableRow() 메서드 추가"
- "컬럼: 번호(50px), 이름(flex:2), 이메일(flex:3), 회사(flex:2), 권한(80px), 상태(80px), 작업(120px)"
1.2_관리자_목록:
파일: "lib/screens/administrator/administrator_list.dart"
현재_문제: "Flutter DataTable 직접 사용, BaseListScreen 미사용"
변경_작업:
- "Scaffold + Column 구조 → BaseListScreen 적용"
- "DataTable → 커스텀 Row/Column 테이블"
- "검색바를 UnifiedSearchBar로 변경"
- "통계 카드를 headerSection으로 이동"
```
#### **Phase 2: 마스터 데이터 화면 (4개)**
```yaml
2.1_벤더_목록:
파일: "lib/screens/vendor/vendor_list_screen.dart"
현재_문제: "StandardDataTable 사용"
변경_작업:
- "StandardDataTable → 커스텀 Row/Column"
- "헤더 고정 구조 적용"
- "컬럼: 번호(50px), 벤더명(flex:3), 등록일(flex:2), 상태(80px), 작업(100px)"
2.2_모델_목록:
파일: "lib/screens/model/model_list_screen.dart"
현재_문제: "StandardDataTable 사용"
변경_작업:
- "StandardDataTable → 커스텀 Row/Column"
- "컬럼: ID(60px), 제조사(flex:2), 모델명(flex:3), 등록일(flex:2), 상태(80px), 작업(100px)"
2.3_회사_목록:
파일: "lib/screens/company/company_list.dart"
현재_문제: "ShadTable 사용 (헤더 고정 불가)"
변경_작업:
- "ShadTable → 커스텀 Row/Column (헤더 고정)"
- "계층적 표시 로직 완전 유지"
- "Tree View 기능 유지"
2.4_창고_목록:
파일: "lib/screens/warehouse_location/warehouse_location_list.dart"
현재_상태: "이미 커스텀 Row/Column 사용"
개선_작업:
- "장비 관리와 완전히 동일한 스타일 적용"
- "_buildHeaderCell, _buildDataCell 패턴 적용"
```
#### **Phase 3: 운영 관리 화면 (4개)**
```yaml
3.1_대여_목록:
파일: "lib/screens/rent/rent_list_screen.dart"
현재_문제: "StandardDataTable + 혼재된 구조"
변경_작업:
- "전체 구조를 BaseListScreen으로 변경"
- "StandardDataTable → 커스텀 Row/Column"
- "상태 필터를 ShadSelect로 변경"
3.2_정비_이력:
파일: "lib/screens/maintenance/maintenance_history_screen.dart"
작업: "파일 조사 후 장비 관리 패턴 완전 적용"
3.3_정비_일정:
파일: "lib/screens/maintenance/maintenance_schedule_screen.dart"
작업: "파일 조사 후 장비 관리 패턴 완전 적용"
3.4_재고_이력:
파일: "lib/screens/inventory/inventory_history_screen.dart"
작업: "파일 조사 후 장비 관리 패턴 완전 적용"
```
### 🏗️ 표준 테이블 구현 패턴
#### **헤더 고정 구조 (필수 적용)**
```dart
Widget _buildDataTable(List<T> items) {
return Container(
width: double.infinity,
decoration: BoxDecoration(
border: Border.all(color: Colors.black),
borderRadius: BorderRadius.circular(ShadcnTheme.radiusMd),
),
child: Column(
children: [
// 고정 헤더
Container(
padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 10),
decoration: BoxDecoration(
color: ShadcnTheme.muted.withValues(alpha: 0.3),
border: Border(bottom: BorderSide(color: Colors.black)),
),
child: Row(children: _buildHeaderCells()),
),
// 스크롤 바디
Expanded(
child: ListView.builder(
itemCount: items.length,
itemBuilder: (context, index) => _buildTableRow(items[index], index),
),
),
],
),
);
}
```
#### **테이블 스타일 통일**
```yaml
헤더_스타일:
배경색: "ShadcnTheme.muted.withValues(alpha: 0.3)"
텍스트: "ShadcnTheme.bodyMedium (FontWeight.w500)"
패딩: "EdgeInsets.symmetric(horizontal: 16, vertical: 10)"
테두리: "하단선 Colors.black"
바디_스타일:
행_높이: "최소 56px (유동적)"
교대_배경: "짝수 행만 ShadcnTheme.muted.withValues(alpha: 0.1)"
패딩: "EdgeInsets.symmetric(horizontal: 16, vertical: 4)"
테두리: "하단선 Colors.black"
텍스트: "ShadcnTheme.bodySmall"
```
### ⚠️ 절대 준수사항
```yaml
금지_사항:
- "알고리즘 로직 수정 절대 금지"
- "Flutter DataTable, Card, ElevatedButton 사용 절대 금지"
- "새로운 커스텀 컴포넌트 생성 금지"
유지_사항:
- "기존 Controller 및 비즈니스 로직 100% 보존"
- "페이지네이션, 검색, 필터 기능 완전 유지"
- "백엔드 API 호출 패턴 그대로"
목표:
- "모든 화면이 장비 관리와 동일한 헤더 고정 패턴"
- "shadcn_ui 컴포넌트 100% 사용"
- "UI 일관성 완벽 달성"
```
---
*최종 업데이트: 2025-08-30*