How flormaldonado-ki/ecoruta_is works
EcoRuta Escolar is a university carpooling app: users register and authenticate, then use trip, vehicle, reservation, notification, and community-impact features through a React Native app and Express API. The README confirms the app-to-API-to-PostgreSQL deployment and documents email and file-storage integrations. The sampled code shows app routing, authentication orchestration, and selected API routes; some feature internals were not sampled, so those links are marked unverified rather than asserted as observed calls.
Main entry points: app.js Express API · db.js Database pool · auth.service.js Authentication service · App.tsx App navigation
Components 25
Mobile app
- App navigation
frontend/App.tsx - Login and registration
frontend/src/screens/RegisterScreen.tsx - Authenticated home
frontend/src/screens/AuthenticatedHomeScreen.tsx - Trip discovery and management
frontend/src/screens/PassengerSearchScreen.tsx - Driver trip setup
frontend/src/screens/DriverRouteSetupScreen.tsx - Notification experience
frontend/src/hooks/useNotifications.tsx - API client
frontend/src/services/apiClient.ts - Local driver state
frontend/src/services/tripStorage.ts
API and identity
- Express API
backend/src/app.js - Auth and profile routes
backend/src/modules/auth/auth.routes.js - Authentication service
backend/src/modules/auth/auth.service.js - Account repository
backend/src/modules/auth/auth.repository.js - Catalogs
backend/src/modules/catalogos/catalogos.service.js
Carpool features
- Vehicle management
backend/src/modules/vehiculos/vehiculos.routes.js - Trips and routes
backend/src/modules/viajes/viajes.routes.js - Reservations
backend/src/modules/reservas/reservas.routes.js - Notifications
backend/src/modules/notificaciones/notificaciones.routes.js - Community impact
backend/src/modules/impacto/impacto.routes.js
Shared services
- Database pool
backend/src/config/db.js - Email delivery
backend/src/shared/mailer/index.js - Document storage
backend/src/shared/storage/index.js
Other components
- App user
- Neon PostgreSQL
- SMTP email
- Cloudinary files
Connections 29
- App user → App navigation: uses
README.md - App navigation → Login and registration: renders
frontend/App.tsx - App navigation → Authenticated home: renders
frontend/App.tsx - App navigation → Notification experience: provides
frontend/App.tsx - Login and registration → API client: requests via
- Authenticated home → Trip discovery and management: offers
- Trip discovery and management → API client: requests via
- Driver trip setup → Local driver state: reads and updates
frontend/src/screens/DriverRouteSetupScreen.tsx - API client → Express API: HTTPS JSON
README.md - Express API → Auth and profile routes: mounts
backend/src/app.js - Express API → Vehicle management: mounts
backend/src/app.js - Express API → Trips and routes: mounts
backend/src/app.js - Express API → Reservations: mounts
backend/src/app.js - Express API → Notifications: mounts
backend/src/app.js - Express API → Community impact: mounts
backend/src/app.js - Auth and profile routes → Authentication service: dispatches
backend/src/modules/auth/auth.routes.js - Authentication service → Account repository: calls
backend/src/modules/auth/auth.service.js - Authentication service → Catalogs: loads registration context
backend/src/modules/auth/auth.service.js - Authentication service → Email delivery: sends account email
backend/src/modules/auth/auth.service.js - Authentication service → Document storage: stores documents
backend/src/modules/auth/auth.service.js - Catalogs → Database pool: queries
backend/src/modules/catalogos/catalogos.service.js - Database pool → Neon PostgreSQL: connects
README.md - Email delivery → SMTP email: delivers through
README.md - Document storage → Cloudinary files: stores files
README.md - Vehicle management → Database pool: persists through
- Trips and routes → Database pool: persists through
- Reservations → Database pool: persists through
- Notifications → Database pool: persists through
- Community impact → Database pool: queries
backend/src/modules/impacto/impacto.routes.js