# nasstyfox/nass architecture

> Architecture diagram of the GitHub repository nasstyfox/nass, 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/nasstyfox/nass
- Repository: https://github.com/nasstyfox/nass

## Overview

Nass is an Android second-hand clothing marketplace for buyers, sellers, and administrators. Users authenticate and are routed to a role-specific dashboard: buyers browse items, manage a cart, check out, and review purchase history; sellers manage listings and view sales stats; admins manage accounts. Shared settings support profile and password changes. The README documents an MVVM flow through repositories and Retrofit to a REST API, with DataStore-backed sessions. Backend and optional service internals are outside this repository; their details are therefore represented only at the documented boundary.

Main entry points: [`app/src/main/java/com/example/nass/navigation/NavGraph.kt`](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/navigation/NavGraph.kt) (Role routing), [`app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt`](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt) (Buyer state), [`app/src/main/java/com/example/nass/data/repository/AuthRepository.kt`](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/AuthRepository.kt) (Authentication), [`app/src/main/java/com/example/nass/ui/auth`](https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/auth) (Login and register)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Role-based UI"]
  node_auth_ui["Login and register"]
  node_buyer_ui["Buyer dashboard"]
  node_seller_ui["Seller dashboard"]
  node_admin_ui["Admin dashboard"]
  node_settings_ui["Shared settings<br/>[SettingsScreen.kt]"]
end

subgraph group_coordination["App coordination"]
  node_activity["Android entry<br/>[MainActivity.kt]"]
  node_navigation["Role routing<br/>[NavGraph.kt]"]
  node_auth_vm["Auth state<br/>[AuthViewModel.kt]"]
  node_buyer_vm["Buyer state<br/>[BuyerViewModel.kt]"]
  node_seller_vm["Seller state<br/>[SellerViewModel.kt]"]
  node_admin_vm["Admin state<br/>[AdminViewModel.kt]"]
end

subgraph group_data["Data and networking"]
  node_auth_repo["Authentication<br/>[AuthRepository.kt]"]
  node_product_repo["Product catalog"]
  node_cart_repo["Cart and checkout<br/>[CartRepository.kt]"]
  node_seller_repo["Seller listings and stats"]
  node_admin_repo["Account administration<br/>[AdminRepository.kt]"]
  node_profile_repo["User profile"]
  node_session[("Session storage<br/>[SessionStore.kt]")]
  node_retrofit["Retrofit client<br/>[RetrofitClient.kt]"]
  node_api_service["REST API definitions<br/>[ApiService.kt]"]
end

subgraph group_backend["Backend services"]
  node_rest_backend["Express REST API"]
  node_mysql[("MySQL marketplace data")]
end

node_user(("Marketplace user"))

node_user -->|"opens app"| node_activity
node_activity -.->|"starts routing"| node_navigation
node_navigation -->|"routes unauthenticated"| node_auth_ui
node_auth_ui -.->|"submits credentials"| node_auth_vm
node_auth_vm -.->|"requests auth"| node_auth_repo
node_auth_repo -->|"uses networking"| node_retrofit
node_retrofit -.->|"uses API definitions"| node_api_service
node_api_service -->|"calls REST API"| node_rest_backend
node_rest_backend -->|"reads and writes"| node_mysql
node_auth_repo -->|"persists session"| node_session
node_navigation -->|"routes buyer"| node_buyer_ui
node_navigation -->|"routes seller"| node_seller_ui
node_navigation -->|"routes admin"| node_admin_ui
node_buyer_ui -->|"presents state"| node_buyer_vm
node_buyer_vm -.->|"loads products"| node_product_repo
node_buyer_vm -.->|"manages cart"| node_cart_repo
node_seller_ui -->|"presents state"| node_seller_vm
node_seller_vm -.->|"manages listings"| node_seller_repo
node_admin_ui -->|"presents state"| node_admin_vm
node_admin_vm -.->|"manages accounts"| node_admin_repo
node_user -->|"updates settings"| node_settings_ui
node_settings_ui -.->|"changes profile"| node_profile_repo

