How brayan6072/mapeogestionresiduos works
Project type and purpose
• This is a single‑page, full‑stack‑style frontend application built with Angular (v18) and deployed via Firebase.
• It handles user authentication (including Google sign‑in), displays reports (last week/month), maps, manages “tasks” and “locations,” and presents a dashboard and home views.
• Firebase acts as the backend (Auth, Firestore/Database, Hosting).
File structure
• Top‑level config: angular.json, firebase.json, .firebaserc, package.json – points to an Angular build + Firebase deployment.
• src/app is organized into feature modules:
• auth (data‑access services, UI components, feature routes)
• dashboard (features & routes)
• home (features & routes)
• task (data‑access, features, UI)
• There is a core/auth.guard, shared (layout + auth‑state service), global styles and assets under public/.
README
• Standard Angular CLI instructions; no custom backend code – confirms that Firebase is the serverless backend.
Main components & their interactions
a. Frontend (Browser / Angular SPA)
• Layout & shared UI → loads at /
• Feature modules (Auth, Home, Dashboard, Task) controlled by app.routes.ts
• Components talk to data‑access services (e.g., auth.service.ts, reportes.service.ts, task.service.ts).
b. Backend / External Services
• Firebase Authentication (email/password, Google OAuth)
• Firestore or Realtime Database (for reports, tasks, ubicaciones)
• Firebase Hosting (serves the built Angular app)
• Google Maps API (used by MapaComponent)
c. Build & Deployment
• Angular CLI build pipeline → Webpack → dist/
• Firebase CLI deploy → Hosting + Rules
Architectural patterns & design principles
• Modular design: feature modules lazy‑loaded via routes.
• Separation of concerns:
• UI components (in feature/ui folders)
• Business logic/services (data‑access folders)
• Route definitions (feature/*.routes.ts)
• Guards (core/auth.guard.ts)
• Shared module provides cross‑cutting services (auth state) and layout.
Technologies & frameworks
• Angular (Router, Modules, Services, Guards)
• Firebase (Auth, Firestore/DB, Hosting)
• Google Maps JavaScript API (in MapaComponent)
• PNPM (lockfile)
• Karma/Jasmine for unit tests