프로젝트 현황 보고서

마지막 업데이트: 2026-02-20

1. 인프라 현황

버전 조회일: 2026-02-19

2. 개발 Phase 진행 현황

✅ 완료

🔄 진행중 / 부분 완료

Phase 10 세부 항목

Integration (연동)

• [ ] 송장번호 자동 동기화 (Invoice Sync) — 보류
• [ ] 자동 Sync 스케줄 (Cron Job) — 보류

Product & Inventory (상품/재고)

• [x] 바코드/SKU 채널별 매핑 로직 완성 — OrderImport fallback 및 ProductResource Repeater 구현 완료
• [x] 상품 입출고 내역 열람 페이지 — 11컬럼, 10필터(상단 펼침), 도움말 모달, 주문 연결
• [ ] 재고 실사(Physical Count) 기능 — UI 미완
• [ ] 채널별 재고 할당 수동 관리 UI — UI 미완

System & ACL (시스템/보안)

• [x] filament-shield ACL (Role-based Access) — 3역할, 289권한 구성 완료
• [x] Activity Log (spatie/activitylog) — 핵심 모델 4개 적용 완료 (Order/Product/Inventory/PurchaseOrder)
• [x] 공통 코드 관리 — value/sort_order 컨럼 추가 + UI 고도화 완료

Advanced Logic (고도화)

• [x] 안전재고 자동 계산 서비스 — SafetyStockService + UpdateSafetyStockJob + Scheduler(매일 02:00) 구현 완료
• [ ] 발주점(Reorder Point) 알림 — 보류

코드 품질 개선 (2026-02-19)

• [x] Enum 전환 4개: OrderStatus, StockLogType, StockTakeStatus, ReturnRequestStatus
• [x] Filament v4→v5 API 전환 (actions→recordActions) 5개 리소스
• [x] 매직넘버 전면 제거 (OrderImport, SafetyStockService, InventoryAnalysisService)

UI/UX 개선 (2026-02-26)

• [x] 카테고리 관리 전면 개편: 트리 구조(대/중/소) tree_path 정렬, C00001 자동 채번 규칙 적용, 모달 폼 전체 폭(5xl, columnSpanFull()) 확장, 채널 매핑 기능 추가
• [x] Pretendard Variable 폰트 전역 적용 (자체 호스팅, Filament + Blade)
• [x] StockLogType Enum 색상 체계 통일 (IN=초록, OUT=빨강, ADJUST=노랑, ALLOCATE=파랑)

DevOps (2026-02-20)

• [x] GitHub 연동 ([email protected]:jungdosa/lensnara_scm.git, main 브랜치)

3. API 현황

• 인증: X-Api-Key 헤더 (SalesChannel별 키)
• 주의: SalesChannel 3개 중 1개만 테스트 키 설정됨

4. Domain 모델 구조

app/Domains/
├── Product/       (Product, ProductMapping, ProductImport)
├── Inventory/     (Inventory, Allocation, StockLog, StockTake, Services, Enums)
├── Order/         (Order, OrderItem, ReturnRequest, Imports, Enums)
├── Purchasing/    (Supplier, PurchaseOrder, PurchaseOrderItem, Enums)
└── SalesChannel/  (SalesChannel)

5. 인프라 마이그레이션 이력