# sozamegumi/ep-mobile architecture

> Architecture diagram of the GitHub repository sozamegumi/ep-mobile, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sozamegumi/ep-mobile
- Repository: https://github.com/sozamegumi/ep-mobile

## Overview

FindProcurement+ is a Flutter e-procurement prototype with supplier and administrator workflows backed by shared local demo data. The README describes the tender-to-order-to-invoice lifecycle and local persistence; the sampled source does not include the Dart implementation, so workflow edges below cite those documented relationships. The SQL schema is explicitly for a future backend and is not part of the running app.

Main entry points: [`lib/data/app_store.dart`](https://github.com/sozamegumi/ep-mobile/blob/main/lib/data/app_store.dart) (Shared app store), [`lib/screens/login_screen.dart`](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/login_screen.dart) (Login), [`lib/screens/pelawaan_list_screen.dart`](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_list_screen.dart) (Tender invitations), [`lib/screens/pelawaan_detail_screen.dart`](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_detail_screen.dart) (Tender details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_supplier["Supplier workflows"]
  node_invitations["Tender invitations"]
  node_tender_detail["Tender details"]
  node_tender_wizard["Tender submission"]
  node_my_tenders["My tenders"]
  node_orders["Supplier orders"]
  node_invoices["Supplier invoices"]
  node_notifications["Notifications"]
  node_profile["Supplier profile"]
end

subgraph group_admin["Admin workflows"]
  node_admin_home["Admin dashboard"]
  node_admin_tenders["Tender review"]
  node_admin_tender_detail["Tender decision"]
  node_admin_orders["Order issuance"]
  node_admin_invoices["Invoice review"]
end

subgraph group_shared["Shared app core"]
  node_login["Login<br/>[login_screen.dart]"]
  node_router["App routing<br/>[app_router.dart]"]
  node_models["Procurement models<br/>[app_models.dart]"]
end

subgraph group_persistence["Local persistence"]
  node_store["Shared app store<br/>[app_store.dart]"]
  node_seed["Demo seed data<br/>[dummy_data.dart]"]
  node_local_storage[("Device preferences")]
end

node_supplier(("Supplier"))
node_admin(("Administrator"))

node_supplier -->|"logs in"| node_login
node_admin -->|"logs in"| node_login
node_login -->|"opens"| node_invitations
node_invitations -->|"opens"| node_tender_detail
node_tender_detail -->|"starts submission"| node_tender_wizard
node_admin -->|"reviews tenders"| node_admin_tenders
node_admin_tenders -->|"opens tender"| node_admin_tender_detail
node_admin_tender_detail -->|"awards or rejects"| node_store
node_admin -->|"issues orders"| node_admin_orders
node_admin_orders -->|"updates orders"| node_store
node_supplier -->|"accepts order"| node_orders
node_supplier -->|"creates invoice"| node_invoices
node_admin -->|"reviews invoices"| node_admin_invoices
node_admin_invoices -->|"marks paid"| node_store
node_store -->|"updates notifications"| node_notifications
node_store -->|"updates status"| node_orders
node_store -->|"updates timeline"| node_invoices
node_store -->|"supplies counts"| node_admin_home
node_store -->|"persists locally"| node_local_storage
node_seed -->|"seeds first run"| node_store
node_profile -->|"resets demo data"| node_store
node_router -.->|"routes to"| node_login
node_store -.->|"uses data types"| node_models

click node_login "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/login_screen.dart"
click node_invitations "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_list_screen.dart"
click node_tender_detail "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_detail_screen.dart"
click node_tender_wizard "https://github.com/sozamegumi/ep-mobile/tree/main/lib/screens/tender"
click node_my_tenders "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/tawaran_saya_screen.dart"
click node_orders "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pesanan_list_screen.dart"
click node_invoices "https://github.com/sozamegumi/ep-mobile/tree/main/lib/screens/invoice"
click node_notifications "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/notifications_screen.dart"
click node_profile "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/profile_screen.dart"
click node_admin_home "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_home_screen.dart"
click node_admin_tenders "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_tenders_screen.dart"
click node_admin_tender_detail "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_tender_detail_screen.dart"
click node_admin_orders "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_orders_screen.dart"
click node_admin_invoices "https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_invoices_screen.dart"
click node_router "https://github.com/sozamegumi/ep-mobile/blob/main/lib/router/app_router.dart"
click node_models "https://github.com/sozamegumi/ep-mobile/blob/main/lib/models/app_models.dart"
click node_store "https://github.com/sozamegumi/ep-mobile/blob/main/lib/data/app_store.dart"
click node_seed "https://github.com/sozamegumi/ep-mobile/blob/main/lib/data/dummy_data.dart"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_invitations,node_tender_detail,node_tender_wizard,node_my_tenders,node_orders,node_invoices,node_notifications,node_profile toneBlue
class node_admin_home,node_admin_tenders,node_admin_tender_detail,node_admin_orders,node_admin_invoices toneAmber
class node_login,node_router,node_models toneMint
class node_store,node_seed,node_local_storage toneRose
class node_supplier,node_admin toneIndigo
```

## Components

### Supplier workflows

- [Tender invitations](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_list_screen.dart): `lib/screens/pelawaan_list_screen.dart`
- [Tender details](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pelawaan_detail_screen.dart): `lib/screens/pelawaan_detail_screen.dart`
- [Tender submission](https://github.com/sozamegumi/ep-mobile/tree/main/lib/screens/tender): `lib/screens/tender`
- [My tenders](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/tawaran_saya_screen.dart): `lib/screens/tawaran_saya_screen.dart`
- [Supplier orders](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/pesanan_list_screen.dart): `lib/screens/pesanan_list_screen.dart`
- [Supplier invoices](https://github.com/sozamegumi/ep-mobile/tree/main/lib/screens/invoice): `lib/screens/invoice`
- [Notifications](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/notifications_screen.dart): `lib/screens/notifications_screen.dart`
- [Supplier profile](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/profile_screen.dart): `lib/screens/profile_screen.dart`

### Admin workflows

- [Admin dashboard](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_home_screen.dart): `lib/screens/admin/admin_home_screen.dart`
- [Tender review](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_tenders_screen.dart): `lib/screens/admin/admin_tenders_screen.dart`
- [Tender decision](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_tender_detail_screen.dart): `lib/screens/admin/admin_tender_detail_screen.dart`
- [Order issuance](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_orders_screen.dart): `lib/screens/admin/admin_orders_screen.dart`
- [Invoice review](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/admin/admin_invoices_screen.dart): `lib/screens/admin/admin_invoices_screen.dart`

### Shared app core

- [Login](https://github.com/sozamegumi/ep-mobile/blob/main/lib/screens/login_screen.dart): `lib/screens/login_screen.dart`
- [App routing](https://github.com/sozamegumi/ep-mobile/blob/main/lib/router/app_router.dart): `lib/router/app_router.dart`
- [Procurement models](https://github.com/sozamegumi/ep-mobile/blob/main/lib/models/app_models.dart): `lib/models/app_models.dart`

### Local persistence

- [Shared app store](https://github.com/sozamegumi/ep-mobile/blob/main/lib/data/app_store.dart): `lib/data/app_store.dart`
- [Demo seed data](https://github.com/sozamegumi/ep-mobile/blob/main/lib/data/dummy_data.dart): `lib/data/dummy_data.dart`
- **Device preferences**

### Other components

- **Supplier**
- **Administrator**

## Connections

- Supplier → Login: logs in (evidence: `README.md`)
- Administrator → Login: logs in (evidence: `README.md`)
- Login → Tender invitations: opens (evidence: `README.md`)
- Tender invitations → Tender details: opens (evidence: `README.md`)
- Tender details → Tender submission: starts submission (evidence: `README.md`)
- Administrator → Tender review: reviews tenders (evidence: `README.md`)
- Tender review → Tender decision: opens tender (evidence: `README.md`)
- Tender decision → Shared app store: awards or rejects (evidence: `README.md`)
- Administrator → Order issuance: issues orders (evidence: `README.md`)
- Order issuance → Shared app store: updates orders (evidence: `README.md`)
- Supplier → Supplier orders: accepts order (evidence: `README.md`)
- Supplier → Supplier invoices: creates invoice (evidence: `README.md`)
- Administrator → Invoice review: reviews invoices (evidence: `README.md`)
- Invoice review → Shared app store: marks paid (evidence: `README.md`)
- Shared app store → Notifications: updates notifications (evidence: `README.md`)
- Shared app store → Supplier orders: updates status (evidence: `README.md`)
- Shared app store → Supplier invoices: updates timeline (evidence: `README.md`)
- Shared app store → Admin dashboard: supplies counts (evidence: `README.md`)
- Shared app store → Device preferences: persists locally (evidence: `README.md`)
- Demo seed data → Shared app store: seeds first run (evidence: `README.md`)
- Supplier profile → Shared app store: resets demo data (evidence: `README.md`)
- App routing → Login: routes to
- Shared app store → Procurement models: uses data types
