How edselrenz/itinerary-app works
Nueva Ecija Travel Itinerary is a travel-planning product with Angular and native Python desktop clients backed by a FastAPI service. Travelers can sign in or use guest mode, discover places, build custom or suggested itineraries, and view saved plans. The desktop source index exposes client-to-service dependencies and offline fallbacks; the README documents the REST API and desktop role. Backend itinerary and place internals were not sampled, so those components are shown without speculative internal call chains.
Main entry points: services Client Services · app.routes.ts App Routes · desktop_client/main.py Desktop App · app/main.py FastAPI Service
Components 23
Angular Client
- Web App
Project/src/main.ts - App Routes
Project/src/app/app.routes.ts - Auth Screens
Project/src/app/features/auth - Itinerary Builder
Project/src/app/features/itinerary - Travel Tabs
Project/src/app/tabs
Desktop Client
- Desktop App
desktop_client/main.py - Trip Builder
desktop_client/views/custom_builder_view.py - Suggested Wizard
desktop_client/views/suggested_wizard_view.py - Places View
desktop_client/views/places_view.py - Client Services
desktop_client/services - HTTP Client
desktop_client/core/api_client.py - Trip Models
desktop_client/models/itinerary.py - Place Models
desktop_client/models/place.py
Backend API
- FastAPI Service
backend/app/main.py - Auth Routes
backend/app/api/v1/auth.py - Itinerary Routes
backend/app/api/v1/itineraries.py - Place Routes
backend/app/api/v1/places.py - Auth Service
backend/app/services/auth_service.py
Persistence and Discovery
- Guest Storage
desktop_client/core/storage.py - Offline Places
desktop_client/core/offline_data.py - Database
backend/app/core/database.py
Other components
- Traveler
- Google Maps
Connections 24
- Traveler → Web App: uses
- Web App → App Routes: loads routes
Project/src/main.ts - App Routes → Auth Screens: routes to
Project/src/app/app.routes.ts - App Routes → Itinerary Builder: routes to
Project/src/app/app.routes.ts - App Routes → Travel Tabs: loads tabs
Project/src/app/app.routes.ts - Traveler → Desktop App: uses
- Desktop App → Trip Builder: loads view
desktop_client/main.py - Desktop App → Suggested Wizard: loads view
desktop_client/main.py - Desktop App → Places View: loads view
desktop_client/main.py - Trip Builder → Client Services: uses services
desktop_client/views/custom_builder_view.py - Suggested Wizard → Client Services: uses services
desktop_client/views/suggested_wizard_view.py - Places View → Client Services: uses services
desktop_client/views/places_view.py - Client Services → HTTP Client: sends requests
desktop_client/services/itinerary_service.py - Client Services → Trip Models: uses models
desktop_client/services/itinerary_service.py - Client Services → Place Models: uses models
desktop_client/services/place_service.py - Client Services → Offline Places: falls back to
desktop_client/services/place_service.py - Client Services → Guest Storage: persists guest trips
desktop_client/core/storage.py - HTTP Client → FastAPI Service: calls REST API
- FastAPI Service → Auth Routes: registers routes
backend/app/main.py - FastAPI Service → Itinerary Routes: registers routes
backend/app/main.py - FastAPI Service → Place Routes: registers routes
backend/app/main.py - Auth Routes → Auth Service: calls
backend/app/api/v1/auth.py - Auth Service → Database: uses sessions
backend/app/services/auth_service.py - Place Routes → Google Maps: may use mapping