How fmoorenoo/haircloud works
HairCloud is an Android app backed by a Flask REST API and PostgreSQL. Clients authenticate, discover shops and services, book and review appointments; professionals manage shop details, services, staff, schedules, appointments and reports. The Android path runs from navigation/screens through ViewModels and repositories to Retrofit; the backend applies domain rules and persists data. The README documents capabilities not visible in sampled excerpts, so those subsystems are represented without asserting unverified internal calls.
Main entry points: api Flask API · db.py PostgreSQL · auth.py Authentication endpoints · appointments.py Appointment rules
Components 29
Android app
- Android entry
frontend/app/src/main/java/com/haircloud/MainActivity.kt - App navigation
frontend/app/src/main/java/com/haircloud/navigation/AppNavigation.kt - Client screens
frontend/app/src/main/java/com/haircloud/screens/client - Professional screens
frontend/app/src/main/java/com/haircloud/screens/barber - ViewModels
frontend/app/src/main/java/com/haircloud/viewmodel - Repositories
frontend/app/src/main/java/com/haircloud/data/repository - API client
frontend/app/src/main/java/com/haircloud/data/ApiClient.kt - API service
frontend/app/src/main/java/com/haircloud/data/ApiService.kt - Session manager
frontend/app/src/main/java/com/haircloud/data/SessionManager.kt - Encrypted token store
frontend/app/src/main/java/com/haircloud/data/storage/TokenManager.kt
REST API
- Flask API
backend/app/api - Authentication endpoints
backend/app/api/auth.py - Appointment endpoints
backend/app/api/appointments.py - Shop and catalog endpoints
backend/app/api - Review endpoints
backend/app/api/reviews.py - Request validation
backend/app/schemas.py - Resource serialization
backend/app/serializers.py
Business services
- Appointment rules
backend/app/services/appointments.py - Availability rules
backend/app/services/availability.py - Reports and statistics
backend/app/services/stats.py - Email verification
backend/app/services/verification.py
Identity and security
- Authentication and roles
backend/app/security/auth.py - Access and refresh tokens
backend/app/security/tokens.py - Security audit
backend/app/security/audit.py
Persistence and delivery
- PostgreSQL
backend/app/db.py - Email delivery
backend/app/services/mailer.py - API error handling
backend/app/errors.py
Other components
- Clients
- Shop professionals
Connections 35
- Clients → Android entry: uses
README.md - Shop professionals → Android entry: uses
README.md - Android entry → App navigation: starts
frontend/app/src/main/java/com/haircloud/MainActivity.kt - App navigation → Client screens: routes to
frontend/app/src/main/java/com/haircloud/navigation/AppNavigation.kt - App navigation → Professional screens: routes to
frontend/app/src/main/java/com/haircloud/navigation/AppNavigation.kt - Client screens → ViewModels: uses
frontend/app/src/main/java/com/haircloud/screens/client/ClientProfileScreen.kt - Professional screens → ViewModels: uses
frontend/app/src/main/java/com/haircloud/screens/barber/BarbershopServicesScreen.kt - ViewModels → Repositories: delegates to
frontend/app/src/main/java/com/haircloud/viewmodel/AuthViewModel.kt - Repositories → API client: calls
frontend/app/src/main/java/com/haircloud/data/repository/AuthRepository.kt - API client → API service: creates
frontend/app/src/main/java/com/haircloud/data/ApiClient.kt - API client → Session manager: reads and refreshes
frontend/app/src/main/java/com/haircloud/data/ApiClient.kt - Session manager → Encrypted token store: persists
frontend/app/src/main/java/com/haircloud/data/SessionManager.kt - API service → Flask API: sends REST requests
README.md - Flask API → Authentication endpoints: routes authentication
- Flask API → Appointment endpoints: routes appointments
- Flask API → Shop and catalog endpoints: routes shop operations
- Flask API → Review endpoints: routes reviews
- Appointment endpoints → Appointment rules: delegates to
- Appointment rules → Availability rules: checks availability
backend/app/services/appointments.py - Appointment rules → Email delivery: sends notices
backend/app/services/appointments.py - Appointment rules → PostgreSQL: reads and writes
backend/app/services/appointments.py - Authentication endpoints → Authentication and roles: authenticates requests
backend/app/api/auth.py - Authentication endpoints → Access and refresh tokens: issues tokens
backend/app/api/auth.py - Authentication endpoints → Email verification: delegates verification
backend/app/api/auth.py - Email verification → Email delivery: sends email
backend/app/services/verification.py - Authentication and roles → Access and refresh tokens: decodes tokens
backend/app/security/auth.py - Access and refresh tokens → Security audit: records reuse
backend/app/security/tokens.py - Authentication and roles → PostgreSQL: loads user
backend/app/security/auth.py - Review endpoints → Authentication and roles: checks access
backend/app/api/reviews.py - Review endpoints → PostgreSQL: queries reviews
backend/app/api/reviews.py - Shop and catalog endpoints → Request validation: validates input
backend/app/api/services.py - Shop and catalog endpoints → Resource serialization: formats resource
backend/app/api/services.py - Shop and catalog endpoints → PostgreSQL: queries catalog
backend/app/api/services.py - Request validation → API error handling: raises validation errors
backend/app/schemas.py - Reports and statistics → PostgreSQL: reads metrics