click node_auth_ui "https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/auth"
click node_buyer_ui "https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/buyer"
click node_seller_ui "https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/seller"
click node_admin_ui "https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/admin"
click node_settings_ui "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/common/SettingsScreen.kt"
click node_activity "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/MainActivity.kt"
click node_navigation "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/navigation/NavGraph.kt"
click node_auth_vm "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/auth/AuthViewModel.kt"
click node_buyer_vm "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt"
click node_seller_vm "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/seller/SellerViewModel.kt"
click node_admin_vm "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/admin/AdminViewModel.kt"
click node_auth_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/AuthRepository.kt"
click node_product_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/ProductRepository.kt"
click node_cart_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/CartRepository.kt"
click node_seller_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/SellerRepository.kt"
click node_admin_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/AdminRepository.kt"
click node_profile_repo "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/ProfileRepository.kt"
click node_session "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/local/SessionStore.kt"
click node_retrofit "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/remote/RetrofitClient.kt"
click node_api_service "https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/remote/ApiService.kt"

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_auth_ui,node_buyer_ui,node_seller_ui,node_admin_ui,node_settings_ui,node_user toneBlue
class node_activity,node_navigation,node_auth_vm,node_buyer_vm,node_seller_vm,node_admin_vm toneAmber
class node_auth_repo,node_product_repo,node_cart_repo,node_seller_repo,node_admin_repo,node_profile_repo,node_session,node_retrofit,node_api_service toneMint
class node_rest_backend,node_mysql toneRose
```

## Components

### Role-based UI

- [Login and register](https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/auth): `app/src/main/java/com/example/nass/ui/auth`
- [Buyer dashboard](https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/buyer): `app/src/main/java/com/example/nass/ui/buyer`
- [Seller dashboard](https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/seller): `app/src/main/java/com/example/nass/ui/seller`
- [Admin dashboard](https://github.com/nasstyfox/nass/tree/master/app/src/main/java/com/example/nass/ui/admin): `app/src/main/java/com/example/nass/ui/admin`
- [Shared settings](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/common/SettingsScreen.kt): `app/src/main/java/com/example/nass/ui/common/SettingsScreen.kt`

### App coordination

- [Android entry](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/MainActivity.kt): `app/src/main/java/com/example/nass/MainActivity.kt`
- [Role routing](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/navigation/NavGraph.kt): `app/src/main/java/com/example/nass/navigation/NavGraph.kt`
- [Auth state](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/auth/AuthViewModel.kt): `app/src/main/java/com/example/nass/ui/auth/AuthViewModel.kt`
- [Buyer state](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt): `app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt`
- [Seller state](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/seller/SellerViewModel.kt): `app/src/main/java/com/example/nass/ui/seller/SellerViewModel.kt`
- [Admin state](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/ui/admin/AdminViewModel.kt): `app/src/main/java/com/example/nass/ui/admin/AdminViewModel.kt`

### Data and networking

- [Authentication](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/AuthRepository.kt): `app/src/main/java/com/example/nass/data/repository/AuthRepository.kt`
- [Product catalog](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/ProductRepository.kt): `app/src/main/java/com/example/nass/data/repository/ProductRepository.kt`
- [Cart and checkout](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/CartRepository.kt): `app/src/main/java/com/example/nass/data/repository/CartRepository.kt`
- [Seller listings and stats](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/SellerRepository.kt): `app/src/main/java/com/example/nass/data/repository/SellerRepository.kt`
- [Account administration](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/AdminRepository.kt): `app/src/main/java/com/example/nass/data/repository/AdminRepository.kt`
- [User profile](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/repository/ProfileRepository.kt): `app/src/main/java/com/example/nass/data/repository/ProfileRepository.kt`
- [Session storage](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/local/SessionStore.kt): `app/src/main/java/com/example/nass/data/local/SessionStore.kt`
- [Retrofit client](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/remote/RetrofitClient.kt): `app/src/main/java/com/example/nass/data/remote/RetrofitClient.kt`
- [REST API definitions](https://github.com/nasstyfox/nass/blob/master/app/src/main/java/com/example/nass/data/remote/ApiService.kt): `app/src/main/java/com/example/nass/data/remote/ApiService.kt`

### Backend services

- **Express REST API**
- **MySQL marketplace data**

### Other components

- **Marketplace user**

## Connections

- Marketplace user → Android entry: opens app (evidence: `README.md`)
- Android entry → Role routing: starts routing
- Role routing → Login and register: routes unauthenticated (evidence: `README.md`)
- Login and register → Auth state: submits credentials
- Auth state → Authentication: requests auth
- Authentication → Retrofit client: uses networking (evidence: `README.md`)
- Retrofit client → REST API definitions: uses API definitions
- REST API definitions → Express REST API: calls REST API (evidence: `README.md`)
- Express REST API → MySQL marketplace data: reads and writes (evidence: `README.md`)
- Authentication → Session storage: persists session (evidence: `README.md`)
- Role routing → Buyer dashboard: routes buyer (evidence: `README.md`)
- Role routing → Seller dashboard: routes seller (evidence: `README.md`)
- Role routing → Admin dashboard: routes admin (evidence: `README.md`)
- Buyer dashboard → Buyer state: presents state (evidence: `README.md`)
- Buyer state → Product catalog: loads products
- Buyer state → Cart and checkout: manages cart
- Seller dashboard → Seller state: presents state (evidence: `README.md`)
- Seller state → Seller listings and stats: manages listings
- Admin dashboard → Admin state: presents state (evidence: `README.md`)
- Admin state → Account administration: manages accounts
- Marketplace user → Shared settings: updates settings (evidence: `README.md`)
- Shared settings → User profile: changes profile
