How qleanfeel-bot/qleanfeel-rn works
Qleanfeel is a React Native app for authentication and user-facing calendar, manual-order, and profile workflows, paired with a NestJS backend whose shown API surface handles authentication and health. The mobile entry point composes services and gates the authenticated shell; application services delegate domain operations to repositories and infrastructure adapters. Backend auth routes invoke session use cases, with persistence wiring supplied by the database module. The README describes the mobile product but not its feature details; unsampled feature and backend links are omitted or marked unverified.
Main entry points: AuthenticatedAppShell.tsx App shell · AuthGate.tsx Auth gate · auth.controller.ts Auth routes · CalendarService.ts Calendar service
Components 34
Mobile application
- App entry
App.tsx - App shell
src/presentation/auth/AuthenticatedAppShell.tsx - Navigation
src/presentation/navigation/RootNavigator.tsx
Mobile authentication
- Auth gate
src/presentation/auth/AuthGate.tsx - Auth state
src/application/auth/AuthStateController.ts - Provider adapter
src/application/auth/ports/AuthProviderAdapter.ts - Auth API port
src/application/auth/ports/AuthApi.ts - Login screen
src/presentation/auth/LoginScreen.tsx - Preview auth
src/development/auth/createDevelopmentAuthController.ts
Product features
- Calendar screens
src/presentation/calendar - Calendar service
src/application/calendar/CalendarService.ts - Calendar API adapter
src/infrastructure/calendar/CalendarApiRepository.ts - Calendar API
src/infrastructure/calendar/CalendarApi.ts - Calendar model
src/domain/calendar/entities/CalendarEntry.ts - Order screens
src/presentation/manualOrder - Scheduled order use case
src/application/manualOrder/CreateScheduledManualOrder.ts - Order service
src/application/manualOrder/ManualOrderService.ts - Order API adapter
src/infrastructure/manualOrder/ManualOrderApiRepository.ts - Order API
src/infrastructure/manualOrder/ManualOrderApi.ts - Order model
src/domain/manualOrder/entities/ManualOrder.ts - Profile screens
src/presentation/profile - Profile service
src/application/profile/ProfileService.ts - Profile API adapter
src/infrastructure/profile/ProfileApiRepository.ts - Profile API
src/infrastructure/profile/ProfileApi.ts - Profile model
src/domain/profile/entities/Profile.ts
Backend API
- Backend startup
backend/src/main.ts - Auth routes
backend/src/http/auth/auth.controller.ts - Current-user route
backend/src/http/auth/me.controller.ts - Access guard
backend/src/http/auth/qleanfeel-access.guard.ts - Health endpoint
backend/src/http/health/health.controller.ts - Backend modules
backend/src/app.module.ts
Backend identity and storage
- Bootstrap session
backend/src/application/identity/use-cases/bootstrap-auth-session.ts
Other components
- App user
- Mobile client
Connections 34
- App user → App entry: uses
- App entry → Auth gate: renders
App.tsx - App entry → Preview auth: composes preview
- Auth gate → Auth state: initializes
src/presentation/auth/AuthGate.tsx - Auth gate → Login screen: renders
src/presentation/auth/AuthGate.tsx - Auth gate → App shell: renders
src/presentation/auth/AuthGate.tsx - Auth state → Provider adapter: requests credentials
src/application/auth/AuthStateController.ts - Auth state → Auth API port: authenticates with
src/application/auth/AuthStateController.ts - App shell → Navigation: renders
src/presentation/auth/AuthenticatedAppShell.tsx - App shell → Calendar service: provides
src/presentation/auth/AuthenticatedAppShell.tsx - App shell → Order service: provides
src/presentation/auth/AuthenticatedAppShell.tsx - App shell → Scheduled order use case: provides
src/presentation/auth/AuthenticatedAppShell.tsx - App shell → Profile service: provides
src/presentation/auth/AuthenticatedAppShell.tsx - Calendar screens → Calendar service: uses
- Calendar service → Calendar API adapter: delegates
src/application/calendar/CalendarService.ts - Calendar API adapter → Calendar API: calls
src/infrastructure/calendar/CalendarApiRepository.ts - Calendar API adapter → Calendar model: maps entries
src/infrastructure/calendar/CalendarApiRepository.ts - Order screens → Order service: uses
- Scheduled order use case → Calendar service: uses
src/application/manualOrder/CreateScheduledManualOrder.ts - Scheduled order use case → Order service: uses
src/application/manualOrder/CreateScheduledManualOrder.ts - Order service → Order API adapter: delegates
src/application/manualOrder/ManualOrderService.ts - Order API adapter → Order API: calls
src/infrastructure/manualOrder/ManualOrderApiRepository.ts - Order API adapter → Order model: maps orders
src/infrastructure/manualOrder/ManualOrderApiRepository.ts - Profile screens → Profile service: uses
- Profile service → Profile API adapter: delegates
src/application/profile/ProfileService.ts - Profile API adapter → Profile API: calls
src/infrastructure/profile/ProfileApiRepository.ts - Profile API adapter → Profile model: maps profile
src/infrastructure/profile/ProfileApiRepository.ts - Mobile client → Auth routes: calls
- Backend startup → Backend modules: starts
backend/src/main.ts - Backend modules → Auth routes: registers
backend/src/app.module.ts - Backend modules → Health endpoint: registers
backend/src/app.module.ts - Auth routes → Bootstrap session: executes
backend/src/http/auth/auth.controller.ts - Auth routes → Access guard: guards logout
backend/src/http/auth/auth.controller.ts - Current-user route → Access guard: guards route
backend/src/http/auth/me.controller.ts