# apknation/skincare-app architecture

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

- Interactive diagram: https://gitdiagram.com/apknation/skincare-app
- Repository: https://github.com/apknation/skincare-app

## Overview

Sura Yangu is an Android skincare marketplace: shoppers assess their skin, discover and compare approved products, check out, and track orders; sellers manage products and fulfilment, while admins moderate the platform. The Flutter client talks to a Dart HTTP API backed by PostgreSQL, with product images stored separately. The README documents the major capabilities and API flow, but no runtime source was sampled, so implementation-level client dispatch and backend route wiring are not asserted.

Main entry points: [`lib/data/api_client.dart`](https://github.com/apknation/skincare-app/blob/main/lib/data/api_client.dart) (API client), [`backend/bin/server.dart`](https://github.com/apknation/skincare-app/blob/main/backend/bin/server.dart) (HTTP server), [`lib/app.dart`](https://github.com/apknation/skincare-app/blob/main/lib/app.dart) (Role-based app shell), [`lib/features/cart/checkout_page.dart`](https://github.com/apknation/skincare-app/blob/main/lib/features/cart/checkout_page.dart) (Cart and checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter client"]
  node_app["Role-based app shell<br/>[app.dart]"]
  node_store["Client state<br/>[store.dart]"]
  node_api_client["API client<br/>[api_client.dart]"]
end

subgraph group_shopping["Shopper experience"]
  node_skin_assessment["Skin assessment"]
  node_recommendations["Product matching"]
  node_catalog["Catalog and comparison<br/>[catalog_page.dart]"]
  node_product_detail["Product detail"]
  node_cart_checkout["Cart and checkout<br/>[checkout_page.dart]"]
  node_payment["Payment selection<br/>[payment_sheet.dart]"]
  node_orders_ui["Order tracking<br/>[orders_page.dart]"]
end

subgraph group_operations["Seller and admin tools"]
  node_seller_tools["Seller operations"]
  node_admin_console["Administration<br/>[admin_page.dart]"]
end

subgraph group_backend["API and persistence"]
  node_backend_server["HTTP server<br/>[server.dart]"]
  node_api_core["Auth and core API<br/>[api_core.dart]"]
  node_api_orders["Order API<br/>[api_orders.dart]"]
  node_api_uploads["Image upload API<br/>[api_uploads.dart]"]
  node_database[("PostgreSQL<br/>[001_init.sql]")]
  node_image_files[("Uploaded images")]
end

node_shopper(("Shopper"))
node_seller(("Seller"))
node_admin(("Admin"))

node_shopper -->|"uses"| node_app
node_seller -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"offers"| node_skin_assessment
node_skin_assessment -->|"saves profile"| node_api_client
node_recommendations -->|"ranks matches"| node_catalog
node_shopper -->|"receives matches"| node_recommendations
node_shopper -->|"browses"| node_catalog
node_catalog -->|"opens product"| node_product_detail
node_shopper -->|"checks out"| node_cart_checkout
node_cart_checkout -->|"selects payment"| node_payment
node_cart_checkout -->|"submits order"| node_api_client
node_payment -->|"starts and confirms"| node_api_client
node_orders_ui -->|"loads orders"| node_api_client
node_seller -->|"manages shop"| node_seller_tools
node_seller_tools -->|"uses seller endpoints"| node_api_client
node_admin -->|"moderates"| node_admin_console
node_admin_console -->|"uses admin endpoints"| node_api_client
node_api_client -->|"sends JSON requests"| node_backend_server
node_backend_server -->|"routes API requests"| node_api_core
node_backend_server -->|"routes order requests"| node_api_orders
node_backend_server -->|"routes uploads"| node_api_uploads
node_api_core -->|"persists marketplace data"| node_database
node_api_orders -->|"persists orders"| node_database
node_api_uploads -->|"stores image bytes"| node_image_files

click node_app "https://github.com/apknation/skincare-app/blob/main/lib/app.dart"
click node_store "https://github.com/apknation/skincare-app/blob/main/lib/data/store.dart"
click node_api_client "https://github.com/apknation/skincare-app/blob/main/lib/data/api_client.dart"
click node_skin_assessment "https://github.com/apknation/skincare-app/blob/main/lib/features/skin/assessment_page.dart"
click node_recommendations "https://github.com/apknation/skincare-app/blob/main/lib/data/recommendation_engine.dart"
click node_catalog "https://github.com/apknation/skincare-app/blob/main/lib/features/catalog/catalog_page.dart"
click node_product_detail "https://github.com/apknation/skincare-app/blob/main/lib/features/product/product_details_page.dart"
click node_cart_checkout "https://github.com/apknation/skincare-app/blob/main/lib/features/cart/checkout_page.dart"
click node_payment "https://github.com/apknation/skincare-app/blob/main/lib/features/cart/payment_sheet.dart"
click node_orders_ui "https://github.com/apknation/skincare-app/blob/main/lib/features/orders/orders_page.dart"
click node_seller_tools "https://github.com/apknation/skincare-app/blob/main/lib/features/seller/seller_dashboard_page.dart"
click node_admin_console "https://github.com/apknation/skincare-app/blob/main/lib/features/admin/admin_page.dart"
click node_backend_server "https://github.com/apknation/skincare-app/blob/main/backend/bin/server.dart"
click node_api_core "https://github.com/apknation/skincare-app/blob/main/backend/lib/api_core.dart"
click node_api_orders "https://github.com/apknation/skincare-app/blob/main/backend/lib/api_orders.dart"
click node_api_uploads "https://github.com/apknation/skincare-app/blob/main/backend/lib/api_uploads.dart"
click node_database "https://github.com/apknation/skincare-app/blob/main/backend/migrations/001_init.sql"
click node_image_files "https://github.com/apknation/skincare-app/tree/main/backend/uploads"

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_app,node_store,node_api_client toneBlue
class node_skin_assessment,node_recommendations,node_catalog,node_product_detail,node_cart_checkout,node_payment,node_orders_ui toneAmber
class node_seller_tools,node_admin_console toneMint
class node_backend_server,node_api_core,node_api_orders,node_api_uploads,node_database,node_image_files toneRose
class node_shopper,node_seller,node_admin toneIndigo
```

## Components

### Flutter client

- [Role-based app shell](https://github.com/apknation/skincare-app/blob/main/lib/app.dart): `lib/app.dart`
- [Client state](https://github.com/apknation/skincare-app/blob/main/lib/data/store.dart): `lib/data/store.dart`
- [API client](https://github.com/apknation/skincare-app/blob/main/lib/data/api_client.dart): `lib/data/api_client.dart`

### Shopper experience

- [Skin assessment](https://github.com/apknation/skincare-app/blob/main/lib/features/skin/assessment_page.dart): `lib/features/skin/assessment_page.dart`
- [Product matching](https://github.com/apknation/skincare-app/blob/main/lib/data/recommendation_engine.dart): `lib/data/recommendation_engine.dart`
- [Catalog and comparison](https://github.com/apknation/skincare-app/blob/main/lib/features/catalog/catalog_page.dart): `lib/features/catalog/catalog_page.dart`
- [Product detail](https://github.com/apknation/skincare-app/blob/main/lib/features/product/product_details_page.dart): `lib/features/product/product_details_page.dart`
- [Cart and checkout](https://github.com/apknation/skincare-app/blob/main/lib/features/cart/checkout_page.dart): `lib/features/cart/checkout_page.dart`
- [Payment selection](https://github.com/apknation/skincare-app/blob/main/lib/features/cart/payment_sheet.dart): `lib/features/cart/payment_sheet.dart`
- [Order tracking](https://github.com/apknation/skincare-app/blob/main/lib/features/orders/orders_page.dart): `lib/features/orders/orders_page.dart`

### Seller and admin tools

- [Seller operations](https://github.com/apknation/skincare-app/blob/main/lib/features/seller/seller_dashboard_page.dart): `lib/features/seller/seller_dashboard_page.dart`
- [Administration](https://github.com/apknation/skincare-app/blob/main/lib/features/admin/admin_page.dart): `lib/features/admin/admin_page.dart`

### API and persistence

- [HTTP server](https://github.com/apknation/skincare-app/blob/main/backend/bin/server.dart): `backend/bin/server.dart`
- [Auth and core API](https://github.com/apknation/skincare-app/blob/main/backend/lib/api_core.dart): `backend/lib/api_core.dart`
- [Order API](https://github.com/apknation/skincare-app/blob/main/backend/lib/api_orders.dart): `backend/lib/api_orders.dart`
- [Image upload API](https://github.com/apknation/skincare-app/blob/main/backend/lib/api_uploads.dart): `backend/lib/api_uploads.dart`
- [PostgreSQL](https://github.com/apknation/skincare-app/blob/main/backend/migrations/001_init.sql): `backend/migrations/001_init.sql`
- [Uploaded images](https://github.com/apknation/skincare-app/tree/main/backend/uploads): `backend/uploads`

### Other components

- **Shopper**
- **Seller**
- **Admin**

## Connections

- Shopper → Role-based app shell: uses (evidence: `README.md`)
- Seller → Role-based app shell: uses (evidence: `README.md`)
- Admin → Role-based app shell: uses (evidence: `README.md`)
- Role-based app shell → Skin assessment: offers (evidence: `README.md`)
- Skin assessment → API client: saves profile (evidence: `README.md`)
- Product matching → Catalog and comparison: ranks matches (evidence: `README.md`)
- Shopper → Product matching: receives matches (evidence: `README.md`)
- Shopper → Catalog and comparison: browses (evidence: `README.md`)
- Catalog and comparison → Product detail: opens product (evidence: `README.md`)
- Shopper → Cart and checkout: checks out (evidence: `README.md`)
- Cart and checkout → Payment selection: selects payment (evidence: `README.md`)
- Cart and checkout → API client: submits order (evidence: `README.md`)
- Payment selection → API client: starts and confirms (evidence: `README.md`)
- Order tracking → API client: loads orders (evidence: `README.md`)
- Seller → Seller operations: manages shop (evidence: `README.md`)
- Seller operations → API client: uses seller endpoints (evidence: `README.md`)
- Admin → Administration: moderates (evidence: `README.md`)
- Administration → API client: uses admin endpoints (evidence: `README.md`)
- API client → HTTP server: sends JSON requests (evidence: `README.md`)
- HTTP server → Auth and core API: routes API requests (evidence: `README.md`)
- HTTP server → Order API: routes order requests (evidence: `README.md`)
- HTTP server → Image upload API: routes uploads (evidence: `README.md`)
- Auth and core API → PostgreSQL: persists marketplace data (evidence: `README.md`)
- Order API → PostgreSQL: persists orders (evidence: `README.md`)
- Image upload API → Uploaded images: stores image bytes (evidence: `README.md`)
