GeoFix Mobile - Project Overview 1. Introduction GeoFix Mobile is a comprehensive solution for managing urban maintenance incidents. The application bridges the gap between public citizens and professional maintenance technicians, facilitating the reporting, tracking, and resolution of issues like water leaks, road damage, or public lighting failures. 2. Target Audience The application serves two distinct user groups with tailored experiences: Public Users (Citizens): Can explore the map of reports and submit new incidents without creating an account. Professionals (Technicians): Have access to a secure dashboard to manage their assigned interventions, update their status, and track performance. 3. Core Features 3.1 Public Features (No Auth Required) Interactive Map: Visualize incidents around the user's location using tailored markers (differentiated by status/severity). Incident Reporting: A streamlined flow to report problems including: Geolocation (GPS) Photo capture (Camera/Gallery) Description and Title Severity Level List View: Alternative view to browse reported incidents. 3.2 Professional Features (Auth Required) Secure Authentication: Login and Registration screens with professional branding. Technician Dashboard: Profile: User identity and role display. Availability Toggle: Manage online/offline status. Statistics: Quick view of processed incidents, pending jobs, and average resolution time. Intervention Management: Access to assigned tasks (linked to the incident list). 4. Technical Architecture 4.1 Tech Stack Framework: React Native with Expo (Managed Workflow). Language: TypeScript for type safety and code quality. State Management: Zustand for lightweight global state (Auth, Incidents). Styling: NativeWind (TailwindCSS for React Native) for rapid, consistent UI development. Navigation: Expo Router (File-based routing). Maps: react-native-maps. 4.2 Key Design Principles "Public First": The app is open by default. Authentication is only requested when accessing professional features. Modern UI: High-standard UI components, card-based layouts, and clean typography. Permissions: On-demand requests for Location and Camera access. 5. Development Status The application is currently in Phase 8 (Polished). Navigation & Map: Complete. Reporting Flow: Complete. Professional Dashboard: Complete. Authentication (Login/Register): Complete & Redesigned. Public/Pro Separation: Verified. 6. Next Steps (Roadmap) Backend Integration: Connect to the real API (currently reusing mock/dev endpoints). Push Notifications: Alert technicians of new assignments. Offline Mode: Enable reporting and task management without network connectivity.