# innovate-to-grow/innovate-to-grow-website architecture

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

- Interactive diagram: https://gitdiagram.com/innovate-to-grow/innovate-to-grow-website
- Repository: https://github.com/innovate-to-grow/innovate-to-grow-website

## Overview

Innovate To Grow is a university engineering public website and management platform: a React frontend backed by Django REST services, with a companion `i2g-admin` CLI. The principal visitor flow is page navigation into CMS, event, news, or project experiences, with data supplied by backend APIs; account and event-registration flows add authentication and verification. The tree and README establish the product capabilities, but most feature/API implementations were not sampled, so uncertain runtime links are omitted or marked unverified.

Main entry points: [`pages/src/lib/api/api-client.ts`](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/lib/api/api-client.ts) (API client), [`src/config/routing/urls.py`](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/config/routing/urls.py) (Django API), [`src/apps/authn`](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/authn) (Authentication API), [`cli/src/i2g_admin/runtime.py`](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/runtime.py) (CLI runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Website shell"]
  node_router["Page router<br/>[router.tsx]"]
  node_layout["Site layout"]
  node_frontendapi["API client<br/>[api-client.ts]"]
end

subgraph group_features["Visitor features"]
  node_cmsui["CMS pages"]
  node_eventsui["Event pages"]
  node_projectsui["Project catalog"]
  node_newsui["News pages"]
  node_authui["Account flows"]
  node_authstorage[("Browser session<br/>[storage.ts]")]
end

subgraph group_backend["Django services"]
  node_django["Django API<br/>[urls.py]"]
  node_cmsbackend["CMS routing<br/>[page_routes.py]"]
  node_cmsmedia[("CMS media<br/>[media.py]")]
  node_eventbackend["Event services"]
  node_registrationsync["Registration sync<br/>[engine.py]"]
  node_projectsbackend["Project services"]
  node_backendadmin["Admin API<br/>[apps.py]"]
end

subgraph group_identity["Identity services"]
  node_authbackend["Authentication API"]
  node_authmodels[("Member records<br/>[member.py]")]
  node_rsa["RSA key service<br/>[rsa_manager.py]"]
  node_mail["Mail integration"]
end

subgraph group_cli["Admin CLI"]
  node_cliapp["CLI commands<br/>[app.py]"]
  node_cliruntime["CLI runtime<br/>[runtime.py]"]
  node_cliauth["CLI login<br/>[auth.py]"]
  node_cliconfig["CLI configuration<br/>[config.py]"]
  node_cliclient["HTTP client<br/>[client.py]"]
end

node_visitor(("Site visitor"))
node_cliuser(("Administrator"))

node_visitor -->|"opens pages"| node_router
node_router -.->|"renders shell"| node_layout
node_router -->|"routes to"| node_cmsui
node_visitor -.->|"registers"| node_eventsui
node_visitor -.->|"browses"| node_projectsui
node_visitor -.->|"reads news"| node_newsui
node_visitor -.->|"signs in"| node_authui
node_authui -->|"reads session"| node_authstorage
node_authui -.->|"requests auth"| node_frontendapi
node_cmsui -.->|"fetches content"| node_frontendapi
node_eventsui -.->|"requests events"| node_frontendapi
node_projectsui -.->|"requests projects"| node_frontendapi
node_newsui -.->|"requests news"| node_frontendapi
node_frontendapi -->|"calls API"| node_django
node_django -.->|"routes CMS"| node_cmsbackend
node_django -.->|"routes events"| node_eventbackend
node_django -.->|"routes projects"| node_projectsbackend
node_django -.->|"routes auth"| node_authbackend
node_cmsbackend -.->|"uses media"| node_cmsmedia
node_eventbackend -->|"exports registrations"| node_registrationsync
node_authbackend -.->|"manages members"| node_authmodels
node_authbackend -.->|"encrypts credentials"| node_rsa
node_authbackend -.->|"sends messages"| node_mail
node_cliuser -->|"runs commands"| node_cliapp
node_cliapp -->|"delegates execution"| node_cliruntime
node_cliruntime -->|"gets token"| node_cliauth
node_cliruntime -->|"loads settings"| node_cliconfig
node_cliruntime -->|"creates client"| node_cliclient
node_cliauth -->|"stores credentials"| node_cliconfig
node_cliclient -.->|"calls admin API"| node_backendadmin

click node_router "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/app/router/router.tsx"
click node_layout "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/layout/components"
click node_cmsui "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/cms/components"
click node_eventsui "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/routes/EventRegistrationPage"
click node_projectsui "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/projects/components"
click node_newsui "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/routes/NewsPage"
click node_authui "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/auth/components"
click node_authstorage "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/features/auth/api/storage.ts"
click node_frontendapi "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/lib/api/api-client.ts"
click node_django "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/config/routing/urls.py"
click node_cmsbackend "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cms/services/routing/page_routes.py"
click node_cmsmedia "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cms/models/media.py"
click node_eventbackend "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/event"
click node_registrationsync "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/event/services/registration_sheet_sync/engine.py"
click node_projectsbackend "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/projects"
click node_authbackend "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/authn"
click node_authmodels "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/authn/models/members/member.py"
click node_rsa "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/authn/services/security/rsa_manager.py"
click node_mail "https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/mail"
click node_cliapp "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/app.py"
click node_cliruntime "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/runtime.py"
click node_cliauth "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/auth.py"
click node_cliconfig "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/config.py"
click node_cliclient "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/client.py"
click node_backendadmin "https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cli_admin/views/apps.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_router,node_layout,node_frontendapi toneBlue
class node_cmsui,node_eventsui,node_projectsui,node_newsui,node_authui,node_authstorage toneAmber
class node_django,node_cmsbackend,node_cmsmedia,node_eventbackend,node_registrationsync,node_projectsbackend,node_backendadmin toneMint
class node_authbackend,node_authmodels,node_rsa,node_mail toneRose
class node_cliapp,node_cliruntime,node_cliauth,node_cliconfig,node_cliclient,node_visitor,node_cliuser toneIndigo
```

## Components

### Website shell

- [Page router](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/app/router/router.tsx): `pages/src/app/router/router.tsx`
- [Site layout](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/layout/components): `pages/src/features/layout/components`
- [API client](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/lib/api/api-client.ts): `pages/src/lib/api/api-client.ts`

### Visitor features

- [CMS pages](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/cms/components): `pages/src/features/cms/components`
- [Event pages](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/routes/EventRegistrationPage): `pages/src/routes/EventRegistrationPage`
- [Project catalog](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/projects/components): `pages/src/features/projects/components`
- [News pages](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/routes/NewsPage): `pages/src/routes/NewsPage`
- [Account flows](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/pages/src/features/auth/components): `pages/src/features/auth/components`
- [Browser session](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/pages/src/features/auth/api/storage.ts): `pages/src/features/auth/api/storage.ts`

### Django services

- [Django API](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/config/routing/urls.py): `src/config/routing/urls.py`
- [CMS routing](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cms/services/routing/page_routes.py): `src/apps/cms/services/routing/page_routes.py`
- [CMS media](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cms/models/media.py): `src/apps/cms/models/media.py`
- [Event services](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/event): `src/apps/event`
- [Registration sync](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/event/services/registration_sheet_sync/engine.py): `src/apps/event/services/registration_sheet_sync/engine.py`
- [Project services](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/projects): `src/apps/projects`
- [Admin API](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/cli_admin/views/apps.py): `src/apps/cli_admin/views/apps.py`

### Identity services

- [Authentication API](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/authn): `src/apps/authn`
- [Member records](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/authn/models/members/member.py): `src/apps/authn/models/members/member.py`
- [RSA key service](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/src/apps/authn/services/security/rsa_manager.py): `src/apps/authn/services/security/rsa_manager.py`
- [Mail integration](https://github.com/innovate-to-grow/innovate-to-grow-website/tree/main/src/apps/mail): `src/apps/mail`

### Admin CLI

- [CLI commands](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/app.py): `cli/src/i2g_admin/app.py`
- [CLI runtime](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/runtime.py): `cli/src/i2g_admin/runtime.py`
- [CLI login](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/auth.py): `cli/src/i2g_admin/auth.py`
- [CLI configuration](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/config.py): `cli/src/i2g_admin/config.py`
- [HTTP client](https://github.com/innovate-to-grow/innovate-to-grow-website/blob/main/cli/src/i2g_admin/client.py): `cli/src/i2g_admin/client.py`

### Other components

- **Site visitor**
- **Administrator**

## Connections

- Site visitor → Page router: opens pages (evidence: `README.md`)
- Page router → Site layout: renders shell
- Page router → CMS pages: routes to (evidence: `pages/src/app/router/router.tsx`)
- Site visitor → Event pages: registers
- Site visitor → Project catalog: browses
- Site visitor → News pages: reads news
- Site visitor → Account flows: signs in
- Account flows → Browser session: reads session (evidence: `pages/src/features/auth/components/context/useAuthActions.ts`)
- Account flows → API client: requests auth
- CMS pages → API client: fetches content
- Event pages → API client: requests events
- Project catalog → API client: requests projects
- News pages → API client: requests news
- API client → Django API: calls API (evidence: `README.md`)
- Django API → CMS routing: routes CMS
- Django API → Event services: routes events
- Django API → Project services: routes projects
- Django API → Authentication API: routes auth
- CMS routing → CMS media: uses media
- Event services → Registration sync: exports registrations (evidence: `src/apps/event/services/registration_sheet_sync/engine.py`)
- Authentication API → Member records: manages members
- Authentication API → RSA key service: encrypts credentials (evidence: `src/apps/authn/services/security/rsa_manager.py`)
- Authentication API → Mail integration: sends messages
- Administrator → CLI commands: runs commands (evidence: `cli/src/i2g_admin/app.py`)
- CLI commands → CLI runtime: delegates execution (evidence: `cli/src/i2g_admin/app.py`)
- CLI runtime → CLI login: gets token (evidence: `cli/src/i2g_admin/runtime.py`)
- CLI runtime → CLI configuration: loads settings (evidence: `cli/src/i2g_admin/runtime.py`)
- CLI runtime → HTTP client: creates client (evidence: `cli/src/i2g_admin/runtime.py`)
- CLI login → CLI configuration: stores credentials (evidence: `cli/src/i2g_admin/auth.py`)
- HTTP client → Admin API: calls admin API
