# vanessaho-ai-0202/mylearnplan architecture

> Architecture diagram of the GitHub repository vanessaho-ai-0202/mylearnplan, 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/vanessaho-ai-0202/mylearnplan
- Repository: https://github.com/vanessaho-ai-0202/mylearnplan

## Overview

myLearnPlan is a per-user learning planner. After login or account activation, the browser loads the workspace; users manage plans, tasks, daily logs and certifications, then review calendar, dashboard, statistics and search views. Settings and full JSON backup provide account preferences and portability. The excerpts show browser-to-API calls, selected route handlers, and recurrence behavior; major features documented in the README are retained, while unsampled implementation details and their internal links are not inferred.

Main entry points: [`src/api.js`](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/api.js) (API client), [`server/index.ts`](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/index.ts) (API routes), [`src/main.js`](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/main.js) (Workspace shell), [`prisma/schema.prisma`](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/prisma/schema.prisma) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser workspace"]
  node_entry["Login entry<br/>[entry.js]"]
  node_main["Workspace shell<br/>[main.js]"]
  node_clientapi["API client<br/>[api.js]"]
end

subgraph group_api["API and identity"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_server["API routes<br/>[index.ts]"]
  node_validation["Validation<br/>[validation.ts]"]
  node_analytics["Analytics API<br/>[analytics.ts]"]
  node_extended["Certification API<br/>[extended.ts]"]
end

subgraph group_domain["Learning features"]
  node_plans["Learning plans<br/>[learningPlans.js]"]
  node_tasks["Tasks<br/>[tasks.js]"]
  node_recurrence["Recurring tasks<br/>[recurrence.ts]"]
  node_logs["Daily logs<br/>[dailyLogs.js]"]
  node_certifications["Certifications<br/>[certifications.js]"]
  node_calendar["Calendar<br/>[calendar.js]"]
  node_overview["Dashboard<br/>[overview.js]"]
  node_statistics["Statistics<br/>[statistics.js]"]
  node_search["Search filters<br/>[searchFilters.js]"]
  node_settings["Settings and backup<br/>[backup.ts]"]
end

subgraph group_data["Persistence"]
  node_database[("PostgreSQL<br/>[schema.prisma]")]
end

node_user(("Learner"))

node_user -->|"uses"| node_entry
node_entry -->|"requests auth"| node_clientapi
node_entry -->|"loads workspace"| node_main
node_clientapi -->|"sends API requests"| node_server
node_server -->|"registers auth"| node_auth
node_server -->|"creates and syncs tasks"| node_recurrence
node_server -.->|"queries and updates"| node_database
node_main -->|"uses"| node_clientapi
node_main -->|"sets up"| node_plans
node_main -->|"sets up"| node_tasks
node_main -->|"sets up"| node_logs
node_main -->|"sets up"| node_calendar
node_main -->|"sets up"| node_certifications
node_tasks -->|"requests tasks"| node_clientapi
node_search -->|"requests search"| node_clientapi
node_logs -->|"requests data"| node_clientapi
node_plans -->|"requests data"| node_clientapi
node_calendar -->|"requests data"| node_clientapi
node_certifications -->|"requests data"| node_clientapi
node_overview -->|"requests data"| node_clientapi
node_statistics -->|"requests data"| node_clientapi
node_server -->|"validates inputs"| node_validation
node_server -->|"registers backup routes"| node_settings
node_server -->|"registers analytics"| node_analytics
node_server -->|"registers certifications"| node_extended
node_analytics -.->|"queries metrics"| node_database
node_extended -->|"persists certifications"| node_database
node_settings -->|"reads and writes backup"| node_database
node_recurrence -->|"creates recurring tasks"| node_database
node_extended -->|"validates fields"| node_validation
node_settings -->|"validates settings and backup"| node_validation

click node_entry "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/entry.js"
click node_main "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/main.js"
click node_clientapi "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/api.js"
click node_auth "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/auth.ts"
click node_server "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/index.ts"
click node_validation "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/validation.ts"
click node_plans "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/learningPlans.js"
click node_tasks "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/tasks.js"
click node_recurrence "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/recurrence.ts"
click node_logs "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/dailyLogs.js"
click node_certifications "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/certifications.js"
click node_calendar "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/calendar.js"
click node_overview "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/overview.js"
click node_statistics "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/statistics.js"
click node_search "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/searchFilters.js"
click node_settings "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/backup.ts"
click node_analytics "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/analytics.ts"
click node_extended "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/extended.ts"
click node_database "https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/prisma/schema.prisma"

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_main,node_clientapi toneBlue
class node_auth,node_server,node_validation,node_analytics,node_extended toneAmber
class node_plans,node_tasks,node_recurrence,node_logs,node_certifications,node_calendar,node_overview,node_statistics,node_search,node_settings toneMint
class node_database toneRose
class node_user toneIndigo
```

## Components

### Browser workspace

- [Login entry](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/entry.js): `src/entry.js`
- [Workspace shell](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/main.js): `src/main.js`
- [API client](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/api.js): `src/api.js`

### API and identity

- [Authentication](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/auth.ts): `server/auth.ts`
- [API routes](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/index.ts): `server/index.ts`
- [Validation](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/validation.ts): `server/validation.ts`
- [Analytics API](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/analytics.ts): `server/analytics.ts`
- [Certification API](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/extended.ts): `server/extended.ts`

### Learning features

- [Learning plans](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/learningPlans.js): `src/features/learningPlans.js`
- [Tasks](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/tasks.js): `src/features/tasks.js`
- [Recurring tasks](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/recurrence.ts): `server/recurrence.ts`
- [Daily logs](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/dailyLogs.js): `src/features/dailyLogs.js`
- [Certifications](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/certifications.js): `src/features/certifications.js`
- [Calendar](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/calendar.js): `src/features/calendar.js`
- [Dashboard](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/overview.js): `src/features/overview.js`
- [Statistics](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/statistics.js): `src/features/statistics.js`
- [Search filters](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/src/features/searchFilters.js): `src/features/searchFilters.js`
- [Settings and backup](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/server/backup.ts): `server/backup.ts`

### Persistence

- [PostgreSQL](https://github.com/vanessaho-ai-0202/mylearnplan/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **Learner**

## Connections

- Learner → Login entry: uses (evidence: `README.md`)
- Login entry → API client: requests auth (evidence: `src/entry.js`)
- Login entry → Workspace shell: loads workspace (evidence: `src/entry.js`)
- API client → API routes: sends API requests (evidence: `src/api.js`)
- API routes → Authentication: registers auth (evidence: `server/index.ts`)
- API routes → Recurring tasks: creates and syncs tasks (evidence: `server/index.ts`)
- API routes → PostgreSQL: queries and updates
- Workspace shell → API client: uses (evidence: `src/main.js`)
- Workspace shell → Learning plans: sets up (evidence: `src/main.js`)
- Workspace shell → Tasks: sets up (evidence: `src/main.js`)
- Workspace shell → Daily logs: sets up (evidence: `src/main.js`)
- Workspace shell → Calendar: sets up (evidence: `src/main.js`)
- Workspace shell → Certifications: sets up (evidence: `src/main.js`)
- Tasks → API client: requests tasks (evidence: `src/features/tasks.js`)
- Search filters → API client: requests search (evidence: `src/features/searchFilters.js`)
- Daily logs → API client: requests data (evidence: `src/features/dailyLogs.js`)
- Learning plans → API client: requests data (evidence: `src/features/learningPlans.js`)
- Calendar → API client: requests data (evidence: `src/features/calendar.js`)
- Certifications → API client: requests data (evidence: `src/features/certifications.js`)
- Dashboard → API client: requests data (evidence: `src/features/overview.js`)
- Statistics → API client: requests data (evidence: `src/features/statistics.js`)
- API routes → Validation: validates inputs (evidence: `server/index.ts`)
- API routes → Settings and backup: registers backup routes (evidence: `server/index.ts`)
- API routes → Analytics API: registers analytics (evidence: `server/index.ts`)
- API routes → Certification API: registers certifications (evidence: `server/index.ts`)
- Analytics API → PostgreSQL: queries metrics
- Certification API → PostgreSQL: persists certifications (evidence: `server/extended.ts`)
- Settings and backup → PostgreSQL: reads and writes backup (evidence: `server/backup.ts`)
- Recurring tasks → PostgreSQL: creates recurring tasks (evidence: `server/recurrence.ts`)
- Certification API → Validation: validates fields (evidence: `server/extended.ts`)
- Settings and backup → Validation: validates settings and backup (evidence: `server/backup.ts`)
