# violetcoode/noticeiq architecture

> Architecture diagram of the GitHub repository violetcoode/noticeiq, 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/violetcoode/noticeiq
- Repository: https://github.com/violetcoode/noticeiq

## Overview

NoticeIQ is a campus information and student-task application. The main user workflow is authentication, capturing a notice, AI-assisted extraction into structured tasks, and viewing or updating those tasks in the dashboard. The app also exposes calendar, analytics, campus identity, and document-vault features, plus Gmail and push-notification integrations. Edges reflect shown calls or README claims; several screens and backend functions are indexed but not excerpted, so their internal wiring is not inferred.

Main entry points: [`src/services/supabase.js`](https://github.com/violetcoode/noticeiq/blob/main/src/services/supabase.js) (Supabase access), [`src/App.jsx`](https://github.com/violetcoode/noticeiq/blob/main/src/App.jsx) (App shell), [`src/screens/Dashboard.jsx`](https://github.com/violetcoode/noticeiq/blob/main/src/screens/Dashboard.jsx) (Task dashboard), [`src/services/gemini.js`](https://github.com/violetcoode/noticeiq/blob/main/src/services/gemini.js) (Notice extraction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["App shell<br/>[App.jsx]"]
  node_auth["Authentication<br/>[AuthScreen.jsx]"]
end

subgraph group_workflow["Notice Workflow"]
  node_capture["Notice capture<br/>[Capture.jsx]"]
  node_tasks["Task dashboard<br/>[Dashboard.jsx]"]
  node_task_views["Task views<br/>[TaskCard.jsx]"]
  node_calendar["Calendar<br/>[CalendarScreen.jsx]"]
  node_analytics["Analytics"]
  node_search["Search<br/>[SearchModal.jsx]"]
end

subgraph group_services["Services and Data"]
  node_extract["Notice extraction<br/>[gemini.js]"]
  node_groq["Groq fallback<br/>[groq.js]"]
  node_gmail["Gmail integration<br/>[gmail.js]"]
  node_notifications["Push notifications<br/>[notifications.js]"]
  node_supabase_client["Supabase access<br/>[supabase.js]"]
  node_database[("Supabase backend")]
  node_date_utils["Date utilities<br/>[dateUtils.js]"]
  node_security["Input security<br/>[securityUtils.js]"]
  node_edge_extract["Edge notice extraction<br/>[index.ts]"]
  node_edge_gmail["Gmail sync<br/>[index.ts]"]
  node_edge_alerts["Alert checks<br/>[index.ts]"]
  node_edge_reminders["Reminder checks<br/>[index.ts]"]
end

subgraph group_campus["Campus Features"]
  node_vault["Campus vault<br/>[CampusVault.jsx]"]
  node_student_id["Digital student ID"]
  node_room_finder["Room finder<br/>[RoomFinder.jsx]"]
  node_public_verify["Public ID verification"]
end

node_user(("Student or staff"))

node_user -->|"signs in"| node_auth
node_user -->|"submits notice"| node_capture
node_capture -->|"extracts notice"| node_extract
node_extract -->|"uses fallback"| node_groq
node_extract -->|"invokes function"| node_edge_extract
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_tasks
node_app -->|"renders"| node_vault
node_app -->|"creates notice"| node_supabase_client
node_app -->|"exchanges OAuth code"| node_gmail
node_tasks -->|"updates tasks"| node_supabase_client
node_tasks -->|"renders task views"| node_task_views
node_tasks -->|"checks connection"| node_gmail
node_tasks -->|"registers alerts"| node_notifications
node_search -->|"formats deadlines"| node_date_utils
node_supabase_client -->|"reads and writes"| node_database
node_notifications -->|"saves subscription"| node_supabase_client
node_auth -->|"authenticates"| node_supabase_client
node_vault -->|"renders identity"| node_student_id
node_vault -->|"renders finder"| node_room_finder
node_student_id -->|"loads profile and photo"| node_supabase_client
node_public_verify -->|"verifies identity"| node_supabase_client
node_capture -->|"sanitizes input"| node_security
node_extract -->|"sanitizes notice"| node_security
node_supabase_client -->|"parses deadlines"| node_date_utils
node_edge_gmail -.->|"syncs mail data"| node_database
node_edge_alerts -.->|"checks alert data"| node_database
node_edge_reminders -.->|"checks reminders"| node_database
node_user -->|"searches notices"| node_search
node_user -->|"reviews schedule"| node_calendar
node_user -->|"views insights"| node_analytics

click node_app "https://github.com/violetcoode/noticeiq/blob/main/src/App.jsx"
click node_auth "https://github.com/violetcoode/noticeiq/blob/main/src/screens/AuthScreen.jsx"
click node_capture "https://github.com/violetcoode/noticeiq/blob/main/src/screens/Capture.jsx"
click node_extract "https://github.com/violetcoode/noticeiq/blob/main/src/services/gemini.js"
click node_groq "https://github.com/violetcoode/noticeiq/blob/main/src/services/groq.js"
click node_tasks "https://github.com/violetcoode/noticeiq/blob/main/src/screens/Dashboard.jsx"
click node_task_views "https://github.com/violetcoode/noticeiq/blob/main/src/components/TaskCard.jsx"
click node_calendar "https://github.com/violetcoode/noticeiq/blob/main/src/screens/CalendarScreen.jsx"
click node_analytics "https://github.com/violetcoode/noticeiq/blob/main/src/screens/AnalyticsScreen.jsx"
click node_search "https://github.com/violetcoode/noticeiq/blob/main/src/components/SearchModal.jsx"
click node_gmail "https://github.com/violetcoode/noticeiq/blob/main/src/services/gmail.js"
click node_notifications "https://github.com/violetcoode/noticeiq/blob/main/src/services/notifications.js"
click node_supabase_client "https://github.com/violetcoode/noticeiq/blob/main/src/services/supabase.js"
click node_vault "https://github.com/violetcoode/noticeiq/blob/main/src/screens/CampusVault.jsx"
click node_student_id "https://github.com/violetcoode/noticeiq/blob/main/src/components/DigitalStudentId.jsx"
click node_room_finder "https://github.com/violetcoode/noticeiq/blob/main/src/components/RoomFinder.jsx"
click node_public_verify "https://github.com/violetcoode/noticeiq/blob/main/src/components/PublicVerifyScreen.jsx"
click node_date_utils "https://github.com/violetcoode/noticeiq/blob/main/src/utils/dateUtils.js"
click node_security "https://github.com/violetcoode/noticeiq/blob/main/src/utils/securityUtils.js"
click node_edge_extract "https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/extract-notice/index.ts"
click node_edge_gmail "https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/gmail-sync/index.ts"
click node_edge_alerts "https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/check-alerts/index.ts"
click node_edge_reminders "https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/check-reminders/index.ts"

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_app,node_auth toneBlue
class node_capture,node_tasks,node_task_views,node_calendar,node_analytics,node_search toneAmber
class node_extract,node_groq,node_gmail,node_notifications,node_supabase_client,node_database,node_date_utils,node_security,node_edge_extract,node_edge_gmail,node_edge_alerts,node_edge_reminders toneMint
class node_vault,node_student_id,node_room_finder,node_public_verify toneRose
class node_user toneIndigo
```

## Components

### Application

- [App shell](https://github.com/violetcoode/noticeiq/blob/main/src/App.jsx): `src/App.jsx`
- [Authentication](https://github.com/violetcoode/noticeiq/blob/main/src/screens/AuthScreen.jsx): `src/screens/AuthScreen.jsx`

### Notice Workflow

- [Notice capture](https://github.com/violetcoode/noticeiq/blob/main/src/screens/Capture.jsx): `src/screens/Capture.jsx`
- [Task dashboard](https://github.com/violetcoode/noticeiq/blob/main/src/screens/Dashboard.jsx): `src/screens/Dashboard.jsx`
- [Task views](https://github.com/violetcoode/noticeiq/blob/main/src/components/TaskCard.jsx): `src/components/TaskCard.jsx`
- [Calendar](https://github.com/violetcoode/noticeiq/blob/main/src/screens/CalendarScreen.jsx): `src/screens/CalendarScreen.jsx`
- [Analytics](https://github.com/violetcoode/noticeiq/blob/main/src/screens/AnalyticsScreen.jsx): `src/screens/AnalyticsScreen.jsx`
- [Search](https://github.com/violetcoode/noticeiq/blob/main/src/components/SearchModal.jsx): `src/components/SearchModal.jsx`

### Services and Data

- [Notice extraction](https://github.com/violetcoode/noticeiq/blob/main/src/services/gemini.js): `src/services/gemini.js`
- [Groq fallback](https://github.com/violetcoode/noticeiq/blob/main/src/services/groq.js): `src/services/groq.js`
- [Gmail integration](https://github.com/violetcoode/noticeiq/blob/main/src/services/gmail.js): `src/services/gmail.js`
- [Push notifications](https://github.com/violetcoode/noticeiq/blob/main/src/services/notifications.js): `src/services/notifications.js`
- [Supabase access](https://github.com/violetcoode/noticeiq/blob/main/src/services/supabase.js): `src/services/supabase.js`
- **Supabase backend**
- [Date utilities](https://github.com/violetcoode/noticeiq/blob/main/src/utils/dateUtils.js): `src/utils/dateUtils.js`
- [Input security](https://github.com/violetcoode/noticeiq/blob/main/src/utils/securityUtils.js): `src/utils/securityUtils.js`
- [Edge notice extraction](https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/extract-notice/index.ts): `supabase/functions/extract-notice/index.ts`
- [Gmail sync](https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/gmail-sync/index.ts): `supabase/functions/gmail-sync/index.ts`
- [Alert checks](https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/check-alerts/index.ts): `supabase/functions/check-alerts/index.ts`
- [Reminder checks](https://github.com/violetcoode/noticeiq/blob/main/supabase/functions/check-reminders/index.ts): `supabase/functions/check-reminders/index.ts`

### Campus Features

- [Campus vault](https://github.com/violetcoode/noticeiq/blob/main/src/screens/CampusVault.jsx): `src/screens/CampusVault.jsx`
- [Digital student ID](https://github.com/violetcoode/noticeiq/blob/main/src/components/DigitalStudentId.jsx): `src/components/DigitalStudentId.jsx`
- [Room finder](https://github.com/violetcoode/noticeiq/blob/main/src/components/RoomFinder.jsx): `src/components/RoomFinder.jsx`
- [Public ID verification](https://github.com/violetcoode/noticeiq/blob/main/src/components/PublicVerifyScreen.jsx): `src/components/PublicVerifyScreen.jsx`

### Other components

- **Student or staff**

## Connections

- Student or staff → Authentication: signs in (evidence: `src/screens/AuthScreen.jsx`)
- Student or staff → Notice capture: submits notice (evidence: `README.md`)
- Notice capture → Notice extraction: extracts notice (evidence: `src/services/gemini.js`)
- Notice extraction → Groq fallback: uses fallback (evidence: `src/services/gemini.js`)
- Notice extraction → Edge notice extraction: invokes function (evidence: `src/services/gemini.js`)
- App shell → Authentication: renders (evidence: `src/App.jsx`)
- App shell → Task dashboard: renders (evidence: `src/App.jsx`)
- App shell → Campus vault: renders (evidence: `src/App.jsx`)
- App shell → Supabase access: creates notice (evidence: `src/App.jsx`)
- App shell → Gmail integration: exchanges OAuth code (evidence: `src/App.jsx`)
- Task dashboard → Supabase access: updates tasks (evidence: `src/screens/Dashboard.jsx`)
- Task dashboard → Task views: renders task views (evidence: `src/screens/Dashboard.jsx`)
- Task dashboard → Gmail integration: checks connection (evidence: `src/screens/Dashboard.jsx`)
- Task dashboard → Push notifications: registers alerts (evidence: `src/screens/Dashboard.jsx`)
- Search → Date utilities: formats deadlines (evidence: `src/components/SearchModal.jsx`)
- Supabase access → Supabase backend: reads and writes (evidence: `src/services/supabase.js`)
- Push notifications → Supabase access: saves subscription (evidence: `src/services/notifications.js`)
- Authentication → Supabase access: authenticates (evidence: `src/screens/AuthScreen.jsx`)
- Campus vault → Digital student ID: renders identity (evidence: `src/screens/CampusVault.jsx`)
- Campus vault → Room finder: renders finder (evidence: `src/screens/CampusVault.jsx`)
- Digital student ID → Supabase access: loads profile and photo (evidence: `src/components/DigitalStudentId.jsx`)
- Public ID verification → Supabase access: verifies identity (evidence: `src/components/PublicVerifyScreen.jsx`)
- Notice capture → Input security: sanitizes input (evidence: `src/screens/Capture.jsx`)
- Notice extraction → Input security: sanitizes notice (evidence: `src/services/gemini.js`)
- Supabase access → Date utilities: parses deadlines (evidence: `src/services/supabase.js`)
- Gmail sync → Supabase backend: syncs mail data
- Alert checks → Supabase backend: checks alert data
- Reminder checks → Supabase backend: checks reminders
- Student or staff → Search: searches notices (evidence: `README.md`)
- Student or staff → Calendar: reviews schedule (evidence: `README.md`)
- Student or staff → Analytics: views insights (evidence: `README.md`)
