# gabriellatcc/metricnotes-web architecture

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

## Overview

MetricNotes is a Portuguese-language productivity and business-intelligence web app for self-employed users, backed by a separate PHP API. The main workflow is account access, task creation and organization, calendar scheduling, and review through completed tasks and dashboard analytics; notes and account settings are additional product areas. The graph follows routes into their feature pages and highlights task/calendar/API layers. Several feature implementations were not excerpted, so uncertain connections are omitted or dashed rather than presented as inspected call paths.

Main entry points: [`src/components/tasks/tasks-page.tsx`](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-page.tsx) (Task board), [`src/routes/tasks.tsx`](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/tasks.tsx) (Task routes), [`src/components/tasks/tasks-calendar-page.tsx`](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-calendar-page.tsx) (Task calendar page), [`src/routes/(auth)`](https://github.com/gabriellatcc/metricnotes-web/tree/main/src/routes/(auth)) (Login and signup routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and access"]
  node_landing["Landing page<br/>[index.tsx]"]
  node_auth_routes["Login and signup routes"]
  node_auth_forms["Auth forms and layout"]
  node_settings["Account settings<br/>[settings.tsx]"]
end

subgraph group_work["Task management"]
  node_task_routes["Task routes<br/>[tasks.tsx]"]
  node_task_board["Task board<br/>[tasks-page.tsx]"]
  node_kanban["Kanban board"]
  node_completed["Completed tasks"]
end

subgraph group_calendar["Calendar"]
  node_calendar_routes["Task calendar route<br/>[tasks.calendar.tsx]"]
  node_calendar_page["Task calendar page"]
  node_calendar_shell["Calendar shell"]
  node_calendar_engine["Calendar views and state"]
end

subgraph group_insight["Notes and insights"]
  node_dashboard_routes["Dashboard routes<br/>[dashboard.tsx]"]
  node_dashboard["Dashboard analytics"]
  node_notes_route["Notes route<br/>[notes.tsx]"]
  node_notes["Notes workspace<br/>[notes-page.tsx]"]
end

subgraph group_shared["Shared services"]
  node_api_client["API client and auth token<br/>[api-client.ts]"]
  node_api_errors["API feedback<br/>[api-toast.ts]"]
end

node_visitor(("User"))
node_backend{{"MetricNotes API"}}

node_visitor -->|"opens"| node_landing
node_visitor -->|"signs in"| node_auth_routes
node_auth_routes -->|"renders"| node_auth_forms
node_visitor -->|"manages tasks"| node_task_routes
node_task_routes -->|"renders"| node_task_board
node_task_board -->|"renders"| node_kanban
node_task_board -->|"requests task data"| node_backend
node_task_board -->|"reports errors"| node_api_errors
node_task_routes -->|"renders"| node_completed
node_completed -->|"loads tasks"| node_backend
node_visitor -->|"schedules tasks"| node_calendar_routes
node_calendar_routes -->|"renders"| node_calendar_page
node_calendar_page -->|"uses"| node_calendar_shell
node_calendar_shell -->|"composes"| node_calendar_engine
node_calendar_page -->|"loads task events"| node_backend
node_visitor -->|"reviews analytics"| node_dashboard_routes
node_dashboard_routes -.->|"serves analytics"| node_dashboard
node_visitor -->|"opens notes"| node_notes_route
node_notes_route -->|"renders"| node_notes
node_visitor -->|"manages account"| node_settings
node_settings -->|"updates account"| node_backend
node_api_client -.->|"sends API requests"| node_backend

click node_landing "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/index.tsx"
click node_auth_routes "https://github.com/gabriellatcc/metricnotes-web/tree/main/src/routes/(auth)"
click node_auth_forms "https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/auth"
click node_task_routes "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/tasks.tsx"
click node_task_board "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-page.tsx"
click node_kanban "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/task-kanban-board.tsx"
click node_completed "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/completed-tasks-page.tsx"
click node_calendar_routes "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/tasks.calendar.tsx"
click node_calendar_page "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-calendar-page.tsx"
click node_calendar_shell "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-calendar-shell.tsx"
click node_calendar_engine "https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/ui/imported-calendar"
click node_dashboard_routes "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/dashboard.tsx"
click node_dashboard "https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/dashboard"
click node_notes_route "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/notes.tsx"
click node_notes "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/notes/notes-page.tsx"
click node_settings "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/settings.tsx"
click node_api_client "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/lib/api-client.ts"
click node_api_errors "https://github.com/gabriellatcc/metricnotes-web/blob/main/src/lib/api-toast.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_landing,node_auth_routes,node_auth_forms,node_settings,node_visitor toneBlue
class node_task_routes,node_task_board,node_kanban,node_completed toneAmber
class node_calendar_routes,node_calendar_page,node_calendar_shell,node_calendar_engine,node_backend toneMint
class node_dashboard_routes,node_dashboard,node_notes_route,node_notes toneRose
class node_api_client,node_api_errors toneIndigo
```

## Components

### Entry and access

- [Landing page](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Login and signup routes](https://github.com/gabriellatcc/metricnotes-web/tree/main/src/routes/(auth)): `src/routes/(auth)`
- [Auth forms and layout](https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/auth): `src/components/auth`
- [Account settings](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/settings.tsx): `src/routes/settings.tsx`

### Task management

- [Task routes](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/tasks.tsx): `src/routes/tasks.tsx`
- [Task board](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-page.tsx): `src/components/tasks/tasks-page.tsx`
- [Kanban board](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/task-kanban-board.tsx): `src/components/tasks/task-kanban-board.tsx`
- [Completed tasks](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/completed-tasks-page.tsx): `src/components/tasks/completed-tasks-page.tsx`

### Calendar

- [Task calendar route](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/tasks.calendar.tsx): `src/routes/tasks.calendar.tsx`
- [Task calendar page](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-calendar-page.tsx): `src/components/tasks/tasks-calendar-page.tsx`
- [Calendar shell](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/tasks/tasks-calendar-shell.tsx): `src/components/tasks/tasks-calendar-shell.tsx`
- [Calendar views and state](https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/ui/imported-calendar): `src/components/ui/imported-calendar`

### Notes and insights

- [Dashboard routes](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/dashboard.tsx): `src/routes/dashboard.tsx`
- [Dashboard analytics](https://github.com/gabriellatcc/metricnotes-web/tree/main/src/components/dashboard): `src/components/dashboard`
- [Notes route](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/routes/notes.tsx): `src/routes/notes.tsx`
- [Notes workspace](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/components/notes/notes-page.tsx): `src/components/notes/notes-page.tsx`

### Shared services

- [API client and auth token](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/lib/api-client.ts): `src/lib/api-client.ts`
- [API feedback](https://github.com/gabriellatcc/metricnotes-web/blob/main/src/lib/api-toast.ts): `src/lib/api-toast.ts`

### Other components

- **User**
- **MetricNotes API**

## Connections

- User → Landing page: opens (evidence: `src/routes/index.tsx`)
- User → Login and signup routes: signs in
- Login and signup routes → Auth forms and layout: renders (evidence: `src/routes/(auth)/login.tsx`)
- User → Task routes: manages tasks
- Task routes → Task board: renders
- Task board → Kanban board: renders (evidence: `src/components/tasks/tasks-page.tsx`)
- Task board → MetricNotes API: requests task data (evidence: `src/components/tasks/tasks-page.tsx`)
- Task board → API feedback: reports errors (evidence: `src/components/tasks/tasks-page.tsx`)
- Task routes → Completed tasks: renders
- Completed tasks → MetricNotes API: loads tasks (evidence: `src/components/tasks/completed-tasks-page.tsx`)
- User → Task calendar route: schedules tasks
- Task calendar route → Task calendar page: renders (evidence: `src/routes/tasks.calendar.tsx`)
- Task calendar page → Calendar shell: uses (evidence: `src/components/tasks/tasks-calendar-page.tsx`)
- Calendar shell → Calendar views and state: composes (evidence: `src/components/tasks/tasks-calendar-shell.tsx`)
- Task calendar page → MetricNotes API: loads task events (evidence: `src/components/tasks/tasks-calendar-page.tsx`)
- User → Dashboard routes: reviews analytics
- Dashboard routes → Dashboard analytics: serves analytics
- User → Notes route: opens notes
- Notes route → Notes workspace: renders
- User → Account settings: manages account
- Account settings → MetricNotes API: updates account (evidence: `src/routes/settings.tsx`)
- API client and auth token → MetricNotes API: sends API requests (evidence: `README.md`)
