How nasstyfox/pastimes_xisd_android works
Pastimes is a second-hand clothing marketplace: buyers browse and purchase listings, sellers manage inventory, and admins oversee accounts and activity. The Android app authenticates users and routes them by role; feature screens use the API client to reach the Express API, whose route handlers implement marketplace operations against MySQL. Firebase provides authentication, while Cloudinary supports item-image uploads. README documents the broad capability and integration map; sampled source verifies app routing, API contracts, server dispatch, authentication, and database access, but not every feature implementation.
Main entry points: server.js Express server · db.js SQL connection pool · ApiService.kt API contract · RootNav.kt Role navigation
Components 27
Android app
- App startup
android/app/src/main/java/com/pastimes/app/MainActivity.kt - Login and registration
android/app/src/main/java/com/pastimes/app/ui/auth - Auth state
android/app/src/main/java/com/pastimes/app/ui/auth/AuthViewModel.kt - Auth repository
android/app/src/main/java/com/pastimes/app/data/repository/AuthRepository.kt - Role navigation
android/app/src/main/java/com/pastimes/app/ui/RootNav.kt - Buyer features
android/app/src/main/java/com/pastimes/app/ui/buyer - Seller features
android/app/src/main/java/com/pastimes/app/ui/seller - Admin features
android/app/src/main/java/com/pastimes/app/ui/admin - User preferences
android/app/src/main/java/com/pastimes/app/ui/settings - HTTP client
android/app/src/main/java/com/pastimes/app/data/api/ApiClient.kt - API contract
android/app/src/main/java/com/pastimes/app/data/api/ApiService.kt
Marketplace API
- Express server
api/src/server.js - Authentication routes
api/src/routes/auth.js - Categories and listings
api/src/routes/items.js - Cart operations
api/src/routes/cart.js - Checkout and orders
api/src/routes/orders.js - Delivery addresses
api/src/routes/addresses.js - Administration routes
api/src/routes/admin.js - Settings routes
api/src/routes/settings.js - Token authentication
api/src/middleware/auth.js - Role authorization
api/src/middleware/role.js - SQL connection pool
api/src/config/db.js
Identity and media
- Firebase setup
api/src/config/firebase.js - Firebase services
- Cloudinary image hosting
Marketplace data
- MySQL marketplace DB
Other components
- Marketplace user
Connections 38
- Marketplace user → Login and registration: signs in
- Login and registration → Auth state: submits credentials
android/app/src/main/java/com/pastimes/app/ui/auth/LoginScreen.kt - Auth state → Auth repository: delegates auth
android/app/src/main/java/com/pastimes/app/ui/auth/AuthViewModel.kt - Auth repository → Firebase services: authenticates
android/app/src/main/java/com/pastimes/app/data/repository/AuthRepository.kt - Auth repository → API contract: registers profile
android/app/src/main/java/com/pastimes/app/data/repository/AuthRepository.kt - App startup → Role navigation: routes by role
android/app/src/main/java/com/pastimes/app/MainActivity.kt - Role navigation → Buyer features: opens buyer routes
android/app/src/main/java/com/pastimes/app/ui/RootNav.kt - Role navigation → Seller features: opens seller routes
android/app/src/main/java/com/pastimes/app/ui/RootNav.kt - Role navigation → Admin features: opens admin routes
android/app/src/main/java/com/pastimes/app/ui/RootNav.kt - Role navigation → User preferences: opens preferences
android/app/src/main/java/com/pastimes/app/ui/RootNav.kt - Buyer features → API contract: requests marketplace data
android/app/src/main/java/com/pastimes/app/ui/buyer/ItemDetailScreen.kt - Seller features → API contract: manages listings
android/app/src/main/java/com/pastimes/app/ui/seller/AddEditItemViewModel.kt - Admin features → API contract: requests user actions
android/app/src/main/java/com/pastimes/app/ui/admin/AdminUserDetailViewModel.kt - User preferences → API contract: updates preferences
android/app/src/main/java/com/pastimes/app/ui/settings/SettingsViewModel.kt - API contract → HTTP client: uses Retrofit
android/app/src/main/java/com/pastimes/app/data/api/ApiClient.kt - HTTP client → Express server: sends HTTPS requests
README.md - Express server → Authentication routes: mounts routes
api/src/server.js - Express server → Categories and listings: mounts routes
api/src/server.js - Express server → Cart operations: mounts routes
api/src/server.js - Express server → Checkout and orders: mounts routes
api/src/server.js - Express server → Delivery addresses: mounts routes
api/src/server.js - Express server → Administration routes: mounts routes
api/src/server.js - Express server → Settings routes: mounts routes
api/src/server.js - Authentication routes → Token authentication: protects profile lookup
api/src/routes/auth.js - Token authentication → Firebase setup: verifies token
api/src/middleware/auth.js - Firebase setup → Firebase services: initializes Admin SDK
api/src/config/firebase.js - Token authentication → SQL connection pool: loads user profile
api/src/middleware/auth.js - Authentication routes → SQL connection pool: reads and creates profiles
api/src/routes/auth.js - Categories and listings → SQL connection pool: queries listings
api/src/routes/items.js - Cart operations → SQL connection pool: updates cart
api/src/routes/cart.js - Checkout and orders → SQL connection pool: records purchases
api/src/routes/orders.js - Delivery addresses → SQL connection pool: stores addresses
api/src/routes/addresses.js - Administration routes → SQL connection pool: reads and updates users
api/src/routes/admin.js - Settings routes → SQL connection pool: stores preferences
api/src/routes/settings.js - SQL connection pool → MySQL marketplace DB: queries marketplace data
README.md - Role authorization → Administration routes: authorizes admin actions
api/src/routes/admin.js - Seller features → Cloudinary image hosting: uploads listing images
README.md - Administration routes → Firebase services: sends password resets
README.md