How arianablanco06/treksafe works
TrekSafe is a hiking-expedition planning and rescue-coordination platform. Hikers plan trips, prepare routes and equipment, track progress, and confirm their return; overdue trips trigger alerts for rescuers to coordinate, document, and close an incident. The frontend is a PWA, while the backend separates HTTP handling from a worker that monitors deadlines and processes a persistent notification queue. The README documents the product workflow and deployment; sampled sources confirm selected entry-point, composition, and outbox links, but most feature-level backend calls were not sampled.
Main entry points: arranque.ts Worker composition · PaginaCrearExpedicion.tsx Trip planning · PaginaConsolaRescate.tsx Rescue console · WorkerOutboxNotificaciones.ts Outbox processor
Components 23
PWA and planning
- TrekSafe PWA
frontend/src/app/App.tsx - Trip planning
frontend/src/pages/PaginaCrearExpedicion.tsx - Offline drafts
frontend/src/lib/offlineStorage.ts - API client
frontend/src/services/clienteApi.ts
HTTP and application
- API entry
backend/src/api.ts - HTTP app
backend/src/presentation/http/app.ts - Feature routes
backend/src/presentation/http/routes - Expedition services
backend/src/application/services/servicioExpedicion.ts
Rescue operations
- Rescue console
frontend/src/pages/PaginaConsolaRescate.tsx - Incident coordination
backend/src/application/use-cases/AsignarResponsable.ts - Incident records
backend/src/application/use-cases/AgregarEntradaBitacora.ts - Reports and stats
backend/src/application/use-cases/ExportarReporteIncidentes.ts
Worker and integrations
- Worker entry
backend/src/worker.ts - Worker composition
backend/src/infrastructure/composicion/arranque.ts - Deadline jobs
backend/src/infrastructure/jobs/cronFechaLimiteExpedicion.ts - Outbox processor
backend/src/application/services/WorkerOutboxNotificaciones.ts - Notification outbox
backend/src/infrastructure/repositories/RepositorioOutboxSupabase.ts - Email transport
backend/src/infrastructure/email/ServicioCorreo.ts - Worker health state
backend/src/infrastructure/repositories/EstadoWorkerSupabase.ts
Other components
- Hiker
- Rescuer
- Emergency contacts
- Supabase PostgreSQL
backend/src/infrastructure/database/supabase.ts
Connections 26
- Hiker → TrekSafe PWA: uses
- Rescuer → TrekSafe PWA: uses
- TrekSafe PWA → Trip planning: offers
- Trip planning → Offline drafts: supports drafts
- Trip planning → API client: submits changes
- API client → API entry: calls REST
- API entry → Worker composition: composes
backend/src/api.ts - Worker composition → HTTP app: creates app
backend/src/infrastructure/composicion/arranque.ts - HTTP app → Feature routes: mounts routes
backend/src/presentation/http/app.ts - Feature routes → Expedition services: handles trip operations
- Hiker → Trip planning: plans expedition
- Trip planning → Deadline jobs: sets return deadline
- Deadline jobs → Rescue console: raises overdue alert
- Rescuer → Rescue console: reviews alerts
- Rescue console → Incident coordination: coordinates response
- Rescue console → Incident records: records incident
- Rescue console → Reports and stats: views reports
- Worker entry → Worker composition: starts worker
backend/src/worker.ts - Worker composition → Deadline jobs: starts tasks
backend/src/infrastructure/composicion/arranque.ts - Worker composition → Outbox processor: creates processor
backend/src/infrastructure/composicion/arranque.ts - Outbox processor → Notification outbox: leases and records
backend/src/application/services/WorkerOutboxNotificaciones.ts - Outbox processor → Email transport: sends messages
backend/src/application/services/WorkerOutboxNotificaciones.ts - Emergency contacts → Email transport: receives alerts
- Worker composition → Worker health state: records worker status
backend/src/infrastructure/composicion/arranque.ts - Worker health state → Supabase PostgreSQL: queries availability
backend/src/infrastructure/repositories/EstadoWorkerSupabase.ts - Notification outbox → Supabase PostgreSQL: persists queue