# alexrohith/testconfcal architecture

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

- Interactive diagram: https://gitdiagram.com/alexrohith/testconfcal
- Repository: https://github.com/alexrohith/testconfcal

## Overview

ConfCal is a conference discovery and deadline-management platform. Researchers explore and personalize a conference catalog, save events, track deadlines in a personal calendar, and manage reminders and notifications. IEEE synchronization collects, normalizes, and imports conference data; the REST API serves catalog, saved-event, recommendation, and reminder workflows. The README documents additional capabilities such as comparison and OAuth. Several frontend-to-API connections and unsampled workers are not visible in the excerpts, so those links are omitted rather than inferred.

Main entry points: [`backend/app/routers/conferences.py`](https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/conferences.py) (Conference and recommendation API), [`backend/app/routers/reminders.py`](https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/reminders.py) (Reminder and notification API), [`backend/app/database.py`](https://github.com/alexrohith/testconfcal/blob/main/backend/app/database.py) (Database access), [`backend/app/main.py`](https://github.com/alexrohith/testconfcal/blob/main/backend/app/main.py) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and tracking"]
  node_conference_routes["Conference and recommendation API<br/>[conferences.py]"]
  node_category_routes["Category API<br/>[categories.py]"]
  node_reminder_routes["Reminder and notification API<br/>[reminders.py]"]
end

subgraph group_frontend["Researcher experience"]
  node_explore["Explore conferences<br/>[ExploreBrowser.tsx]"]
  node_conference_detail["Conference details"]
  node_dashboard["Recommendations dashboard"]
  node_interest_setup["Research interests"]
  node_saved["Saved conferences<br/>[page.tsx]"]
  node_calendar["Personal calendar"]
  node_reminder_control["Reminder controls"]
  node_notifications_ui["Notification center"]
  node_oauth_callback["OAuth callback<br/>[route.ts]"]
end

subgraph group_api["API and identity"]
  node_api_app["REST API<br/>[main.py]"]
  node_auth_validation["Bearer-token validation<br/>[auth.py]"]
end

subgraph group_data["Conference data"]
  node_conference_model["Conference and reminder records<br/>[conference.py]"]
  node_db_access["Database access<br/>[database.py]"]
  node_conference_store[("PostgreSQL conference data")]
end

subgraph group_ingestion["IEEE ingestion"]
  node_ieee_sync["IEEE collection and sync<br/>[sync_ieee.py]"]
  node_normalization["Conference normalization<br/>[normalize_ieee.py]"]
  node_importer["Conference import"]
end

node_researcher(("Researcher"))
node_ieee(("IEEE conference sources"))

node_researcher -->|"discovers"| node_explore
node_researcher -->|"views recommendations"| node_dashboard
node_researcher -->|"sets interests"| node_interest_setup
node_researcher -->|"saves events"| node_saved
node_researcher -->|"tracks deadlines"| node_calendar
node_researcher -->|"sets reminders"| node_reminder_control
node_researcher -->|"views notifications"| node_notifications_ui
node_researcher -->|"authenticates"| node_oauth_callback
node_api_app -->|"registers routes"| node_conference_routes
node_api_app -->|"registers routes"| node_category_routes
node_api_app -->|"registers routes"| node_reminder_routes
node_conference_routes -->|"validates user"| node_auth_validation
node_reminder_routes -->|"validates user"| node_auth_validation
node_conference_routes -->|"queries database"| node_db_access
node_category_routes -->|"queries database"| node_db_access
node_reminder_routes -->|"queries database"| node_db_access
node_conference_model -->|"uses ORM base"| node_db_access
node_db_access -->|"opens connection"| node_conference_store
node_conference_routes -->|"queries records"| node_conference_model
node_reminder_routes -->|"queries records"| node_conference_model
node_ieee -->|"supplies records"| node_ieee_sync
node_ieee_sync -->|"normalizes records"| node_normalization
node_ieee_sync -->|"imports records"| node_importer
node_conference_store -->|"stores catalog"| node_conference_routes
node_conference_store -->|"stores reminders"| node_reminder_routes

click node_explore "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/ExploreBrowser.tsx"
click node_conference_detail "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/ConferenceDetails.tsx"
click node_dashboard "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/dashboard/DashboardExperience.tsx"
click node_interest_setup "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/onboarding/ResearchInterestOnboarding.tsx"
click node_saved "https://github.com/alexrohith/testconfcal/blob/main/frontend/app/saved/page.tsx"
click node_calendar "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/calendar/CalendarExperience.tsx"
click node_reminder_control "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/DeadlineReminderControl.tsx"
click node_notifications_ui "https://github.com/alexrohith/testconfcal/blob/main/frontend/components/layout/NotificationCenter.tsx"
click node_oauth_callback "https://github.com/alexrohith/testconfcal/blob/main/frontend/app/auth/callback/route.ts"
click node_api_app "https://github.com/alexrohith/testconfcal/blob/main/backend/app/main.py"
click node_conference_routes "https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/conferences.py"
click node_category_routes "https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/categories.py"
click node_reminder_routes "https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/reminders.py"
click node_auth_validation "https://github.com/alexrohith/testconfcal/blob/main/backend/app/auth.py"
click node_conference_model "https://github.com/alexrohith/testconfcal/blob/main/backend/app/models/conference.py"
click node_db_access "https://github.com/alexrohith/testconfcal/blob/main/backend/app/database.py"
click node_ieee_sync "https://github.com/alexrohith/testconfcal/blob/main/backend/scripts/sync_ieee.py"
click node_normalization "https://github.com/alexrohith/testconfcal/blob/main/scripts/normalize_ieee.py"
click node_importer "https://github.com/alexrohith/testconfcal/blob/main/backend/scripts/import_conferences.py"

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_conference_routes,node_category_routes,node_reminder_routes toneBlue
class node_explore,node_conference_detail,node_dashboard,node_interest_setup,node_saved,node_calendar,node_reminder_control,node_notifications_ui,node_oauth_callback toneAmber
class node_api_app,node_auth_validation toneMint
class node_conference_model,node_db_access,node_conference_store toneRose
class node_ieee_sync,node_normalization,node_importer,node_researcher,node_ieee toneIndigo
```

## Components

### Discovery and tracking

- [Conference and recommendation API](https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/conferences.py): `backend/app/routers/conferences.py`
- [Category API](https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/categories.py): `backend/app/routers/categories.py`
- [Reminder and notification API](https://github.com/alexrohith/testconfcal/blob/main/backend/app/routers/reminders.py): `backend/app/routers/reminders.py`

### Researcher experience

- [Explore conferences](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/ExploreBrowser.tsx): `frontend/components/conferences/ExploreBrowser.tsx`
- [Conference details](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/ConferenceDetails.tsx): `frontend/components/conferences/ConferenceDetails.tsx`
- [Recommendations dashboard](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/dashboard/DashboardExperience.tsx): `frontend/components/dashboard/DashboardExperience.tsx`
- [Research interests](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/onboarding/ResearchInterestOnboarding.tsx): `frontend/components/onboarding/ResearchInterestOnboarding.tsx`
- [Saved conferences](https://github.com/alexrohith/testconfcal/blob/main/frontend/app/saved/page.tsx): `frontend/app/saved/page.tsx`
- [Personal calendar](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/calendar/CalendarExperience.tsx): `frontend/components/calendar/CalendarExperience.tsx`
- [Reminder controls](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/conferences/DeadlineReminderControl.tsx): `frontend/components/conferences/DeadlineReminderControl.tsx`
- [Notification center](https://github.com/alexrohith/testconfcal/blob/main/frontend/components/layout/NotificationCenter.tsx): `frontend/components/layout/NotificationCenter.tsx`
- [OAuth callback](https://github.com/alexrohith/testconfcal/blob/main/frontend/app/auth/callback/route.ts): `frontend/app/auth/callback/route.ts`

### API and identity

- [REST API](https://github.com/alexrohith/testconfcal/blob/main/backend/app/main.py): `backend/app/main.py`
- [Bearer-token validation](https://github.com/alexrohith/testconfcal/blob/main/backend/app/auth.py): `backend/app/auth.py`

### Conference data

- [Conference and reminder records](https://github.com/alexrohith/testconfcal/blob/main/backend/app/models/conference.py): `backend/app/models/conference.py`
- [Database access](https://github.com/alexrohith/testconfcal/blob/main/backend/app/database.py): `backend/app/database.py`
- **PostgreSQL conference data**

### IEEE ingestion

- [IEEE collection and sync](https://github.com/alexrohith/testconfcal/blob/main/backend/scripts/sync_ieee.py): `backend/scripts/sync_ieee.py`
- [Conference normalization](https://github.com/alexrohith/testconfcal/blob/main/scripts/normalize_ieee.py): `scripts/normalize_ieee.py`
- [Conference import](https://github.com/alexrohith/testconfcal/blob/main/backend/scripts/import_conferences.py): `backend/scripts/import_conferences.py`

### Other components

- **Researcher**
- **IEEE conference sources**

## Connections

- Researcher → Explore conferences: discovers
- Researcher → Recommendations dashboard: views recommendations
- Researcher → Research interests: sets interests
- Researcher → Saved conferences: saves events
- Researcher → Personal calendar: tracks deadlines
- Researcher → Reminder controls: sets reminders
- Researcher → Notification center: views notifications
- Researcher → OAuth callback: authenticates
- REST API → Conference and recommendation API: registers routes (evidence: `backend/app/main.py`)
- REST API → Category API: registers routes (evidence: `backend/app/main.py`)
- REST API → Reminder and notification API: registers routes (evidence: `backend/app/main.py`)
- Conference and recommendation API → Bearer-token validation: validates user (evidence: `backend/app/routers/conferences.py`)
- Reminder and notification API → Bearer-token validation: validates user (evidence: `backend/app/routers/reminders.py`)
- Conference and recommendation API → Database access: queries database (evidence: `backend/app/routers/conferences.py`)
- Category API → Database access: queries database (evidence: `backend/app/routers/categories.py`)
- Reminder and notification API → Database access: queries database (evidence: `backend/app/routers/reminders.py`)
- Conference and reminder records → Database access: uses ORM base (evidence: `backend/app/models/conference.py`)
- Database access → PostgreSQL conference data: opens connection (evidence: `backend/app/database.py`)
- Conference and recommendation API → Conference and reminder records: queries records (evidence: `backend/app/routers/conferences.py`)
- Reminder and notification API → Conference and reminder records: queries records (evidence: `backend/app/routers/reminders.py`)
- IEEE conference sources → IEEE collection and sync: supplies records
- IEEE collection and sync → Conference normalization: normalizes records (evidence: `backend/scripts/sync_ieee.py`)
- IEEE collection and sync → Conference import: imports records (evidence: `backend/scripts/sync_ieee.py`)
- PostgreSQL conference data → Conference and recommendation API: stores catalog
- PostgreSQL conference data → Reminder and notification API: stores reminders (evidence: `backend/app/routers/reminders.py`)
