feat: 온보딩 구현 by minmul07 · Pull Request #6 · Central-MakeUs/recap-android

minmul07 · 2026-07-01T05:10:13Z

Summary

Landing -> 권한 안내 -> 로그인(mock) -> 스크린샷 정리 제안 -> 권한 요구 -> 범위 선택 -> 홈
온보딩 과정에서 Full 이미지 권한 요구
일부 UI 컴포넌트 구현(RecapButton, BottomSheets)

Notes

추후 구체화 예정

- 확인이 필요한 스크린샷 알림 컴포넌트 - 스크린샷 처리 완료 알림 컴포넌트

Copilot

Pull request overview

Implements a new multi-step onboarding flow (Landing → policy → login(mock) → permission guidance → range select → cleanup start → home) and introduces an OCR cleanup pipeline backed by WorkManager + Room, alongside several new reusable UI components and theming updates.

Changes:

Added new onboarding screens/flow logic with image-permission handling and progress UI.
Implemented OCR job execution + persistence (WorkManager worker, Room DB/DAO/repository) and surfaced latest job progress on Home.
Introduced/updated design components (RecapButton, bottom sheets, home cards) and added a Developer “Component Garden” screen.

Reviewed changes

Copilot reviewed 63 out of 63 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
gradle/libs.versions.toml	Adds version/catalog entries for Room/Work/AndroidX Hilt and material icons.
app/src/main/res/values/strings.xml	Adds onboarding/home/component-garden/bottom-sheet strings and updates range count formats.
app/src/main/res/drawable/ic_check_24.xml	Adds a check icon used for completed OCR UI.
app/src/main/res/drawable/bid_landscape_24px.xml	Adds a vector icon used in onboarding permission UI.
app/src/main/java/com/chalkak/recap/RecapApplication.kt	Integrates WorkManager Configuration.Provider with Hilt WorkerFactory.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingStartScreen.kt	Removes old onboarding start screen.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingPermissionGuideScreen.kt	Updates permission guide UI to use RecapButton + previews.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingLandingScreen.kt	Adds new onboarding landing screen.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingImagePolicyScreen.kt	Adds onboarding image policy step UI.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingFirstCleanupScreen.kt	Adds first-cleanup screen with permission bottom sheet logic.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingCleanupStartScreen.kt	Adds cleanup start/progress UI tied to OCR job progress.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingCleanupRangeScreen.kt	Enhances range selection with dynamic counts, permission gating, and previews.
app/src/main/java/com/chalkak/recap/feature/onboarding/screen/OnboardingAuthScreen.kt	Refactors onboarding auth/login UI into a new login screen layout.
app/src/main/java/com/chalkak/recap/feature/onboarding/OnboardingViewModel.kt	Migrates onboarding VM to Hilt + connects to OCR repository & permission/range count logic.
app/src/main/java/com/chalkak/recap/feature/onboarding/OnboardingScreen.kt	Reworks onboarding step routing and adds SnackbarHost support + previews.
app/src/main/java/com/chalkak/recap/feature/onboarding/OnboardingRoute.kt	Wires permission request/settings intents and onboarding completion behavior.
app/src/main/java/com/chalkak/recap/feature/onboarding/OnboardingPreviews.kt	Adds shared preview annotations/container for onboarding screens.
app/src/main/java/com/chalkak/recap/feature/onboarding/OnboardingContract.kt	Updates onboarding state/actions/steps and connects cleanup range to OCR ranges.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/OnboardingTopBar.kt	Adds a new onboarding top bar with back button + progress rendering.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/OnboardingGuideComponents.kt	Adds step header, bullets, and permission icon tile components.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/OnboardingComponents.kt	Removes legacy onboarding component implementations.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/OnboardingComponentPreviews.kt	Adds preview scaffolding for onboarding components.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/OnboardingBrandComponents.kt	Adds brand/illustration composables used in onboarding screens.
app/src/main/java/com/chalkak/recap/feature/onboarding/component/CleanupRangeOptionCard.kt	Extracts cleanup range option card into its own component file.
app/src/main/java/com/chalkak/recap/feature/mypage/MyPageScreen.kt	Minor parameter ordering cleanup.
app/src/main/java/com/chalkak/recap/feature/mypage/MyPageContract.kt	Switches `@StringRes` annotations to @get:StringRes.
app/src/main/java/com/chalkak/recap/feature/home/HomeViewModel.kt	Adds Hilt-backed VM exposing latest OCR job as UI state.
app/src/main/java/com/chalkak/recap/feature/home/HomeScreen.kt	Adds OCR progress card + raw result list UI on Home.
app/src/main/java/com/chalkak/recap/feature/home/HomeRoute.kt	Adds Home route wiring with Hilt VM.
app/src/main/java/com/chalkak/recap/feature/home/HomeContract.kt	Extends Home UI state to include latest OCR job.
app/src/main/java/com/chalkak/recap/feature/developer/DeveloperRoute.kt	Adds navigation destination for Component Garden.
app/src/main/java/com/chalkak/recap/feature/developer/DeveloperOptionsScreen.kt	Adds new developer option for Component Garden.
app/src/main/java/com/chalkak/recap/feature/developer/ComponentGardenScreen.kt	Adds a screen to showcase cards/buttons/bottom sheets.
app/src/main/java/com/chalkak/recap/feature/demo/RecentScreenshotsRow.kt	Updates previews to use `toUri()`.
app/src/main/java/com/chalkak/recap/feature/demo/DemoViewModel.kt	Migrates demo VM to Hilt and reuses LocalScreenshotDataSource for permission/query.
app/src/main/java/com/chalkak/recap/feature/demo/DemoScreen.kt	Switches demo screen to use `hiltViewModel()` and updates previews.
app/src/main/java/com/chalkak/recap/feature/demo/DemoContract.kt	Switches `@StringRes` annotations to @get:StringRes.
app/src/main/java/com/chalkak/recap/feature/demo/DemoContent.kt	Minor parameter ordering cleanup + updates previews to `toUri()`.
app/src/main/java/com/chalkak/recap/feature/collection/CollectionScreen.kt	Minor parameter ordering cleanup.
app/src/main/java/com/chalkak/recap/feature/collection/CollectionContract.kt	Switches `@StringRes` annotations to @get:StringRes.
app/src/main/java/com/chalkak/recap/core/model/OcrModels.kt	Adds domain models for OCR jobs/ranges/results.
app/src/main/java/com/chalkak/recap/core/model/LocalImage.kt	Adds a model for MediaStore images.
app/src/main/java/com/chalkak/recap/core/model/ImageAccessLevel.kt	Adds image access level enum (Full/Selected/Denied).
app/src/main/java/com/chalkak/recap/core/design/theme/Theme.kt	Updates app color scheme and disables dynamic color by default.
app/src/main/java/com/chalkak/recap/core/design/theme/Color.kt	Defines new Recap color palette constants.
app/src/main/java/com/chalkak/recap/core/design/component/ReviewRequiredScreenshotCard.kt	Adds a new home card component.
app/src/main/java/com/chalkak/recap/core/design/component/RecapPlaceholderScreen.kt	Uses RecapButton for placeholder screen actions.
app/src/main/java/com/chalkak/recap/core/design/component/RecapButton.kt	Adds RecapButton design-system component with sizing, icons, shadows, etc.
app/src/main/java/com/chalkak/recap/core/design/component/PhotoAccessPermissionBottomSheet.kt	Adds permission request bottom sheet component.
app/src/main/java/com/chalkak/recap/core/design/component/OrganizedCaptureCard.kt	Adds a “organized captures” home card component.
app/src/main/java/com/chalkak/recap/core/design/component/KakaoLoginButton.kt	Removes legacy Kakao login button (replaced by RecapButton usage).
app/src/main/java/com/chalkak/recap/core/design/component/ImageLoadFailureBottomSheet.kt	Adds image-load failure bottom sheet component.
app/src/main/java/com/chalkak/recap/core/data/WorkManagerModule.kt	Provides WorkManager via Hilt.
app/src/main/java/com/chalkak/recap/core/data/RecapDatabase.kt	Adds Room database definition for OCR entities.
app/src/main/java/com/chalkak/recap/core/data/ocr/OcrWorker.kt	Adds WorkManager worker that runs ML Kit OCR and persists results.
app/src/main/java/com/chalkak/recap/core/data/ocr/OcrRepository.kt	Adds repository coordinating permissions, counts, DB observation, and OCR work enqueueing.
app/src/main/java/com/chalkak/recap/core/data/ocr/OcrEntities.kt	Adds Room entities + domain mapping helpers.
app/src/main/java/com/chalkak/recap/core/data/ocr/OcrDao.kt	Adds DAO for OCR jobs/results and progress updates.
app/src/main/java/com/chalkak/recap/core/data/LocalScreenshotDataSource.kt	Adds MediaStore-based screenshot query + permission utilities.
app/src/main/java/com/chalkak/recap/core/data/DatabaseModule.kt	Provides Room database/DAO via Hilt.
app/src/main/java/com/chalkak/recap/app/RecapNavHost.kt	Switches Home destination to HomeRoute.
app/src/main/AndroidManifest.xml	Removes default WorkManager initializer via manifest merge rules.
app/build.gradle.kts	Adds dependencies for Room, WorkManager, AndroidX Hilt, and material icons extended + KSP processors.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

 import android.app.Application
