# Mobile scaffold status

Created on 2026-04-18.

- Flutter scaffold added under `mobile/`
- Android-first app shell uses bottom navigation for core V1 flows
- Theme, asset folders, config placeholders, and lightweight session/network placeholders are ready for follow-up work
- Backend integration, generated Flutter platform folders, and real assets are intentionally not included yet

## Auth/session progress

- `apiBaseUrl` is now pointed at local Android emulator backend routing (`http://10.0.2.2:8000/api/v1`)
- `http` dependency added for real API calls
- Mobile login flow now calls `/auth/login`
- Current-user sync now calls `/auth/me`
- Session state now hydrates from local storage on app start and writes back through `SharedPreferences`
- In-memory session state continues to broadcast through `ValueNotifier`
- App shell now gates the main tabs behind a login screen when no session exists
- Dashboard and profile now reflect real login/session state instead of pure placeholder copy

## Review entry progress

- `review_entry_screen.dart` is now a real editable form instead of placeholder blocks
- The mobile side now captures:
  - contract text
  - contract type
  - review side (`party_a` / `party_b`)
  - optional file attachment
- A draft/request model is defined in `features/review/domain/review_draft.dart`
- A submission controller is defined in `features/review/application/review_submission_controller.dart`
- Current submit action now goes through `ReviewDraft -> ReviewSubmissionController -> ApiClient.submitReview()`
- `/reviews` now supports text-only, file-only, or text+file submission from the mobile draft/controller structure
- File selection UI is present, but still depends on Flutter/file_picker runtime validation in a real mobile environment

## Review history progress

- `ApiClient.fetchReviewHistory()` now calls `GET /reviews` with the current bearer token
- A list-domain model is defined in `features/review_history/domain/review_history_item.dart`
- A history controller is defined in `features/review_history/application/review_history_controller.dart`
- `review_history_screen.dart` now loads and renders real list data for the current signed-in user
- The mobile side can now form a basic path of login -> submit review -> view review history

## Review detail/result progress

- `ApiClient.fetchReviewDetail()` now calls `GET /reviews/{review_id}`
- `ApiClient.fetchReviewResult()` now calls `GET /reviews/{review_id}/result`
- `features/review_history/domain/review_detail.dart` and `review_result_summary.dart` provide the detail/result/report models
- `review_detail_controller.dart` now loads task detail first and, for `completed` / `partial`, also loads result summary and report metadata
- `review_history_screen.dart` can navigate from a list item into the detail/result screen
- `review_detail_screen.dart` now renders task information, text preview, result summary, risk distribution, clause/risk counts, review opinion, and report metadata with copy-link action
- The detail screen now supports pull-to-refresh and app-bar refresh for status/result/report updates after submit
- Review submit success now auto-navigates into the newly created detail page

## Current limitation

- Session persistence is still local-only and not encrypted
- The live backend login path still depends on PostgreSQL/audit write success, so mobile login will fully work only after the backend DB chain is available
- File upload support has been wired into the request path, but still needs Flutter SDK / device validation for real picker behavior
- Report flow currently covers metadata + copy link; true file download/preview remains a next step
- Brand/image assets are still placeholders; asset constants are intentionally nulled until real png/svg resources are added