2026/05/09

오늘의 이야기

프레시틱 (Freshtic) 개발 작업 히스토리


프로젝트 개요



  • 프로젝트명: Freshtic (Fresh + Tactic)

  • 목적: 유통기한(또는 사용자 정의 기한) 관리를 통해 음식물 폐기(낭비)를 줄이는 로컬 중심 Android 앱

  • 버전: v1.0 (오프라인 완결)

  • 개발 기간: 2026.02.17 ~

  • 기술 스택: Kotlin, Jetpack Compose, Room, Hilt, WorkManager (예정), CameraX + ML Kit (예정)



📋 Plan.pptx 대비 진행 상황


✅ 완료된 단계


1단계: 프로젝트 설정 및 테마 적용 ✅ 100% 완료


Plan 요구사항:



  • 프로젝트 초기 설정

  • Material 3 테마 적용

  • 색상 시스템 (Light/Dark)

  • 타이포그래피 (Noto Sans KR)


구현 완료:


✅ Kotlin 2.3.10, KSP 2.3.2 적용
✅ Gradle 9.0.1, AGP 최신 버전
✅ Hilt 2.59.1 설정 완료
✅ Room 2.8.4 설정 완료
✅ Material 3 테마 완전 구현
   - Color.kt: Light/Dark 색상 각 38개 정의
   - Theme.kt: lightScheme, darkScheme 완성
   - Type.kt: Material 3 Typography 전체 정의
✅ Google Fonts (Noto Sans KR) 적용
   - font_certs.xml 생성
   - ui-text-google-fonts 라이브러리 추가
✅ AndroidManifest.xml 카메라 권한 설정

파일 구조:


ui/theme/
├── Color.kt          # 76개 색상 (Light/Dark/Contrast variants)
├── Theme.kt          # Material 3 테마 설정
└── Type.kt           # Noto Sans KR 타이포그래피

res/values/
└── font_certs.xml    # Google Fonts 인증서


2단계: 데이터 레이어 구축 (Room Database) ✅ 100% 완료


Plan 요구사항:



  • Entity 정의 (ItemEntity, BarcodeCacheEntity)

  • Enum 클래스 (DateType, StorageType, ItemStatus)

  • TypeConverter (LocalDate, Instant, Enum)

  • DAO 인터페이스 (ItemDao, BarcodeCacheDao)

  • Database 클래스

  • Repository 패턴 적용


구현 완료:


✅ Domain Model (Enum 클래스)
   - DateType: EXPIRY(유통기한), USER_DEFINED(사용자 정의)
   - StorageType: ROOM(실온), FRIDGE(냉장), FREEZER(냉동)
   - ItemStatus: ACTIVE(활성), CONSUMED(소비), TRASHED(폐기)

✅ Room Entity
   - ItemEntity: 11개 필드, 인덱스 3개 (status, targetDate, barcode)
   - BarcodeCacheEntity: 바코드 재스캔 시 상품명 자동완성

✅ TypeConverter
   - LocalDate ↔ Long (epochDay)
   - Instant ↔ Long (epochMilli)
   - Enum ↔ String (name)

✅ DAO 인터페이스
   - ItemDao: 14개 메서드
     * CRUD 기본 (insert, update, delete, getById)
     * 홈 화면용 쿼리 (getAllActive, getUpcoming, getExpired)
     * 검색/필터 (searchByName, getByStorageType)
     * 알림용 (getAllActiveItems)
   - BarcodeCacheDao: 4개 메서드 (upsert, getByBarcode, deleteOld)

✅ Repository
   - ItemRepository: 비즈니스 로직 중앙 관리
   - 바코드 캐시 자동 upsert
   - WorkManager 연동 준비 (TODO 마커)

✅ Hilt DI
   - DatabaseModule: Database, DAO 제공

파일 구조:


domain/model/
├── DateType.kt
├── ItemStatus.kt
└── StorageType.kt

data/local/
├── entity/
│   ├── ItemEntity.kt
│   └── BarcodeCacheEntity.kt
├── dao/
│   ├── ItemDao.kt
│   └── BarcodeCacheDao.kt
├── converter/
│   └── RoomTypeConverters.kt
└── db/
    └── FreshticDatabase.kt

data/repository/
└── ItemRepository.kt

di/
└── DatabaseModule.kt

