# vishnu-deepan/geolocation-attendance architecture

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

- Interactive diagram: https://gitdiagram.com/vishnu-deepan/geolocation-attendance
- Repository: https://github.com/vishnu-deepan/geolocation-attendance

## Overview

##### Project type and purpose
- This is a full-stack, cross-platform Flutter application (“Geolocation-Based Attendance Management System”) with native Android/iOS/Web/Desktop front-ends that use Firebase backend services to authenticate users, store attendance records, and perform geolocation-based check-ins.

##### File structure
- Top-level “android”, “ios”, “web”, “linux”, “macos”, “windows” directories each hold platform-specific builds and native code generated by Flutter.
- The “lib” directory contains Dart code:
- lib/screens – UI pages (login, signup, home/dashboard, manual check-in, working hours, history)
- lib/service – LocationService (handles geolocation logic)
- lib/main.dart – entry point
- dataconnect & dataconnect-generated – GraphQL connector definitions and generated Dart stubs (optional data-access layer).
- Firebase config & rules files (firebase.json, firestore.rules, database.rules.json).
- Pubspec.yaml lists dependencies: firebase_core, firebase_auth, cloud_firestore (or realtime_database).

##### README
- Confirms use of Firebase Authentication for login/signup, Firebase Realtime Database (or Firestore) for attendance data, and native geolocation services for automatic/manual check-ins.
- Lists core features: secure auth, real-time data sync, auto/manual check-in, attendance history, working hours calculation.

