# infosys/sightconnect architecture

> Architecture diagram of the GitHub repository infosys/sightconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/infosys/sightconnect
- Repository: https://github.com/infosys/sightconnect

## Overview

##### Project type and purpose
– This is a cross-platform Flutter “full-stack” mobile/web client app (“SightConnect”) that connects to a set of hosted eye-care REST services. It implements a clean-architecture layering (presentation, domain, data) and uses MVVM-style state management via Riverpod/Provider.

##### High-level architectural layers
- Presentation (UI)
­– lib/main.dart, shared/router/app_router.dart, shared/widgets/, feature-specific presentation/pages & providers
­– Uses Flutter widgets and Provider to react to user input and orchestrate flows
- Domain
­– common use-cases (lib/apps/sightconnect/common/…/usecases, helpers/usecases)
­– Feature-specific use-cases (e.g. saveTriages, getAppointments, fetchReports)
­– Business-rule models and repository interfaces
- Data
­– Repositories (impl) that implement domain interfaces
­– Data sources:
· Remote via DioService (lib/services/dio_service.dart) with interceptors, token refresh, network_info
· Local via SQLite/TriageDbHelper and SharedPreferences (persistent_auth_data)
- Core Services
­– Authentication & token management, environment config (.env), file service, geocoding, Matomo logging
- Localization
­– lib/l10n/*.arb + generated app_localizations_*.dart

##### Backend & external dependencies
- Hosted REST API (BASE_URL in .env) exposing endpoints for patients, optometrists, vision-guardian, vision-technician, referrals, chatbot, FHIR, etc.
- External “Chatbot” AI service (lib/apps/sightconnect/common/chatbot/data/source/remote/chat_service.dart)
- Eye-detection & distance-detector native services (face_distance_detector_service_android/iOS)
- Third-party integration placeholders (ABDM, NHAI, Eye & Cornea Bank)

##### Database & local storage
- SQLite tables via TriageDbHelper for questionnaires & triage data
- SharedPreferences (persistent_auth_data) for auth tokens, user preferences

##### Architectural patterns & design principles
- Clean Architecture layering to decouple UI, business logic, and data sources
- Repository pattern + “data source” abstractions (remote vs local)
- MVVM-style state management via Provider classes in each feature’s presentation/providers folder
- Code generation: Freezed for immutable models, json_serializable for DTOs
- Modular feature structure: “libs/apps/sightconnect/features/{role}/{feature}”

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Presentation Layer
  subgraph "Presentation Layer" 
    direction TB
    Device["📱 Mobile/Web Client"]:::presentation
    Main["Main Entry Point\nlib/main.dart"]:::presentation
    Router["Routing\nlib/shared/router/app_router.dart"]:::presentation
    Widgets["Shared Widgets\nlib/shared/widgets/"]:::presentation
    Provider["State Management\n(Providers)"]:::presentation
  end

  %% Domain Layer
  subgraph "Domain Layer"
    direction TB
    UCBase["UseCase Base\nlib/apps/sightconnect/helpers/usecases/usecase.dart"]:::domain
    TriageUC["Triage Use-Cases\nlib/apps/sightconnect/common/triage/domain/usecases/"]:::domain
    RepoIface["Triage Repository Interface\nlib/apps/sightconnect/common/triage/domain/repositories/triage_repository.dart"]:::domain
  end

  %% Data Layer
  subgraph "Data Layer"
    direction TB
    DBImpl["Triage Repository Impl\nlib/apps/sightconnect/common/triage/data/repositories/triage_repository_impl.dart"]:::data
    subgraph "Remote Data Sources"
      direction TB
      TriageRemote["Triage Remote Source\nlib/apps/sightconnect/common/triage/data/source/remote/triage_remote_source.dart"]:::data
    end
    subgraph "Local Data Sources"
      direction TB
      TriageLocal["Triage Local Source\nlib/apps/sightconnect/common/triage/data/source/local/triage_local_source.dart"]:::data
      SQLite["SQLite Helper\nlib/apps/sightconnect/common/triage/data/source/local/triage_db_helper.dart"]:::data
      SharedPref["SharedPreferences"]:::data
    end
  end

  %% Core Services
  subgraph "Core Services"
    direction TB
    HTTP["HTTP Client & Interceptors\nlib/services/dio_service.dart"]:::core
    Auth["Auth & Token Management\nlib/services/persistent_auth_data.dart"]:::core
    Geo["Geocoding Service\nlib/services/geocoding_service.dart"]:::core
    Log["Matomo Logging\nlib/services/matomo_logger.dart"]:::core
  end

  %% External Services
  subgraph "External Services"
    direction TB
    API["Hosted REST API"]:::external
    Chatbot["Chatbot AI Service"]:::external
  end

  %% Database & Storage
  subgraph "Storage"
    direction TB
    SQLite
    SharedPref
  end

  %% Connections
  Device --> FlutterUI["Flutter Engine & UI Layer"]:::presentation
  FlutterUI --> Provider
  Main --> FlutterUI
  Router --> FlutterUI
  Widgets --> FlutterUI

  Provider --> UCBase
  Provider --> TriageUC

  TriageUC --> RepoIface
  RepoIface --> DBImpl

  DBImpl --> TriageRemote
  DBImpl --> TriageLocal

  TriageRemote --> HTTP
  HTTP --> API
  TriageRemote --> API

  TriageLocal --> SQLite
  TriageLocal --> SharedPref

  DBImpl --> Auth
  DBImpl --> Geo
  DBImpl --> Log

  UCBase --> TriageLocal
  UCBase -.-> API

  %% Click Events
  click Main "https://github.com/infosys/sightconnect/blob/main/lib/main.dart"
  click Router "https://github.com/infosys/sightconnect/blob/main/lib/shared/router/app_router.dart"
  click Widgets "https://github.com/infosys/sightconnect/tree/main/lib/shared/widgets/"
  click UCBase "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/helpers/usecases/usecase.dart"
  click TriageUC "https://github.com/infosys/sightconnect/tree/main/lib/apps/sightconnect/common/triage/domain/usecases/"
  click RepoIface "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/common/triage/domain/repositories/triage_repository.dart"
  click DBImpl "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/common/triage/data/repositories/triage_repository_impl.dart"
  click TriageRemote "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/common/triage/data/source/remote/triage_remote_source.dart"
  click TriageLocal "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/common/triage/data/source/local/triage_local_source.dart"
  click SQLite "https://github.com/infosys/sightconnect/blob/main/lib/apps/sightconnect/common/triage/data/source/local/triage_db_helper.dart"
  click HTTP "https://github.com/infosys/sightconnect/blob/main/lib/services/dio_service.dart"
  click Auth "https://github.com/infosys/sightconnect/blob/main/lib/services/persistent_auth_data.dart"
  click Geo "https://github.com/infosys/sightconnect/blob/main/lib/services/geocoding_service.dart"
  click Log "https://github.com/infosys/sightconnect/blob/main/lib/services/matomo_logger.dart"

  %% Styles
  classDef presentation fill:#cce5ff,stroke:#004085,color:#004085;
  classDef domain fill:#d4edda,stroke:#155724,color:#155724;
  classDef data fill:#fff3cd,stroke:#856404,color:#856404;
  classDef core fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
  classDef external fill:#ffeeba,stroke:#856404,color:#856404;
```