Plan 대비 차이점:



  • ✅ Plan의 모든 쿼리 요구사항 구현됨

  • ✅ 인덱스 최적화 적용 (Plan 권장사항)

  • ⚠️ WorkManager 알림 연동은 아직 TODO (4단계 예정)



3단계: UI 기본 구조 및 네비게이션 ✅ 85% 완료


Plan 요구사항:



  • 5개 화면 구현 (홈, 스캔, 등록/수정, 상세, 설정)

  • Navigation 설정

  • 각 화면 기본 UI

  • ViewModel 연동


구현 완료:


✅ Navigation 설정
   - Screen.kt: 5개 라우트 정의
   - FreshticNavGraph.kt: 네비게이션 그래프
   - 딥링크 지원 (freshtic://items/{itemId})
   - 파라미터 전달 (itemId)

✅ 홈 화면 (HomeScreen.kt + HomeViewModel.kt)
   - 임박 섹션 (0~3일) ✅
   - 전체 목록 (targetDate 오름차순) ✅
   - D-day 자동 계산 및 색상 구분 ✅
   - FAB (+버튼) → 스캔 화면 이동 ✅
   - Empty/Loading 상태 처리 ✅
   - Flow 기반 실시간 업데이트 ✅

✅ 바코드 스캔 화면 (BarcodeScanScreen.kt)
   - 기본 레이아웃 완성 ✅
   - "직접 입력" 버튼 → 등록 화면 이동 ✅
   - ⚠️ CameraX + ML Kit 구현 예정 (TODO)

✅ 등록/수정 화면 (AddEditItemScreen.kt + AddEditItemViewModel.kt)
   - 기본 레이아웃 완성 ✅
   - itemId 파라미터 처리 ✅
   - ⚠️ 폼 필드 구현 예정 (다음 단계)

✅ 상세 화면 (ItemDetailScreen.kt + ItemDetailViewModel.kt)
   - 기본 레이아웃 완성 ✅
   - Loading/Error/Success 상태 처리 ✅
   - 소비/폐기 버튼 UI ✅
   - ⚠️ 실제 동작 구현 예정 (다음 단계)

✅ 설정 화면 (SettingsScreen.kt)
   - 알림 on/off Switch ✅
   - 앱 정보 표시 ✅
   - ⚠️ 실제 설정 저장 로직 예정 (4단계)

✅ MainActivity 통합
   - FreshticNavGraph 적용 ✅
   - enableEdgeToEdge ✅

파일 구조:


navigation/
├── Screen.kt
└── FreshticNavGraph.kt

ui/
├── home/
│   ├── HomeScreen.kt
│   └── HomeViewModel.kt
├── scan/
│   └── BarcodeScanScreen.kt
├── addedit/
│   ├── AddEditItemScreen.kt
│   └── AddEditItemViewModel.kt
├── detail/
│   ├── ItemDetailScreen.kt
│   └── ItemDetailViewModel.kt
└── settings/
    └── SettingsScreen.kt

Plan 대비 차이점:



  • ✅ 모든 화면 기본 구조 완성

  • ✅ Material 3 디자인 적용 (Plan 요구사항)

  • ⚠️ Icons 라이브러리 미사용 (Text로 대체, 추후 추가 예정)

  • ⚠️ 검색/필터 UI는 다음 단계 예정

  • ⚠️ 하단 배너 광고는 추후 구현 예정



🚧 진행 중 / 예정 단계


4단계: 상세 기능 구현 🔄 0% (다음 단계)


Plan 요구사항:



  • 등록 폼 완전 구현

    • 상품명 입력 (필수)

    • 날짜 선택 (DatePicker)

    • 날짜 타입 선택 (유통기한 / 내가 정한 기한)

    • 보관 타입 선택 (실온/냉장/냉동)

    • 메모 입력 (선택)

    • 사진 첨부 (선택)

    • 바코드 자동 채우기



  • 상세 화면 완성

    • 모든 정보 표시

    • 소비/폐기 처리 로직

    • Undo 스낵바 (Plan 권장사항)



  • 검색/필터 기능

    • 상품명 검색

    • 보관 타입 필터

    • 상태 필터 (정상/임박/만료)




예상 파일:


ui/addedit/
├── components/
│   ├── DateTypeSelector.kt
│   ├── StorageTypeSelector.kt
│   └── DatePickerDialog.kt


5단계: 바코드 스캔 구현 🔄 0% (예정)


Plan 요구사항:



  • CameraX 통합

  • ML Kit Barcode Scanner

  • 권한 처리 (CAMERA)

  • 스캔 성공/실패 처리

  • 토치, 사진 모드 전환

  • 저조도/흔들림 대응


필요 라이브러리:


// build.gradle.kts 추가 예정
implementation("androidx.camera:camera-camera2")
implementation("androidx.camera:camera-lifecycle")
implementation("androidx.camera:camera-view")
implementation("com.google.mlkit:barcode-scanning")


6단계: 알림 시스템 (WorkManager) 🔄 0% (예정)


Plan 요구사항:



  • ExpiryNotificationWorker 구현

  • RescheduleExpiryWorker 구현

  • D-3 (20:00) 알림

  • D-0 (20:00) 알림

  • UniqueWork 관리 (expiry_${itemId}_D3/D0)

  • Tag 관리 (expiry_notifications)

  • 소비/폐기 시 알림 취소

  • 설정 변경 시 재스케줄링


예상 파일 구조:


worker/
├── ExpiryNotificationWorker.kt
├── RescheduleExpiryWorker.kt
└── WorkerKeys.kt

notification/
├── NotificationHelper.kt
└── NotificationChannels.kt


7단계: 광고 통합 🔄 0% (예정)


Plan 요구사항:



  • Google AdMob 통합

  • 홈 화면 하단 배너 광고 1개

  • 광고 로딩 실패 처리



📊 전체 진행률





























































단계 항목 진행률 상태
1 프로젝트 설정 및 테마 100% ✅ 완료
2 데이터 레이어 (Room) 100% ✅ 완료
3 UI 기본 구조 85% ✅ 완료
4 상세 기능 구현 0% 🔄 예정
5 바코드 스캔 0% 🔄 예정
6 알림 시스템 0% 🔄 예정
7 광고 통합 0% 🔄 예정
전체 MVP 완성도 ~40% 🚀 진행 중


🏗️ 현재 아키텍처


Clean Architecture 구조


app/
├── data/                    # 데이터 레이어
│   ├── local/              # Room Database
│   │   ├── entity/         # DB 엔티티
│   │   ├── dao/            # DB 접근
│   │   ├── converter/      # 타입 변환
│   │   └── db/             # Database 클래스
│   └── repository/         # Repository 패턴
│
├── domain/                  # 도메인 레이어
│   └── model/              # 비즈니스 모델 (Enum)
│
├── ui/                      # Presentation 레이어
│   ├── home/               # 홈 화면
│   ├── scan/               # 스캔 화면
│   ├── addedit/            # 등록/수정 화면
│   ├── detail/             # 상세 화면
│   ├── settings/           # 설정 화면
│   └── theme/              # Material 3 테마
│
├── navigation/              # 네비게이션
│
├── di/                      # Dependency Injection
│
└── worker/                  # Background 작업 (예정)

의존성 그래프


UI Layer (Compose + ViewModel)
    ↓
Repository Layer
    ↓
Data Source Layer (Room DAO)
    ↓
Database (Room)


🔧 기술적 특징


1. LocalDate / Instant 사용



  • Java 8+ Date/Time API 활용

  • Room TypeConverter로 자동 변환

  • 타임존 안전성 확보 (Plan 요구사항)


2. Flow 기반 반응형 프로그래밍


// 실시간 데이터 업데이트
fun getAllActiveItems(): Flow<List<ItemEntity>>

3. Material 3 디자인 시스템



  • Dynamic Color 지원 (Android 12+)

  • Light/Dark 테마 완벽 지원

  • Noto Sans KR 폰트 적용


4. Hilt 의존성 주입



  • Singleton Repository

  • ViewModel 자동 주입

  • Database 모듈 분리


5. Navigation Component



  • Type-safe navigation

  • 딥링크 지원

  • SavedStateHandle 파라미터 전달



📝 Plan.pptx 준수 사항


✅ 완벽히 준수한 항목



  1. 데이터 설계

    • ✅ targetDate 하나로 통일 (dateType으로 구분)

    • ✅ 인덱스 (status, targetDate, barcode)

    • ✅ TypeConverter 정확히 구현

    • ✅ BarcodeCacheEntity 정책대로 구현



  2. DAO 설계

    • ✅ Plan의 모든 쿼리 구현

    • ✅ 표시 상태 계산 로직 (targetDate 기준)

    • ✅ Flow 기반 반응형



  3. Repository 책임

    • ✅ DB 변경 후 스케줄 연동 (TODO 준비)

    • ✅ 바코드 캐시 upsert



  4. UI/플로우

    • ✅ 5개 화면 모두 생성

    • ✅ 홈 임박 섹션 구현

    • ✅ D-day 계산 및 표시




⚠️ 부분 구현 / 예정 항목



  1. 바코드 스캔

    • ⚠️ 기본 UI만 완성

    • 🔄 CameraX + ML Kit 구현 예정



  2. 등록 폼

    • ⚠️ 기본 레이아웃만 완성

    • 🔄 모든 필드 구현 예정



  3. 알림 시스템

    • ⚠️ Repository에 TODO 마커만

    • 🔄 WorkManager 구현 예정



  4. 광고

    • 🔄 AdMob 통합 예정




❌ Plan과 다른 점



  1. Icons 사용

    • Plan: Material Icons 사용 예상

    • 실제: Text로 임시 대체 (빌드 속도 우선)

    • 계획: 추후 material-icons-extended 추가



  2. OCR 유통기한 인식

    • Plan: Won't for v1 (명시적 제외)

    • 실제: 구현 안 함 (Plan 준수)



  3. 커뮤니티 기능

    • Plan: Won't for v1 (명시적 제외)

    • 실제: 구현 안 함 (Plan 준수)





🐛 알려진 이슈 및 해결


1. Kotlin/Hilt 버전 호환성



  • 문제: Kotlin 2.3.2 + KSP 호환 이슈

  • 해결: Kotlin 2.3.10, KSP 2.3.2로 조정


2. 파일 인코딩 문제



  • 문제: PowerShell 정규식으로 한글 깨짐

  • 해결: 파일별 수동 수정


3. Material Icons 의존성



  • 문제: icons 라이브러리 누락

  • 해결: Text로 임시 대체 (빌드 우선)



📚 다음 작업 우선순위


즉시 착수 (4단계)



  1. ✅ 등록 폼 완전 구현

    • DatePicker 통합

    • 모든 필드 검증

    • 저장 로직 완성



  2. ✅ 상세 화면 완성

    • 소비/폐기 처리

    • Undo 기능



  3. ✅ 검색/필터 UI


중요 (5단계)



  1. 🔄 바코드 스캔

    • CameraX 설정

    • ML Kit 통합

    • 권한 처리




핵심 기능 (6단계)



  1. 🔄 알림 시스템

    • WorkManager 구현

    • D-3, D-0 알림

    • 스케줄 관리




부가 기능 (7단계)



  1. 🔄 광고 통합

  2. 🔄 Material Icons 추가

  3. 🔄 최종 테스트 및 최적화



🎯 v1.0 릴리즈 체크리스트



  • 프로젝트 설정

  • Room Database

  • Navigation 설정

  • 홈 화면

  • 등록 폼 (진행 중)

  • 바코드 스캔

  • 알림 시스템

  • 광고

  • 최종 테스트

  • 릴리즈 빌드


예상 완성도: 40% → 100% (약 60% 남음)



📌 참고 문서



  • documents/plan.pptx - 전체 기획안

  • documents/README.md - Material Theme 가이드

  • gradle/libs.versions.toml - 의존성 버전 관리



마지막 업데이트: 2026-02-17
작성자: AI Assistant
프로젝트 상태: 🚀 활발히 개발 중





시간:

댓글 없음:

댓글 쓰기

피드 구독하기: 댓글 (Atom)

오늘의 이야기

다음 회차 추천 번호: 추천 1: [15,27,28,31,38,41] (최빈값 조합) 추천 2: [10,15,22,27,31,38] (평균적인 특징 조합) 추천 3: [25,27,30,36,38,42] (고합 조합) 추천 4: [01,10,13...

  • 오늘의 이야기
    이전 글에서 정리할 것처럼 java에서 kotlin으로 이전을 했습니다.  그러고 나서 보기 시작했는 데,  DefaultSharedPrefernces의 사용할 수 없는 환경으로 변경이 된 것을 알게 되었습니다.    이전 prefs = Prefere...