##### Elements
- Rectangles for components (UI, services)
- Parallelograms for external APIs/plugins
- Clouds for backend services (Firebase)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Side
    subgraph "Client Side (Flutter)"
        direction TB
        MainDart["main.dart"]:::entry
        subgraph "Presentation Layer"
            direction TB
            LoginPage["LoginPage"]:::presentation
            SignupPage["SignupPage"]:::presentation
            HomePage["Home/Dashboard"]:::presentation
            ManualCheckIn["Manual Check-In"]:::presentation
            AttendanceHistory["Attendance History"]:::presentation
            WorkingHours["Working Hours"]:::presentation
        end
        subgraph "Service Layer"
            direction TB
            LocationService["LocationService"]:::service
        end
        subgraph "Plugin Interfaces"
            direction TB
            AuthPlugin["firebase_auth"]:::plugin
            FirestorePlugin["cloud_firestore"]:::plugin
            RealtimeDBPlugin["firebase_database"]:::plugin
            GeolocatorPlugin["geolocator"]:::plugin
        end
    end

    %% Native Platform Services
    subgraph "Native Platform Services"
        direction TB
        subgraph "Android"
            MainActivity["MainActivity.java"]:::native
            AndroidManifest["AndroidManifest.xml"]:::native
            GoogleServices["google-services.json"]:::native
        end
        subgraph "iOS"
            AppDelegate["AppDelegate.swift"]:::native
            InfoPlist["Info.plist"]:::native
        end
        subgraph "Web"
            WebGeo["Web Geolocation API"]:::native
        end
        subgraph "Linux"
            LinuxMain["main.cc"]:::native
            LinuxPluginReg["generated_plugin_registrant.cc"]:::native
        end
        subgraph "macOS"
            MacMain["MainFlutterWindow.swift"]:::native
            MacPluginReg["GeneratedPluginRegistrant.swift"]:::native
        end
        subgraph "Windows"
            WinMain["main.cpp"]:::native
            WinPluginReg["generated_plugin_registrant.cc"]:::native
        end
    end

    %% Cloud Side
    subgraph "Cloud Side (Firebase)"
        direction TB
        FirebaseAuth["Firebase Authentication"]:::cloud
        FirebaseDB["Realtime Database / Firestore"]:::db
        CloudFunctions["Cloud Functions (optional)"]:::cloud
        subgraph "GraphQL Data Connector (Optional)"
            Schema["schema.gql"]:::connector
            ConnectorConfig["connector.yaml"]:::connector
            Mutations["mutations.gql"]:::connector
            Queries["queries.gql"]:::connector
            GeneratedStubs["default.dart"]:::connector
        end
    end

    %% Flows
    MainDart -->|launches| LoginPage
    MainDart --> SignupPage
    MainDart --> HomePage
    MainDart --> ManualCheckIn
    MainDart --> AttendanceHistory
    MainDart --> WorkingHours

    LoginPage -->|uses| LocationService
    SignupPage -->|uses| LocationService
    HomePage -->|uses| LocationService
    ManualCheckIn -->|uses| LocationService
    AttendanceHistory -->|uses| LocationService
    WorkingHours -->|uses| LocationService

    LocationService -->|auth| AuthPlugin
    LocationService -->|read/write data| FirestorePlugin
    LocationService -->|read/write data| RealtimeDBPlugin
    LocationService -->|get coords| GeolocatorPlugin

    AuthPlugin -->|calls| FirebaseAuth
    FirestorePlugin -->|calls| FirebaseDB
    RealtimeDBPlugin -->|calls| FirebaseDB
    FirebaseAuth -->|issues token| LocationService
    FirebaseDB -->|streams updates| HomePage
    FirebaseDB -->|streams updates| AttendanceHistory
    FirebaseDB -->|streams updates| WorkingHours

    GeolocatorPlugin --> AndroidLocation["Android Location APIs"] 
    GeolocatorPlugin --> iOSLocation["iOS Core Location"]
    GeolocatorPlugin --> WebGeo
    GeolocatorPlugin --> LinuxMain
    GeolocatorPlugin --> MacMain
    GeolocatorPlugin --> WinMain

    CloudFunctions -->|optional triggers| FirebaseDB
    Schema -->|defines| GeneratedStubs
    ConnectorConfig -->|configures| GeneratedStubs
    Mutations -->|used by| GeneratedStubs
    Queries -->|used by| GeneratedStubs

    %% Click Events
    click MainDart "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/main.dart"
    click LoginPage "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/login_page.dart"
    click SignupPage "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/signup_page.dart"
    click HomePage "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/home_page.dart"
    click ManualCheckIn "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/manual_check_in.dart"
    click AttendanceHistory "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/attendance_history.dart"
    click WorkingHours "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/working_hours.dart"
    click WorkingHours "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/screens/work_hours_page.dart"
    click LocationService "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/lib/service/location_service.dart"
    click MainActivity "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/android/app/src/main/java/com/example/geolocation_attendance/MainActivity.java"
    click AndroidManifest "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/android/app/src/main/AndroidManifest.xml"
    click GoogleServices "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/android/app/google-services.json"
    click AppDelegate "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/ios/Runner/AppDelegate.swift"
    click InfoPlist "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/ios/Runner/Info.plist"
    click LinuxMain "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/linux/main.cc"
    click LinuxPluginReg "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/linux/flutter/generated_plugin_registrant.cc"
    click MacMain "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/macos/Runner/MainFlutterWindow.swift"
    click MacPluginReg "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"
    click WinMain "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/windows/runner/main.cpp"
    click WinPluginReg "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/windows/flutter/generated_plugin_registrant.cc"
    click Schema "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/dataconnect/schema/schema.gql"
    click ConnectorConfig "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/dataconnect/connector/connector.yaml"
    click Mutations "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/dataconnect/connector/mutations.gql"
    click Queries "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/dataconnect/connector/queries.gql"
    click GeneratedStubs "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/dataconnect-generated/dart/default_connector/default.dart"
    click firebaseConfig "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/firebase.json"
    click Rules1 "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/firestore.rules"
    click Rules2 "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/database.rules.json"
    click Indexes "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/firestore.indexes.json"
    click RC "https://github.com/vishnu-deepan/geolocation-attendance/blob/main/.firebaserc"

    %% Styles
    classDef entry fill:#FFD580,stroke:#333,stroke-width:1px
    classDef presentation fill:#A3D5FF,stroke:#333,stroke-width:1px
    classDef service fill:#FFC0CB,stroke:#333,stroke-width:1px
    classDef plugin fill:#D5A6BD,stroke:#333,stroke-width:1px
    classDef native fill:#C2D69B,stroke:#333,stroke-width:1px
    classDef cloud fill:#B7E4C7,stroke:#333,stroke-width:1px
    classDef db fill:#FFB347,stroke:#333,stroke-width:1px
    classDef connector fill:#E6E6FA,stroke:#333,stroke-width:1px
```
