# muraripothuru/-avit-campus-plus architecture

> Architecture diagram of the GitHub repository muraripothuru/-avit-campus-plus, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muraripothuru/-avit-campus-plus
- Repository: https://github.com/muraripothuru/-avit-campus-plus

## Overview

AVIT Campus+ is a Flutter campus super-app for students and campus staff. Users enter through the authentication flow, then use role-oriented navigation to reach campus services, academics, safety, and staff capabilities. The documented architecture places feature screens above app composition and data repositories, with shared core services and widgets. The README describes API-backed and offline demo modes, secure token storage, and role-specific functions. Dart implementation files were not sampled, so the graph keeps internal connections to documented relationships and omits unverified calls.

Main entry points: [`lib/data/repositories`](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/data/repositories) (Data repositories), [`lib/main.dart`](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/main.dart) (App entry and router), [`lib/app`](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/app) (App state and scope), [`lib/navigation/app_shell.dart`](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/navigation/app_shell.dart) (App navigation shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App foundation"]
  node_entry["App entry and router<br/>[main.dart]"]
  node_appstate["App state and scope"]
  node_core["Core services"]
end

subgraph group_data["Data access"]
  node_repositories["Data repositories"]
  node_api["REST API client<br/>[api_client.dart]"]
  node_demo["Demo catalog<br/>[demo_catalog.dart]"]
  node_securestore[("Secure token storage<br/>[token_manager.dart]")]
end

subgraph group_student["Student features"]
  node_auth["Authentication"]
  node_dashboard["Dashboard"]
  node_campus["Campus services"]
  node_academics["Academics"]
  node_profile["Profile and account"]
  node_safety["Safety and incidents"]
end

subgraph group_staff["Staff operations"]
  node_security["Security tools"]
  node_warden["Warden tools"]
  node_admin["Admin tools"]
end

subgraph group_shared["Shared interface"]
  node_shell["App navigation shell<br/>[app_shell.dart]"]
  node_catalog["Service catalog"]
  node_widgets["Shared UI components"]
end

node_user(("Campus user"))

node_user -->|"opens app"| node_entry
node_entry -->|"guards routes"| node_auth
node_entry -->|"composes app"| node_appstate
node_user -->|"navigates by role"| node_shell
node_shell -->|"offers services"| node_catalog
node_shell -->|"uses shared UI"| node_widgets
node_appstate -->|"connects data layer"| node_repositories
node_repositories -->|"uses when configured"| node_api
node_repositories -->|"uses offline mode"| node_demo
node_appstate -->|"uses core layer"| node_core
node_user -->|"views role dashboard"| node_dashboard
node_user -->|"uses campus services"| node_campus
node_user -->|"uses academics"| node_academics
node_user -->|"manages account"| node_profile
node_user -->|"requests help"| node_safety
node_user -->|"uses security desk"| node_security
node_user -->|"uses warden desk"| node_warden
node_user -->|"uses admin tools"| node_admin
node_repositories -->|"stores tokens"| node_securestore

click node_entry "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/main.dart"
click node_appstate "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/app"
click node_core "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/core"
click node_auth "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/auth"
click node_shell "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/navigation/app_shell.dart"
click node_catalog "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/navigation/service_catalog.dart"
click node_widgets "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/widgets"
click node_repositories "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/data/repositories"
click node_api "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/api_client.dart"
click node_demo "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/demo_catalog.dart"
click node_securestore "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/token_manager.dart"
click node_dashboard "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/dashboard/dashboard_screen.dart"
click node_campus "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/campus_services"
click node_academics "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/academics"
click node_profile "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/account"
click node_safety "https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/safety"
click node_security "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/security_dashboard_screen.dart"
click node_warden "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/warden_dashboard_screen.dart"
click node_admin "https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/admin_dashboard_screen.dart"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_appstate,node_core,node_user toneBlue
class node_repositories,node_api,node_demo,node_securestore toneAmber
class node_auth,node_dashboard,node_campus,node_academics,node_profile,node_safety toneMint
class node_security,node_warden,node_admin toneRose
class node_shell,node_catalog,node_widgets toneIndigo
```

## Components

### App foundation

- [App entry and router](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/main.dart): `lib/main.dart`
- [App state and scope](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/app): `lib/app`
- [Core services](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/core): `lib/core`

### Data access

- [Data repositories](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/data/repositories): `lib/data/repositories`
- [REST API client](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/api_client.dart): `lib/data/datasources/api_client.dart`
- [Demo catalog](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/demo_catalog.dart): `lib/data/datasources/demo_catalog.dart`
- [Secure token storage](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/data/datasources/token_manager.dart): `lib/data/datasources/token_manager.dart`

### Student features

- [Authentication](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/auth): `lib/features/auth`
- [Dashboard](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/dashboard/dashboard_screen.dart): `lib/features/dashboard/dashboard_screen.dart`
- [Campus services](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/campus_services): `lib/features/campus_services`
- [Academics](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/academics): `lib/features/academics`
- [Profile and account](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/account): `lib/features/account`
- [Safety and incidents](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/features/safety): `lib/features/safety`

### Staff operations

- [Security tools](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/security_dashboard_screen.dart): `lib/features/staff/security_dashboard_screen.dart`
- [Warden tools](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/warden_dashboard_screen.dart): `lib/features/staff/warden_dashboard_screen.dart`
- [Admin tools](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/features/staff/admin_dashboard_screen.dart): `lib/features/staff/admin_dashboard_screen.dart`

### Shared interface

- [App navigation shell](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/navigation/app_shell.dart): `lib/navigation/app_shell.dart`
- [Service catalog](https://github.com/muraripothuru/-avit-campus-plus/blob/main/lib/navigation/service_catalog.dart): `lib/navigation/service_catalog.dart`
- [Shared UI components](https://github.com/muraripothuru/-avit-campus-plus/tree/main/lib/widgets): `lib/widgets`

### Other components

- **Campus user**

## Connections

- Campus user → App entry and router: opens app (evidence: `README.md`)
- App entry and router → Authentication: guards routes (evidence: `README.md`)
- App entry and router → App state and scope: composes app (evidence: `README.md`)
- Campus user → App navigation shell: navigates by role (evidence: `README.md`)
- App navigation shell → Service catalog: offers services (evidence: `README.md`)
- App navigation shell → Shared UI components: uses shared UI (evidence: `README.md`)
- App state and scope → Data repositories: connects data layer (evidence: `README.md`)
- Data repositories → REST API client: uses when configured (evidence: `README.md`)
- Data repositories → Demo catalog: uses offline mode (evidence: `README.md`)
- App state and scope → Core services: uses core layer (evidence: `README.md`)
- Campus user → Dashboard: views role dashboard (evidence: `README.md`)
- Campus user → Campus services: uses campus services (evidence: `README.md`)
- Campus user → Academics: uses academics (evidence: `README.md`)
- Campus user → Profile and account: manages account (evidence: `README.md`)
- Campus user → Safety and incidents: requests help (evidence: `README.md`)
- Campus user → Security tools: uses security desk (evidence: `README.md`)
- Campus user → Warden tools: uses warden desk (evidence: `README.md`)
- Campus user → Admin tools: uses admin tools (evidence: `README.md`)
- Data repositories → Secure token storage: stores tokens (evidence: `README.md`)
