How nasstyfox/nass works
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: NavGraph.kt Role routing · BuyerViewModel.kt Buyer state · AuthRepository.kt Authentication · auth Login and register
Components 23
Role-based UI
- Login and register
app/src/main/java/com/example/nass/ui/auth - Buyer dashboard
app/src/main/java/com/example/nass/ui/buyer - Seller dashboard
app/src/main/java/com/example/nass/ui/seller - Admin dashboard
app/src/main/java/com/example/nass/ui/admin - Shared settings
app/src/main/java/com/example/nass/ui/common/SettingsScreen.kt
App coordination
- Android entry
app/src/main/java/com/example/nass/MainActivity.kt - Role routing
app/src/main/java/com/example/nass/navigation/NavGraph.kt - Auth state
app/src/main/java/com/example/nass/ui/auth/AuthViewModel.kt - Buyer state
app/src/main/java/com/example/nass/ui/buyer/BuyerViewModel.kt - Seller state
app/src/main/java/com/example/nass/ui/seller/SellerViewModel.kt - Admin state
app/src/main/java/com/example/nass/ui/admin/AdminViewModel.kt
Data and networking
- Authentication
app/src/main/java/com/example/nass/data/repository/AuthRepository.kt - Product catalog
app/src/main/java/com/example/nass/data/repository/ProductRepository.kt - Cart and checkout
app/src/main/java/com/example/nass/data/repository/CartRepository.kt - Seller listings and stats
app/src/main/java/com/example/nass/data/repository/SellerRepository.kt - Account administration
app/src/main/java/com/example/nass/data/repository/AdminRepository.kt - User profile
app/src/main/java/com/example/nass/data/repository/ProfileRepository.kt - Session storage
app/src/main/java/com/example/nass/data/local/SessionStore.kt - Retrofit client
app/src/main/java/com/example/nass/data/remote/RetrofitClient.kt - REST API definitions
app/src/main/java/com/example/nass/data/remote/ApiService.kt
Backend services
- Express REST API
- MySQL marketplace data
Other components
- Marketplace user
Connections 22
- Marketplace user → Android entry: opens app
README.md - Android entry → Role routing: starts routing
- Role routing → Login and register: routes unauthenticated
README.md - Login and register → Auth state: submits credentials
- Auth state → Authentication: requests auth
- Authentication → Retrofit client: uses networking
README.md - Retrofit client → REST API definitions: uses API definitions
- REST API definitions → Express REST API: calls REST API
README.md - Express REST API → MySQL marketplace data: reads and writes
README.md - Authentication → Session storage: persists session
README.md - Role routing → Buyer dashboard: routes buyer
README.md - Role routing → Seller dashboard: routes seller
README.md - Role routing → Admin dashboard: routes admin
README.md - Buyer dashboard → Buyer state: presents state
README.md - Buyer state → Product catalog: loads products
- Buyer state → Cart and checkout: manages cart
- Seller dashboard → Seller state: presents state
README.md - Seller state → Seller listings and stats: manages listings
- Admin dashboard → Admin state: presents state
README.md - Admin state → Account administration: manages accounts
- Marketplace user → Shared settings: updates settings
README.md - Shared settings → User profile: changes profile