# ibeneme/iyare architecture

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

- Interactive diagram: https://gitdiagram.com/ibeneme/iyare
- Repository: https://github.com/ibeneme/iyare

## Overview

Yare is an education platform frontend for public discovery and pricing, account access, and role-based learning and administration. Users browse public pages or sign in, then use app routes for classes, subjects, resources, schedules, tasks, payments, notifications, and account management. React route components dispatch Redux state operations; async slices call the backend through shared HTTP infrastructure. The excerpts support routing, task/resource operations, and common API behavior, but not the internal wiring of most feature pages; those branches are represented without speculative call edges.

Main entry points: [`src/App.tsx`](https://github.com/ibeneme/iyare/blob/main/src/App.tsx) (Application routes), [`src/Landing/Pricing/PlansPage.tsx`](https://github.com/ibeneme/iyare/blob/main/src/Landing/Pricing/PlansPage.tsx) (Plans and checkout), [`src/store/features/auth/auth.slice.ts`](https://github.com/ibeneme/iyare/blob/main/src/store/features/auth/auth.slice.ts) (Authentication state), [`src/store/features`](https://github.com/ibeneme/iyare/tree/main/src/store/features) (Feature slices)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_public_pages["Public pages"]
  node_plans["Plans and checkout<br/>[PlansPage.tsx]"]
  node_payment_verify["Payment verification"]
end

subgraph group_identity["Identity and routing"]
  node_app_router["Application routes<br/>[App.tsx]"]
  node_route_paths["Route registry<br/>[paths.ts]"]
  node_auth_pages["Sign-in and setup"]
  node_role_access["Role access<br/>[roles.ts]"]
  node_auth_state["Authentication state<br/>[auth.slice.ts]"]
  node_auth_cookies["Auth cookies<br/>[cookies.ts]"]
  node_app_shell["App providers<br/>[main.tsx]"]
end

subgraph group_learning["Learning operations"]
  node_subjects_classes["Subjects and classes"]
  node_resources["Class resources"]
  node_tasks["Tasks and tracking"]
  node_schedule["Timetable and live class"]
  node_academic_admin["Academic administration"]
end

subgraph group_platform["Platform services"]
  node_people["People and accounts<br/>[UserManagement.tsx]"]
  node_payments["Fees and subscriptions"]
  node_notifications["Notifications"]
  node_admin_settings["Admin and settings"]
end

subgraph group_state["Client state and API"]
  node_redux_store["Redux store<br/>[index.ts]"]
  node_feature_slices["Feature slices"]
  node_api_thunks["Async API thunks<br/>[api.ts]"]
  node_http_client["HTTP client<br/>[axiosInstance.ts]"]
end

node_visitor(("Visitor"))
node_backend{{"Platform backend"}}

node_visitor -->|"opens"| node_app_router
node_app_shell -->|"renders"| node_app_router
node_app_router -->|"routes to"| node_public_pages
node_app_router -->|"routes to"| node_plans
node_app_router -->|"routes to"| node_payment_verify
node_app_router -->|"routes to"| node_auth_pages
node_app_router -->|"uses paths"| node_route_paths
node_app_router -->|"routes to"| node_subjects_classes
node_app_router -->|"routes to"| node_resources
node_app_router -->|"routes to"| node_tasks
node_app_router -->|"routes to"| node_schedule
node_app_router -->|"routes to"| node_academic_admin
node_app_router -->|"routes to"| node_people
node_app_router -->|"routes to"| node_payments
node_app_router -->|"routes to"| node_notifications
node_app_router -->|"routes to"| node_admin_settings
node_app_router -->|"guards routes"| node_role_access
node_auth_pages -.->|"dispatches auth"| node_auth_state
node_auth_state -->|"calls"| node_http_client
node_auth_state -.->|"persists identity"| node_auth_cookies
node_plans -->|"requests checkout"| node_backend
node_plans -->|"redirects after payment"| node_payment_verify
node_resources -->|"dispatches resource ops"| node_feature_slices
node_tasks -->|"dispatches task ops"| node_feature_slices
node_feature_slices -->|"registers reducers"| node_redux_store
node_api_thunks -->|"uses client"| node_http_client
node_http_client -->|"sends requests"| node_backend
node_redux_store -->|"provides state"| node_app_shell

click node_public_pages "https://github.com/ibeneme/iyare/tree/main/src/Landing"
click node_plans "https://github.com/ibeneme/iyare/blob/main/src/Landing/Pricing/PlansPage.tsx"
click node_payment_verify "https://github.com/ibeneme/iyare/blob/main/src/Landing/Pricing/VerifyPaymentPage.tsx"
click node_app_router "https://github.com/ibeneme/iyare/blob/main/src/App.tsx"
click node_route_paths "https://github.com/ibeneme/iyare/blob/main/src/routes/paths.ts"
click node_auth_pages "https://github.com/ibeneme/iyare/tree/main/src/pages/auth"
click node_role_access "https://github.com/ibeneme/iyare/blob/main/src/config/roles.ts"
click node_auth_state "https://github.com/ibeneme/iyare/blob/main/src/store/features/auth/auth.slice.ts"
click node_auth_cookies "https://github.com/ibeneme/iyare/blob/main/src/utils/cookies.ts"
click node_subjects_classes "https://github.com/ibeneme/iyare/tree/main/src/pages/app/subjects"
click node_resources "https://github.com/ibeneme/iyare/blob/main/src/pages/app/classes/ResourceManager.tsx"
click node_tasks "https://github.com/ibeneme/iyare/tree/main/src/pages/app/tasks"
click node_schedule "https://github.com/ibeneme/iyare/tree/main/src/pages/app/timetable"
click node_academic_admin "https://github.com/ibeneme/iyare/tree/main/src/pages/app/grades"
click node_people "https://github.com/ibeneme/iyare/blob/main/src/pages/app/users/UserManagement.tsx"
click node_payments "https://github.com/ibeneme/iyare/tree/main/src/pages/app/payments"
click node_notifications "https://github.com/ibeneme/iyare/tree/main/src/pages/app/notifications"
click node_admin_settings "https://github.com/ibeneme/iyare/tree/main/src/pages/app/admin"
click node_redux_store "https://github.com/ibeneme/iyare/blob/main/src/store/index.ts"
click node_feature_slices "https://github.com/ibeneme/iyare/tree/main/src/store/features"
click node_api_thunks "https://github.com/ibeneme/iyare/blob/main/src/store/api.ts"
click node_http_client "https://github.com/ibeneme/iyare/blob/main/src/lib/axiosInstance.ts"
click node_app_shell "https://github.com/ibeneme/iyare/blob/main/src/main.tsx"

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_public_pages,node_plans,node_payment_verify toneBlue
class node_app_router,node_route_paths,node_auth_pages,node_role_access,node_auth_state,node_auth_cookies,node_app_shell toneAmber
class node_subjects_classes,node_resources,node_tasks,node_schedule,node_academic_admin toneMint
class node_people,node_payments,node_notifications,node_admin_settings toneRose
class node_redux_store,node_feature_slices,node_api_thunks,node_http_client,node_visitor,node_backend toneIndigo
```

## Components

### Public experience

- [Public pages](https://github.com/ibeneme/iyare/tree/main/src/Landing): `src/Landing`
- [Plans and checkout](https://github.com/ibeneme/iyare/blob/main/src/Landing/Pricing/PlansPage.tsx): `src/Landing/Pricing/PlansPage.tsx`
- [Payment verification](https://github.com/ibeneme/iyare/blob/main/src/Landing/Pricing/VerifyPaymentPage.tsx): `src/Landing/Pricing/VerifyPaymentPage.tsx`

### Identity and routing

- [Application routes](https://github.com/ibeneme/iyare/blob/main/src/App.tsx): `src/App.tsx`
- [Route registry](https://github.com/ibeneme/iyare/blob/main/src/routes/paths.ts): `src/routes/paths.ts`
- [Sign-in and setup](https://github.com/ibeneme/iyare/tree/main/src/pages/auth): `src/pages/auth`
- [Role access](https://github.com/ibeneme/iyare/blob/main/src/config/roles.ts): `src/config/roles.ts`
- [Authentication state](https://github.com/ibeneme/iyare/blob/main/src/store/features/auth/auth.slice.ts): `src/store/features/auth/auth.slice.ts`
- [Auth cookies](https://github.com/ibeneme/iyare/blob/main/src/utils/cookies.ts): `src/utils/cookies.ts`
- [App providers](https://github.com/ibeneme/iyare/blob/main/src/main.tsx): `src/main.tsx`

### Learning operations

- [Subjects and classes](https://github.com/ibeneme/iyare/tree/main/src/pages/app/subjects): `src/pages/app/subjects`
- [Class resources](https://github.com/ibeneme/iyare/blob/main/src/pages/app/classes/ResourceManager.tsx): `src/pages/app/classes/ResourceManager.tsx`
- [Tasks and tracking](https://github.com/ibeneme/iyare/tree/main/src/pages/app/tasks): `src/pages/app/tasks`
- [Timetable and live class](https://github.com/ibeneme/iyare/tree/main/src/pages/app/timetable): `src/pages/app/timetable`
- [Academic administration](https://github.com/ibeneme/iyare/tree/main/src/pages/app/grades): `src/pages/app/grades`

### Platform services

- [People and accounts](https://github.com/ibeneme/iyare/blob/main/src/pages/app/users/UserManagement.tsx): `src/pages/app/users/UserManagement.tsx`
- [Fees and subscriptions](https://github.com/ibeneme/iyare/tree/main/src/pages/app/payments): `src/pages/app/payments`
- [Notifications](https://github.com/ibeneme/iyare/tree/main/src/pages/app/notifications): `src/pages/app/notifications`
- [Admin and settings](https://github.com/ibeneme/iyare/tree/main/src/pages/app/admin): `src/pages/app/admin`

### Client state and API

- [Redux store](https://github.com/ibeneme/iyare/blob/main/src/store/index.ts): `src/store/index.ts`
- [Feature slices](https://github.com/ibeneme/iyare/tree/main/src/store/features): `src/store/features`
- [Async API thunks](https://github.com/ibeneme/iyare/blob/main/src/store/api.ts): `src/store/api.ts`
- [HTTP client](https://github.com/ibeneme/iyare/blob/main/src/lib/axiosInstance.ts): `src/lib/axiosInstance.ts`

### Other components

- **Visitor**
- **Platform backend**

## Connections

- Visitor → Application routes: opens
- App providers → Application routes: renders (evidence: `src/main.tsx`)
- Application routes → Public pages: routes to (evidence: `src/App.tsx`)
- Application routes → Plans and checkout: routes to (evidence: `src/App.tsx`)
- Application routes → Payment verification: routes to (evidence: `src/App.tsx`)
- Application routes → Sign-in and setup: routes to (evidence: `src/App.tsx`)
- Application routes → Route registry: uses paths (evidence: `src/routes/paths.ts`)
- Application routes → Subjects and classes: routes to (evidence: `src/App.tsx`)
- Application routes → Class resources: routes to (evidence: `src/App.tsx`)
- Application routes → Tasks and tracking: routes to (evidence: `src/App.tsx`)
- Application routes → Timetable and live class: routes to (evidence: `src/App.tsx`)
- Application routes → Academic administration: routes to (evidence: `src/App.tsx`)
- Application routes → People and accounts: routes to (evidence: `src/App.tsx`)
- Application routes → Fees and subscriptions: routes to (evidence: `src/App.tsx`)
- Application routes → Notifications: routes to (evidence: `src/App.tsx`)
- Application routes → Admin and settings: routes to (evidence: `src/App.tsx`)
- Application routes → Role access: guards routes (evidence: `src/App.tsx`)
- Sign-in and setup → Authentication state: dispatches auth
- Authentication state → HTTP client: calls (evidence: `src/store/features/auth/auth.slice.ts`)
- Authentication state → Auth cookies: persists identity
- Plans and checkout → Platform backend: requests checkout (evidence: `src/Landing/Pricing/PlansPage.tsx`)
- Plans and checkout → Payment verification: redirects after payment (evidence: `src/Landing/Pricing/PlansPage.tsx`)
- Class resources → Feature slices: dispatches resource ops (evidence: `src/pages/app/classes/ResourceManager.tsx`)
- Tasks and tracking → Feature slices: dispatches task ops (evidence: `src/pages/app/tasks/TasksPage.tsx`)
- Feature slices → Redux store: registers reducers (evidence: `src/store/index.ts`)
- Async API thunks → HTTP client: uses client (evidence: `src/store/api.ts`)
- HTTP client → Platform backend: sends requests (evidence: `src/lib/axiosInstance.ts`)
- Redux store → App providers: provides state (evidence: `src/main.tsx`)