+import androidx.hilt.work.HiltWorkerFactory
+import androidx.work.Configuration
+import com.google.android.datatransport.BuildConfig


+    fun currentImageAccessLevel(): ImageAccessLevel {
+        return when {
+            Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
+                    context.hasPermission(Manifest.permission.READ_MEDIA_IMAGES) -> ImageAccessLevel.Full
+
+            Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE &&
+                    context.hasPermission(Manifest.permission.READ_MEDIA_VISUAL_USER_SELECTED) -> ImageAccessLevel.Selected
+
+            Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU &&
+                    context.hasPermission(Manifest.permission.READ_EXTERNAL_STORAGE) -> ImageAccessLevel.Full
+
+            else -> ImageAccessLevel.Denied
+        }
+    }


-    <string name="onboarding_start_button">시작하기</string>
+    <string name="component_garden_title">컴포넌트 가든</string>
+    <string name="component_garden_home_cards_section_title">홈 카드</string>
+    <string name="component_garden_ui_components_section_title"> 컴포넌트</string>


+        viewModelScope.launch {
+            val counts = CleanupRange.entries.associateWith { range ->
+                ocrRepository.countScreenshots(range.ocrRange)
+            }
+            _uiState.update { current ->


+    private fun startOcrAndMoveToCleanup() {
+        val selectedRange = _uiState.value.selectedRange
+        if (!_uiState.value.canConfirmRange) {
+            _uiState.update { current ->
+                current.copy(errorMessage = "cleanup_range_unavailable")
+            }
+            return
+        }
+
+        _uiState.update { current -> current.copy(activeOcrJob = null) }
+        moveTo(OnboardingStep.CleanupStart)
+        viewModelScope.launch {
+            _uiState.update { current -> current.copy(isLoading = true, errorMessage = null) }
+            runCatching {
+                ocrRepository.startOcr(selectedRange.ocrRange)
+            }.onFailure {
+                _uiState.update { current ->
+                    current.copy(errorMessage = "ocr_start_failed")
+                }


Copilot

Pull request overview

Copilot reviewed 63 out of 63 changed files in this pull request and generated 3 comments.

    override fun onCreate() {
        super.onCreate()

        if (BuildConfig.DEBUG) {
            Timber.plant(Timber.DebugTree())
        }
    }


+        viewModelScope.launch {
+            val counts = CleanupRange.entries.associateWith { range ->
+                ocrRepository.countScreenshots(range.ocrRange)
+            }
+            _uiState.update { current ->
+                current.copy(
+                    rangeCounts = counts,
+                    isRangeCountLoading = false,
+                    errorMessage = null,
+                )
+            }
+        }


+    private fun startOcrAndMoveToCleanup() {
+        val selectedRange = _uiState.value.selectedRange
+        if (!_uiState.value.canConfirmRange) {
+            _uiState.update { current ->
+                current.copy(errorMessage = "cleanup_range_unavailable")
+            }
+            return
+        }
+
+        _uiState.update { current -> current.copy(activeOcrJob = null) }
+        moveTo(OnboardingStep.CleanupStart)
+        viewModelScope.launch {
+            _uiState.update { current -> current.copy(isLoading = true, errorMessage = null) }
+            runCatching {
+                ocrRepository.startOcr(selectedRange.ocrRange)
+            }.onFailure {
+                _uiState.update { current ->
+                    current.copy(errorMessage = "ocr_start_failed")
+                }


minmul07 · 2026-07-01T06:05:14Z

@codex

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e0655a5b9a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-07-01T06:14:51Z

+        val screenshotRelativePaths = listOf(
+            "DCIM/Screenshots/",
+        )


Include non-DCIM screenshot folders

On devices that store screenshots in Pictures/Screenshots/ instead of DCIM/Screenshots/, this exact RELATIVE_PATH filter makes countScreenshots() and queryScreenshots() return empty lists even after full photo permission. That leaves onboarding stuck on the empty/disabled cleanup path for users who do have screenshots, so include the other common screenshot location or detect screenshot buckets more broadly.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-07-01T06:14:51Z

+                    text = if (job.isCompleted) {
+                        stringResource(R.string.home_ocr_complete_title)
+                    } else {
+                        stringResource(R.string.home_ocr_running_title)
+                    },


Distinguish failed OCR jobs from running ones

OcrWorker persists Failed and Cancelled statuses, but this branch renders every non-completed job with the running title. When OCR fails, for example because ML Kit or URI loading throws, Home keeps showing an analysis-running progress card even though the work is finished, leaving users with stale status and no error/retry path.

Useful? React with 👍 / 👎.

minmul07 added 8 commits June 26, 2026 22:59

refactor(annotation): StringRes 어노테이션 타겟 명시

da4e7a8

feat(design): 온보딩 UI 구현

17cdd46

feat(design): 앱 색상 테마 적용

c1f762d

feat(onboarding): 온보딩에서 OCR 처리 구현

c1857ee

feat(design): UI 컴포넌트 구현

a97e07d

- 확인이 필요한 스크린샷 알림 컴포넌트 - 스크린샷 처리 완료 알림 컴포넌트

feat(onboarding): 온보딩 UI 변경

a46cbf8

feat(design): 바텀시트 구현

09f4546

feat(design): Button 컴포넌트 적용

1b6be63

minmul07 self-assigned this Jul 1, 2026

minmul07 linked an issue Jul 1, 2026 that may be closed by this pull request

[feat] 온보딩 화면 구현 #5

Closed

minmul07 requested a review from Copilot July 1, 2026 05:10

Copilot started reviewing on behalf of minmul07 July 1, 2026 05:11 View session

Copilot AI reviewed Jul 1, 2026

View reviewed changes

feat(onboarding): 온보딩 단계에서 이미지 권한 요구 추가

e0655a5

minmul07 force-pushed the 005-feat-onboarding-flow-implementation branch from 3de8f34 to e0655a5 Compare July 1, 2026 05:30

minmul07 requested a review from Copilot July 1, 2026 05:30

Copilot started reviewing on behalf of minmul07 July 1, 2026 05:31 View session

Copilot AI reviewed Jul 1, 2026

View reviewed changes

chatgpt-codex-connector Bot reviewed Jul 1, 2026

View reviewed changes

minmul07 merged commit 19b759d into main Jul 1, 2026
1 check passed

minmul07 deleted the 005-feat-onboarding-flow-implementation branch July 17, 2026 02:48

Navigation Menu

Repository navigation

feat: 온보딩 구현 - #6

feat: 온보딩 구현#6
minmul07 merged 9 commits into
mainfrom
005-feat-onboarding-flow-implementation

minmul07 commented Jul 1, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI left a comment

Uh oh!

minmul07 commented Jul 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Uh oh!

chatgpt-codex-connector Bot Jul 1, 2026

Uh oh!

chatgpt-codex-connector Bot Jul 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

minmul07 commented Jul 1, 2026

Summary

Notes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

minmul07 commented Jul 1, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Jul 1, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Jul 1, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants