# sabin-chacko/nextjs-project architecture

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

- Interactive diagram: https://gitdiagram.com/sabin-chacko/nextjs-project
- Repository: https://github.com/sabin-chacko/nextjs-project

## Overview

This NestJS starter exposes authenticated user and todo endpoints. Requests reach the application controller: login uses local authentication and issues a JWT; protected routes create users or resolve the authenticated user before creating, listing, or updating todos. User and todo services persist through Mongoose models. The source excerpts support these handler and persistence relationships; strategy-to-guard dispatch details are not shown, so they are not inferred.

Main entry points: [`src/app.controller.ts`](https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.controller.ts) (API controller), [`src/app.module.ts`](https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.module.ts) (Application module), [`src/auth/auth.module.ts`](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/auth.module.ts) (Auth module), [`src/users/users.service.ts`](https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/users.service.ts) (Users service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_bootstrap["Nest bootstrap<br/>[main.ts]"]
  node_appmodule["Application module<br/>[app.module.ts]"]
  node_controller["API controller<br/>[app.controller.ts]"]
end

subgraph group_identity["Authentication and users"]
  node_authmodule["Auth module<br/>[auth.module.ts]"]
  node_authservice["Auth service<br/>[auth.service.ts]"]
  node_localguard["Local auth guard"]
  node_jwtguard["JWT auth guard<br/>[jwt-auth.guard.ts]"]
  node_localstrategy["Local strategy<br/>[local.strategy.ts]"]
  node_jwtstrategy["JWT strategy<br/>[jwt.strategy.ts]"]
  node_usersmodule["Users module<br/>[users.module.ts]"]
  node_userservice["Users service<br/>[users.service.ts]"]
  node_userdto["User DTOs<br/>[user.dto.ts]"]
  node_jwtprovider["JWT provider"]
end

subgraph group_todos["Todo management"]
  node_todomodule["Todo module<br/>[todo.module.ts]"]
  node_todoservice["Todo service<br/>[todo.service.ts]"]
  node_tododto["Todo DTOs<br/>[todo.dto.ts]"]
end

subgraph group_persistence["Persistence"]
  node_userschema["User schema<br/>[user.schema.ts]"]
  node_todoschema["Todo schema<br/>[todo.schema.ts]"]
  node_mongodb[("MongoDB")]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_controller
node_bootstrap -->|"starts"| node_appmodule
node_appmodule -->|"registers"| node_controller
node_appmodule -->|"imports"| node_authmodule
node_appmodule -->|"imports"| node_usersmodule
node_appmodule -->|"imports"| node_todomodule
node_appmodule -->|"connects"| node_mongodb
node_controller -->|"guards login"| node_localguard
node_controller -->|"guards routes"| node_jwtguard
node_controller -->|"calls login"| node_authservice
node_controller -->|"calls user operations"| node_userservice
node_controller -->|"calls todo operations"| node_todoservice
node_controller -->|"accepts user data"| node_userdto
node_controller -->|"accepts todo data"| node_tododto
node_authmodule -->|"provides"| node_authservice
node_authmodule -->|"registers"| node_localstrategy
node_authmodule -->|"registers"| node_jwtstrategy
node_authmodule -->|"imports"| node_usersmodule
node_authmodule -->|"configures"| node_jwtprovider
node_localstrategy -->|"validates with"| node_authservice
node_authservice -->|"looks up users"| node_userservice
node_authservice -->|"signs tokens"| node_jwtprovider
node_usersmodule -->|"provides"| node_userservice
node_usersmodule -->|"registers model"| node_userschema
node_userservice -->|"uses model"| node_userschema
node_userservice -->|"reads and writes"| node_mongodb
node_userservice -->|"accepts create data"| node_userdto
node_todomodule -->|"provides"| node_todoservice
node_todomodule -->|"registers model"| node_todoschema
node_todoservice -->|"uses model"| node_todoschema
node_todoservice -->|"reads and writes"| node_mongodb
node_todoservice -->|"accepts todo data"| node_tododto

click node_bootstrap "https://github.com/sabin-chacko/nextjs-project/blob/main/src/main.ts"
click node_appmodule "https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.module.ts"
click node_controller "https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.controller.ts"
click node_authmodule "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/auth.module.ts"
click node_authservice "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/auth.service.ts"
click node_localguard "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/local-auth.guard.ts"
click node_jwtguard "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/jwt-auth.guard.ts"
click node_localstrategy "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/local.strategy.ts"
click node_jwtstrategy "https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/jwt.strategy.ts"
click node_usersmodule "https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/users.module.ts"
click node_userservice "https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/users.service.ts"
click node_userdto "https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/dto/user.dto.ts"
click node_userschema "https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/schemas/user.schema.ts"
click node_todomodule "https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/todo.module.ts"
click node_todoservice "https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/todo.service.ts"
click node_tododto "https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/dto/todo.dto.ts"
click node_todoschema "https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/schemas/todo.schema.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_bootstrap,node_appmodule,node_controller,node_client toneBlue
class node_authmodule,node_authservice,node_localguard,node_jwtguard,node_localstrategy,node_jwtstrategy,node_usersmodule,node_userservice,node_userdto,node_jwtprovider toneAmber
class node_todomodule,node_todoservice,node_tododto toneMint
class node_userschema,node_todoschema,node_mongodb toneRose
```

## Components

### Application runtime

- [Nest bootstrap](https://github.com/sabin-chacko/nextjs-project/blob/main/src/main.ts): `src/main.ts`
- [Application module](https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.module.ts): `src/app.module.ts`
- [API controller](https://github.com/sabin-chacko/nextjs-project/blob/main/src/app.controller.ts): `src/app.controller.ts`

### Authentication and users

- [Auth module](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/auth.module.ts): `src/auth/auth.module.ts`
- [Auth service](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [Local auth guard](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/local-auth.guard.ts): `src/auth/local-auth.guard.ts`
- [JWT auth guard](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/jwt-auth.guard.ts): `src/auth/jwt-auth.guard.ts`
- [Local strategy](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/local.strategy.ts): `src/auth/local.strategy.ts`
- [JWT strategy](https://github.com/sabin-chacko/nextjs-project/blob/main/src/auth/jwt.strategy.ts): `src/auth/jwt.strategy.ts`
- [Users module](https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/users.module.ts): `src/users/users.module.ts`
- [Users service](https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/users.service.ts): `src/users/users.service.ts`
- [User DTOs](https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/dto/user.dto.ts): `src/users/dto/user.dto.ts`
- **JWT provider**

### Todo management

- [Todo module](https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/todo.module.ts): `src/todo/todo.module.ts`
- [Todo service](https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/todo.service.ts): `src/todo/todo.service.ts`
- [Todo DTOs](https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/dto/todo.dto.ts): `src/todo/dto/todo.dto.ts`

### Persistence

- [User schema](https://github.com/sabin-chacko/nextjs-project/blob/main/src/users/schemas/user.schema.ts): `src/users/schemas/user.schema.ts`
- [Todo schema](https://github.com/sabin-chacko/nextjs-project/blob/main/src/todo/schemas/todo.schema.ts): `src/todo/schemas/todo.schema.ts`
- **MongoDB**

### Other components

- **HTTP client**

## Connections

- HTTP client → API controller: sends requests (evidence: `src/app.controller.ts`)
- Nest bootstrap → Application module: starts (evidence: `src/main.ts`)
- Application module → API controller: registers (evidence: `src/app.module.ts`)
- Application module → Auth module: imports (evidence: `src/app.module.ts`)
- Application module → Users module: imports (evidence: `src/app.module.ts`)
- Application module → Todo module: imports (evidence: `src/app.module.ts`)
- Application module → MongoDB: connects (evidence: `src/app.module.ts`)
- API controller → Local auth guard: guards login (evidence: `src/app.controller.ts`)
- API controller → JWT auth guard: guards routes (evidence: `src/app.controller.ts`)
- API controller → Auth service: calls login (evidence: `src/app.controller.ts`)
- API controller → Users service: calls user operations (evidence: `src/app.controller.ts`)
- API controller → Todo service: calls todo operations (evidence: `src/app.controller.ts`)
- API controller → User DTOs: accepts user data (evidence: `src/app.controller.ts`)
- API controller → Todo DTOs: accepts todo data (evidence: `src/app.controller.ts`)
- Auth module → Auth service: provides (evidence: `src/auth/auth.module.ts`)
- Auth module → Local strategy: registers (evidence: `src/auth/auth.module.ts`)
- Auth module → JWT strategy: registers (evidence: `src/auth/auth.module.ts`)
- Auth module → Users module: imports (evidence: `src/auth/auth.module.ts`)
- Auth module → JWT provider: configures (evidence: `src/auth/auth.module.ts`)
- Local strategy → Auth service: validates with (evidence: `src/auth/local.strategy.ts`)
- Auth service → Users service: looks up users (evidence: `src/auth/auth.service.ts`)
- Auth service → JWT provider: signs tokens (evidence: `src/auth/auth.service.ts`)
- Users module → Users service: provides (evidence: `src/users/users.module.ts`)
- Users module → User schema: registers model (evidence: `src/users/users.module.ts`)
- Users service → User schema: uses model (evidence: `src/users/users.service.ts`)
- Users service → MongoDB: reads and writes (evidence: `src/users/users.service.ts`)
- Users service → User DTOs: accepts create data (evidence: `src/users/users.service.ts`)
- Todo module → Todo service: provides (evidence: `src/todo/todo.module.ts`)
- Todo module → Todo schema: registers model (evidence: `src/todo/todo.module.ts`)
- Todo service → Todo schema: uses model (evidence: `src/todo/todo.service.ts`)
- Todo service → MongoDB: reads and writes (evidence: `src/todo/todo.service.ts`)
- Todo service → Todo DTOs: accepts todo data (evidence: `src/todo/todo.service.ts`)
