turbo-access

As a frontend developer, I want to implement the Dashboard (v2) page based on the existing JSX design so that admins can view sync status, trigger syncs, and navigate to Logs and Settings. The page should feature the Interactive Data Exchange Dashboard with dynamic sync flow animation, hover-based insights, interactive metric cards (Last Sync Time, Pending Items, Error Logs), color-coded status indicators (green/yellow/red), and micro-interactions. Links to: Logs page, Settings (ServiceM8), Settings (Xero). Reference: Dashboard (v2) design page.

As a frontend developer, I want to implement the Logs (v2) page based on the existing JSX design so that admins can view and filter synchronization activity logs. The page should display a list of sync events with timestamps, status indicators (success/pending/error), and filtering capability for errors. Navigates from Dashboard and supports drilling down into log details. Reference: Logs (v2) design page.

As a frontend developer, I want to implement the Login (v2) page based on the existing JSX design so that admins can sign in to the platform. The page should include email/password fields, a sign-in button, and proper validation states. It connects to the Dashboard page upon successful login. Reference: Login (v2) design page.

As a frontend developer, I want to implement the Settings (v2) page based on the existing JSX design so that admins can configure integration settings for both ServiceM8 and Xero. The page should include configuration forms/sections for ServiceM8 credentials/settings and Xero credentials/settings, with save/update actions. Navigates from Dashboard. Reference: Settings (v2) design page.

As a backend developer, I want to implement a REST API endpoint (FastAPI/Python) that returns the current sync status between ServiceM8 and Xero so that the Dashboard page can display real-time sync state, last sync time, pending items count, and error counts. The API should return structured JSON with status, timestamps, and metrics in IST timezone and INR currency where applicable.

As a backend developer, I want to implement REST API endpoints (FastAPI/Python) for retrieving and filtering synchronization logs so that the Logs page can display all sync activity with support for error filtering. Endpoints should support pagination, date range filters, and status filters (success, pending, error). Timestamps must be in IST.

As a backend developer, I want to implement REST API endpoints (FastAPI/Python) for reading and updating ServiceM8 and Xero integration configuration settings so that the Settings page can persist admin-configured credentials and options. Endpoints should support GET (fetch current config) and PUT/PATCH (update config) for both ServiceM8 and Xero separately, with secure storage of credentials.

As a backend developer, I want to implement a REST API endpoint (FastAPI/Python) that triggers a data synchronization between ServiceM8 and Xero so that the admin can manually initiate syncs from the Dashboard. The endpoint should validate the request, initiate the sync process, and return an immediate status response with a job/task ID for tracking.

As a frontend developer, I want to wire the Logs page to the Sync Logs API so that real sync log data is fetched, paginated, and filterable by error status. Integrate loading states and error handling with the backend endpoints.

As a frontend developer, I want to wire the Settings page to the Integration Settings API so that admins can load their current ServiceM8 and Xero configurations, make changes, and save them via the backend. Integrate form validation, loading states, and success/error feedback.

As a backend developer, I want to integrate the ServiceM8 external API into the platform so that the sync engine can fetch and push relevant job/operational data from ServiceM8. This includes OAuth/API key authentication with ServiceM8, defining data models for the entities to be exchanged, and implementing the ServiceM8 client service layer.

As a frontend developer, I want to wire the Dashboard page to the Sync Status API and Trigger Sync API so that real-time sync data is fetched and displayed, and admins can trigger syncs from the UI. Integrate loading states, error handling, and optimistic UI updates with the backend endpoints.

As a backend developer, I want to integrate the Xero external API into the platform so that the sync engine can fetch and push relevant financial/accounting data to Xero. This includes OAuth2 authentication with Xero, defining data models for the entities to be exchanged (invoices, contacts, etc.), and implementing the Xero client service layer. Currency default: INR.

As a backend developer, I want to implement the core data synchronization engine that orchestrates data exchange between ServiceM8 and Xero so that the platform can reliably perform sync operations, handle errors, retry failures, and log all sync activities. The engine must support at least 100,000 sync operations per day and operate in IST timezone.