# carlosmg0715/proyecto_web architecture

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

- Interactive diagram: https://gitdiagram.com/carlosmg0715/proyecto_web
- Repository: https://github.com/carlosmg0715/proyecto_web

## Overview

Kordia lets people create or join habit groups, record check-ins, and follow group progress. The web client routes users through account access and group views, calling the Express API; backend controllers and services enforce membership rules and persist habits, chat, sessions, and preferences in PostgreSQL. Daily closure, reminders, verification email, and streak pokes are additional product capabilities. The graph follows documented and excerpted calls; some frontend-to-API and unsampled feature links are documented in the README rather than verified in source.

Main entry points: [`backend/src/routes/groupRoutes.js`](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/groupRoutes.js) (Group routes), [`backend/src/prisma.js`](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/prisma.js) (Prisma client), [`backend/src/routes/authRoutes.js`](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/authRoutes.js) (Auth routes), [`backend/src/services/groupService.js`](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/groupService.js) (Habit and group rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_vue["Vue application<br/>[App.vue]"]
  node_navigation["Navigation<br/>[index.ts]"]
  node_account_ui["Account screens<br/>[LoginView.vue]"]
  node_group_ui["Group workspace<br/>[GrupoView.vue]"]
  node_client_session["Session state<br/>[session.ts]"]
  node_group_state["Group state<br/>[groups.ts]"]
  node_api_client["HTTP services<br/>[api.ts]"]
end

subgraph group_api["API and routing"]
  node_express["Express API<br/>[app.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_group_routes["Group routes<br/>[groupRoutes.js]"]
  node_auth_middleware["Session middleware<br/>[authMiddleware.js]"]
  node_validation["Request validation<br/>[validate.js]"]
end

subgraph group_domain["Account and groups"]
  node_auth_controller["Account controller<br/>[authController.js]"]
  node_auth_service["Account service<br/>[authService.js]"]
  node_verification["Email verification"]
  node_groups_controller["Group controller<br/>[groupController.js]"]
  node_groups_service["Habit and group rules<br/>[groupService.js]"]
  node_profile["Profile preferences"]
  node_chat["Group chat<br/>[GroupChat.vue]"]
  node_streaks["Streak pokes<br/>[streakPokes.js]"]
end

subgraph group_runtime["Persistence and jobs"]
  node_repository["Group queries<br/>[groupRepository.js]"]
  node_database_client["Prisma client<br/>[prisma.js]"]
  node_postgres[("PostgreSQL")]
  node_daily_jobs["Daily reminders<br/>[dailyReminder.js]"]
  node_server["HTTP server<br/>[server.js]"]
end

node_person(("Person"))

node_person -->|"uses"| node_vue
node_vue -->|"renders routes"| node_navigation
node_navigation -.->|"routes to"| node_account_ui
node_navigation -.->|"routes to"| node_group_ui
node_account_ui -.->|"uses session"| node_client_session
node_group_ui -.->|"uses state"| node_group_state
node_client_session -.->|"requests"| node_api_client
node_group_state -.->|"requests"| node_api_client
node_api_client -->|"HTTP /api"| node_express
node_express -->|"mounts"| node_auth_routes
node_express -->|"mounts"| node_group_routes
node_auth_routes -->|"authenticates"| node_auth_middleware
node_group_routes -->|"authenticates"| node_auth_middleware
node_auth_routes -->|"validates"| node_validation
node_group_routes -->|"validates"| node_validation
node_auth_routes -->|"dispatches"| node_auth_controller
node_group_routes -->|"dispatches"| node_groups_controller
node_group_routes -->|"dispatches"| node_profile
node_auth_controller -->|"delegates"| node_auth_service
node_auth_service -->|"sends email"| node_verification
node_groups_controller -->|"delegates"| node_groups_service
node_groups_service -->|"queries"| node_repository
node_groups_service -->|"reads and writes"| node_database_client
node_repository -->|"queries"| node_database_client
node_auth_service -->|"reads and writes"| node_database_client
node_profile -->|"reads and writes"| node_database_client
node_database_client -->|"persists data"| node_postgres
node_server -->|"serves"| node_express
node_server -->|"starts"| node_daily_jobs
node_daily_jobs -->|"reads and writes"| node_database_client
node_group_routes -.->|"chat endpoint"| node_chat
node_group_routes -->|"dispatches"| node_streaks
node_groups_service -->|"closes day"| node_database_client

click node_vue "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/App.vue"
click node_navigation "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/router/index.ts"
click node_account_ui "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/views/LoginView.vue"
click node_group_ui "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/views/app/GrupoView.vue"
click node_client_session "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/stores/session.ts"
click node_group_state "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/stores/groups.ts"
click node_api_client "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/services/api.ts"
click node_express "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/app.js"
click node_auth_routes "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/authRoutes.js"
click node_group_routes "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/groupRoutes.js"
click node_auth_middleware "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/middlewares/authMiddleware.js"
click node_validation "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/middlewares/validate.js"
click node_auth_controller "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/authController.js"
click node_auth_service "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/authService.js"
click node_verification "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/verificationEmail.js"
click node_groups_controller "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/groupController.js"
click node_groups_service "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/groupService.js"
click node_profile "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/profileController.js"
click node_repository "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/repositories/groupRepository.js"
click node_database_client "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/prisma.js"
click node_daily_jobs "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/dailyReminder.js"
click node_server "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/server.js"
click node_chat "https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/components/group/GroupChat.vue"
click node_streaks "https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/streakPokes.js"

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_vue,node_navigation,node_account_ui,node_group_ui,node_client_session,node_group_state,node_api_client toneBlue
class node_express,node_auth_routes,node_group_routes,node_auth_middleware,node_validation toneAmber
class node_auth_controller,node_auth_service,node_verification,node_groups_controller,node_groups_service,node_profile,node_chat,node_streaks toneMint
class node_repository,node_database_client,node_postgres,node_daily_jobs,node_server toneRose
class node_person toneIndigo
```

## Components

### Web client

- [Vue application](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/App.vue): `Frontend/src/App.vue`
- [Navigation](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/router/index.ts): `Frontend/src/router/index.ts`
- [Account screens](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/views/LoginView.vue): `Frontend/src/views/LoginView.vue`
- [Group workspace](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/views/app/GrupoView.vue): `Frontend/src/views/app/GrupoView.vue`
- [Session state](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/stores/session.ts): `Frontend/src/stores/session.ts`
- [Group state](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/stores/groups.ts): `Frontend/src/stores/groups.ts`
- [HTTP services](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/services/api.ts): `Frontend/src/services/api.ts`

### API and routing

- [Express API](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/app.js): `backend/src/app.js`
- [Auth routes](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Group routes](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/routes/groupRoutes.js): `backend/src/routes/groupRoutes.js`
- [Session middleware](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/middlewares/authMiddleware.js): `backend/src/middlewares/authMiddleware.js`
- [Request validation](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/middlewares/validate.js): `backend/src/middlewares/validate.js`

### Account and groups

- [Account controller](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [Account service](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Email verification](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/verificationEmail.js): `backend/src/services/verificationEmail.js`
- [Group controller](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/groupController.js): `backend/src/controllers/groupController.js`
- [Habit and group rules](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/groupService.js): `backend/src/services/groupService.js`
- [Profile preferences](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/controllers/profileController.js): `backend/src/controllers/profileController.js`
- [Group chat](https://github.com/carlosmg0715/proyecto_web/blob/main/Frontend/src/components/group/GroupChat.vue): `Frontend/src/components/group/GroupChat.vue`
- [Streak pokes](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/streakPokes.js): `backend/src/services/streakPokes.js`

### Persistence and jobs

- [Group queries](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/repositories/groupRepository.js): `backend/src/repositories/groupRepository.js`
- [Prisma client](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/prisma.js): `backend/src/prisma.js`
- **PostgreSQL**
- [Daily reminders](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/src/services/dailyReminder.js): `backend/src/services/dailyReminder.js`
- [HTTP server](https://github.com/carlosmg0715/proyecto_web/blob/main/backend/server.js): `backend/server.js`

### Other components

- **Person**

## Connections

- Person → Vue application: uses (evidence: `README.md`)
- Vue application → Navigation: renders routes (evidence: `Frontend/src/main.ts`)
- Navigation → Account screens: routes to
- Navigation → Group workspace: routes to
- Account screens → Session state: uses session
- Group workspace → Group state: uses state
- Session state → HTTP services: requests
- Group state → HTTP services: requests
- HTTP services → Express API: HTTP /api (evidence: `README.md`)
- Express API → Auth routes: mounts (evidence: `backend/src/app.js`)
- Express API → Group routes: mounts (evidence: `backend/src/app.js`)
- Auth routes → Session middleware: authenticates (evidence: `backend/src/routes/authRoutes.js`)
- Group routes → Session middleware: authenticates (evidence: `backend/src/routes/groupRoutes.js`)
- Auth routes → Request validation: validates (evidence: `backend/src/routes/authRoutes.js`)
- Group routes → Request validation: validates (evidence: `backend/src/routes/groupRoutes.js`)
- Auth routes → Account controller: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Group routes → Group controller: dispatches (evidence: `backend/src/routes/groupRoutes.js`)
- Group routes → Profile preferences: dispatches (evidence: `backend/src/routes/groupRoutes.js`)
- Account controller → Account service: delegates (evidence: `backend/src/controllers/authController.js`)
- Account service → Email verification: sends email (evidence: `backend/src/services/authService.js`)
- Group controller → Habit and group rules: delegates (evidence: `backend/src/controllers/groupController.js`)
- Habit and group rules → Group queries: queries (evidence: `backend/src/services/groupService.js`)
- Habit and group rules → Prisma client: reads and writes (evidence: `backend/src/services/groupService.js`)
- Group queries → Prisma client: queries (evidence: `backend/src/repositories/groupRepository.js`)
- Account service → Prisma client: reads and writes (evidence: `backend/src/services/authService.js`)
- Profile preferences → Prisma client: reads and writes (evidence: `backend/src/controllers/profileController.js`)
- Prisma client → PostgreSQL: persists data (evidence: `README.md`)
- HTTP server → Express API: serves (evidence: `backend/server.js`)
- HTTP server → Daily reminders: starts (evidence: `backend/server.js`)
- Daily reminders → Prisma client: reads and writes (evidence: `backend/src/services/dailyReminder.js`)
- Group routes → Group chat: chat endpoint
- Group routes → Streak pokes: dispatches (evidence: `backend/src/routes/groupRoutes.js`)
- Habit and group rules → Prisma client: closes day (evidence: `README.md`)
