# mohdsahil36/nocta architecture

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

- Interactive diagram: https://gitdiagram.com/mohdsahil36/nocta
- Repository: https://github.com/mohdsahil36/nocta

## Overview

Nocta’s documented product workflow is a nightly check-in that uses deterministic priority scoring to choose one fitting action or a protected recovery night, with goal tracking and weekly reflection around it. The sampled implementation is mostly a landing/auth surface plus a GitHub-backed activity feature; the core decision workflow appears in README and landing content, but its runtime implementation is not shown. The graph preserves that documented product capability while marking the gap, and distinguishes the separate activity API. Backend and activity connections are supported by excerpts/index; unsampled dashboard and product modules are represented cautiously.

Main entry points: [`frontend/app/login/page.tsx`](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/page.tsx) (Landing page), [`frontend/app/login/content.ts`](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts) (Nightly check-in), [`backend/src/services/activity.service.ts`](https://github.com/mohdsahil36/nocta/blob/main/backend/src/services/activity.service.ts) (Activity service), [`backend/src/server.ts`](https://github.com/mohdsahil36/nocta/blob/main/backend/src/server.ts) (Express server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_landing_copy["Product content<br/>[content.ts]"]
  node_auth_flow["Email auth flow<br/>[auth.ts]"]
  node_dashboard["Dashboard"]
end

subgraph group_decision["Nightly decision"]
  node_nightly_checkin["Nightly check-in<br/>[content.ts]"]
  node_goal_tracking["Goal tracking<br/>[content.ts]"]
  node_priority_scoring["Priority scoring<br/>[content.ts]"]
  node_action_choice["Single action<br/>[content.ts]"]
  node_recovery["Recovery night<br/>[content.ts]"]
  node_weekly_reflection["Weekly reflection<br/>[content.ts]"]
end

subgraph group_activity["Activity feed"]
  node_activity_page["Activity page<br/>[page.tsx]"]
  node_activity_api_client["Activity API client<br/>[activity-api.ts]"]
end

subgraph group_api["Activity API"]
  node_api_server["Express server<br/>[server.ts]"]
  node_api_routes["API routes<br/>[index.ts]"]
  node_activity_route["Activity route<br/>[activity.route.ts]"]
  node_activity_controller["Activity controller"]
  node_activity_service["Activity service"]
  node_github_client["GitHub client<br/>[github.ts]"]
  node_activity_stats["Activity stats<br/>[activity-stats.ts]"]
  node_env_config["Environment config<br/>[envConfig.ts]"]
  node_prisma_client["Prisma client<br/>[prisma.ts]"]
end

node_visitor(("Visitor"))
node_supabase_auth["Supabase Auth"]
node_github["GitHub"]
node_database[("PostgreSQL")]

node_visitor -->|"opens"| node_landing
node_landing -->|"uses copy"| node_landing_copy
node_landing -->|"calls auth"| node_auth_flow
node_auth_flow -->|"authenticates"| node_supabase_auth
node_landing -->|"routes after auth"| node_dashboard
node_dashboard -.->|"offers check-in"| node_nightly_checkin
node_nightly_checkin -.->|"uses goals"| node_goal_tracking
node_nightly_checkin -.->|"scores priorities"| node_priority_scoring
node_priority_scoring -.->|"selects one"| node_action_choice
node_nightly_checkin -.->|"can protect rest"| node_recovery
node_weekly_reflection -.->|"reviews patterns"| node_goal_tracking
node_visitor -->|"views activity"| node_activity_page
node_activity_page -.->|"loads activity"| node_activity_api_client
node_activity_api_client -.->|"requests API"| node_api_server
node_api_server -->|"mounts routes"| node_api_routes
node_api_routes -->|"registers route"| node_activity_route
node_activity_route -.->|"dispatches"| node_activity_controller
node_activity_controller -->|"calls service"| node_activity_service
node_activity_service -->|"fetches commits"| node_github_client
node_github_client -.->|"queries commits"| node_github
node_activity_service -->|"computes stats"| node_activity_stats
node_activity_service -->|"reads settings"| node_env_config
node_api_server -->|"health-checks DB"| node_prisma_client
node_prisma_client -.->|"queries"| node_database

click node_landing "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/page.tsx"
click node_landing_copy "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_auth_flow "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/functions/auth.ts"
click node_dashboard "https://github.com/mohdsahil36/nocta/tree/main/frontend/app/dashboard"
click node_nightly_checkin "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_goal_tracking "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_priority_scoring "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_action_choice "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_recovery "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_weekly_reflection "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts"
click node_activity_page "https://github.com/mohdsahil36/nocta/blob/main/frontend/app/activity/page.tsx"
click node_activity_api_client "https://github.com/mohdsahil36/nocta/blob/main/frontend/lib/activity-api.ts"
click node_api_server "https://github.com/mohdsahil36/nocta/blob/main/backend/src/server.ts"
click node_api_routes "https://github.com/mohdsahil36/nocta/blob/main/backend/src/routes/index.ts"
click node_activity_route "https://github.com/mohdsahil36/nocta/blob/main/backend/src/routes/activity.route.ts"
click node_activity_controller "https://github.com/mohdsahil36/nocta/blob/main/backend/src/controller/activity.controller.ts"
click node_activity_service "https://github.com/mohdsahil36/nocta/blob/main/backend/src/services/activity.service.ts"
click node_github_client "https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/github.ts"
click node_activity_stats "https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/activity-stats.ts"
click node_env_config "https://github.com/mohdsahil36/nocta/blob/main/backend/src/config/envConfig.ts"
click node_prisma_client "https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/prisma.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_landing_copy,node_auth_flow,node_dashboard toneBlue
class node_nightly_checkin,node_goal_tracking,node_priority_scoring,node_action_choice,node_recovery,node_weekly_reflection,node_database toneAmber
class node_activity_page,node_activity_api_client toneMint
class node_api_server,node_api_routes,node_activity_route,node_activity_controller,node_activity_service,node_github_client,node_activity_stats,node_env_config,node_prisma_client toneRose
class node_visitor,node_supabase_auth,node_github toneIndigo
```

## Components

### Web experience

- [Landing page](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/page.tsx): `frontend/app/login/page.tsx`
- [Product content](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Email auth flow](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/functions/auth.ts): `frontend/app/login/functions/auth.ts`
- [Dashboard](https://github.com/mohdsahil36/nocta/tree/main/frontend/app/dashboard): `frontend/app/dashboard`

### Nightly decision

- [Nightly check-in](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Goal tracking](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Priority scoring](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Single action](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Recovery night](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`
- [Weekly reflection](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/login/content.ts): `frontend/app/login/content.ts`

### Activity feed

- [Activity page](https://github.com/mohdsahil36/nocta/blob/main/frontend/app/activity/page.tsx): `frontend/app/activity/page.tsx`
- [Activity API client](https://github.com/mohdsahil36/nocta/blob/main/frontend/lib/activity-api.ts): `frontend/lib/activity-api.ts`

### Activity API

- [Express server](https://github.com/mohdsahil36/nocta/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [API routes](https://github.com/mohdsahil36/nocta/blob/main/backend/src/routes/index.ts): `backend/src/routes/index.ts`
- [Activity route](https://github.com/mohdsahil36/nocta/blob/main/backend/src/routes/activity.route.ts): `backend/src/routes/activity.route.ts`
- [Activity controller](https://github.com/mohdsahil36/nocta/blob/main/backend/src/controller/activity.controller.ts): `backend/src/controller/activity.controller.ts`
- [Activity service](https://github.com/mohdsahil36/nocta/blob/main/backend/src/services/activity.service.ts): `backend/src/services/activity.service.ts`
- [GitHub client](https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/github.ts): `backend/src/lib/github.ts`
- [Activity stats](https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/activity-stats.ts): `backend/src/lib/activity-stats.ts`
- [Environment config](https://github.com/mohdsahil36/nocta/blob/main/backend/src/config/envConfig.ts): `backend/src/config/envConfig.ts`
- [Prisma client](https://github.com/mohdsahil36/nocta/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`

### Other components

- **Visitor**
- **Supabase Auth**
- **GitHub**
- **PostgreSQL**

## Connections

- Visitor → Landing page: opens (evidence: `frontend/app/login/page.tsx`)
- Landing page → Product content: uses copy (evidence: `frontend/app/login/page.tsx`)
- Landing page → Email auth flow: calls auth (evidence: `frontend/app/login/page.tsx`)
- Email auth flow → Supabase Auth: authenticates (evidence: `frontend/app/login/functions/auth.ts`)
- Landing page → Dashboard: routes after auth (evidence: `frontend/app/login/page.tsx`)
- Dashboard → Nightly check-in: offers check-in
- Nightly check-in → Goal tracking: uses goals (evidence: `frontend/app/login/content.ts`)
- Nightly check-in → Priority scoring: scores priorities (evidence: `frontend/app/login/content.ts`)
- Priority scoring → Single action: selects one (evidence: `frontend/app/login/content.ts`)
- Nightly check-in → Recovery night: can protect rest (evidence: `frontend/app/login/content.ts`)
- Weekly reflection → Goal tracking: reviews patterns (evidence: `frontend/app/login/content.ts`)
- Visitor → Activity page: views activity (evidence: `frontend/app/activity/page.tsx`)
- Activity page → Activity API client: loads activity
- Activity API client → Express server: requests API
- Express server → API routes: mounts routes (evidence: `backend/src/server.ts`)
- API routes → Activity route: registers route (evidence: `backend/src/routes/index.ts`)
- Activity route → Activity controller: dispatches
- Activity controller → Activity service: calls service (evidence: `backend/src/controller/activity.controller.ts`)
- Activity service → GitHub client: fetches commits (evidence: `backend/src/services/activity.service.ts`)
- GitHub client → GitHub: queries commits
- Activity service → Activity stats: computes stats (evidence: `backend/src/services/activity.service.ts`)
- Activity service → Environment config: reads settings (evidence: `backend/src/services/activity.service.ts`)
- Express server → Prisma client: health-checks DB (evidence: `backend/src/server.ts`)
- Prisma client → PostgreSQL: queries
