# mmoraispro/clone-tabnews architecture

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

- Interactive diagram: https://gitdiagram.com/mmoraispro/clone-tabnews
- Repository: https://github.com/mmoraispro/clone-tabnews

## Overview

clone-tabnews is a course project providing a web application and API for user accounts, sessions, activation, authorization, migrations, and status. The apparent user workflow spans account creation, email activation, authentication, and session-based requests; the sampled code confirms the activation, authentication, and session mechanisms, but does not expose the route-handler implementations that connect them. The status page explicitly fetches the status API. Other API capabilities are represented from the repository tree, with uncertain wiring omitted.

Main entry points: [`models/activation.js`](https://github.com/mmoraispro/clone-tabnews/blob/main/models/activation.js) (Account activation), [`infra/controller.js`](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/controller.js) (Request controller), [`infra/database.js`](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/database.js) (Database access), [`models/user.js`](https://github.com/mmoraispro/clone-tabnews/blob/main/models/user.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Web and API"]
  node_api_routes["API routes"]
  node_activation_route["Activation endpoint<br/>[index.js]"]
  node_sessions_route["Session endpoint<br/>[index.js]"]
  node_user_route["Current user endpoint<br/>[index.js]"]
  node_users_route["User endpoints"]
  node_migration_route["Migration endpoint<br/>[index.js]"]
  node_status_route["Status endpoint<br/>[index.js]"]
  node_home["Home page<br/>[index.js]"]
  node_status_page["Status page<br/>[index.js]"]
end

subgraph group_identity["Identity and access"]
  node_authorization["Authorization rules<br/>[authorization.js]"]
  node_authentication["Credential authentication<br/>[authentication.js]"]
  node_sessions["Session lifecycle<br/>[session.js]"]
  node_activation["Account activation<br/>[activation.js]"]
  node_users["User records<br/>[user.js]"]
  node_password["Password handling<br/>[password.js]"]
end

subgraph group_services["Application services"]
  node_controller["Request controller<br/>[controller.js]"]
  node_database["Database access<br/>[database.js]"]
  node_errors["Error types<br/>[errors.js]"]
  node_email["Email delivery<br/>[email.js]"]
  node_webserver["Web server origin<br/>[webserver.js]"]
end

subgraph group_ops["Status and migrations"]
  node_migrator["Migration model<br/>[migrator.js]"]
end

node_visitor(("Visitor"))
node_postgres[("PostgreSQL")]
node_smtp["SMTP service"]

node_visitor -->|"views"| node_status_page
node_status_page -->|"fetches status"| node_status_route
node_controller -->|"resolves sessions"| node_sessions
node_controller -->|"loads users"| node_users
node_controller -->|"checks features"| node_authorization
node_controller -->|"raises errors"| node_errors
node_authentication -->|"finds account"| node_users
node_authentication -->|"compares password"| node_password
node_sessions -->|"queries sessions"| node_database
node_database -->|"queries"| node_postgres
node_activation -->|"updates account"| node_users
node_activation -->|"checks eligibility"| node_authorization
node_activation -->|"queries tokens"| node_database
node_activation -->|"sends activation"| node_email
node_activation -->|"uses origin"| node_webserver
node_email -->|"sends mail"| node_smtp
node_database -->|"wraps failures"| node_errors

click node_api_routes "https://github.com/mmoraispro/clone-tabnews/tree/main/pages/api/v1"
click node_activation_route "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/activations/%5Btoken_id%5D/index.js"
click node_sessions_route "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/sessions/index.js"
click node_user_route "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/user/index.js"
click node_users_route "https://github.com/mmoraispro/clone-tabnews/tree/main/pages/api/v1/users"
click node_migration_route "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/migrations/index.js"
click node_status_route "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/status/index.js"
click node_home "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/index.js"
click node_status_page "https://github.com/mmoraispro/clone-tabnews/blob/main/pages/status/index.js"
click node_controller "https://github.com/mmoraispro/clone-tabnews/blob/main/infra/controller.js"
click node_authorization "https://github.com/mmoraispro/clone-tabnews/blob/main/models/authorization.js"
click node_authentication "https://github.com/mmoraispro/clone-tabnews/blob/main/models/authentication.js"
click node_sessions "https://github.com/mmoraispro/clone-tabnews/blob/main/models/session.js"
click node_activation "https://github.com/mmoraispro/clone-tabnews/blob/main/models/activation.js"
click node_users "https://github.com/mmoraispro/clone-tabnews/blob/main/models/user.js"
click node_password "https://github.com/mmoraispro/clone-tabnews/blob/main/models/password.js"
click node_database "https://github.com/mmoraispro/clone-tabnews/blob/main/infra/database.js"
click node_errors "https://github.com/mmoraispro/clone-tabnews/blob/main/infra/errors.js"
click node_email "https://github.com/mmoraispro/clone-tabnews/blob/main/infra/email.js"
click node_webserver "https://github.com/mmoraispro/clone-tabnews/blob/main/infra/webserver.js"
click node_migrator "https://github.com/mmoraispro/clone-tabnews/blob/main/models/migrator.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_api_routes,node_activation_route,node_sessions_route,node_user_route,node_users_route,node_migration_route,node_status_route,node_home,node_status_page toneBlue
class node_authorization,node_authentication,node_sessions,node_activation,node_users,node_password,node_postgres toneAmber
class node_controller,node_database,node_errors,node_email,node_webserver toneMint
class node_migrator toneRose
class node_visitor,node_smtp toneIndigo
```

## Components

### Web and API

- [API routes](https://github.com/mmoraispro/clone-tabnews/tree/main/pages/api/v1): `pages/api/v1`
- [Activation endpoint](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/activations/%5Btoken_id%5D/index.js): `pages/api/v1/activations/[token_id]/index.js`
- [Session endpoint](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/sessions/index.js): `pages/api/v1/sessions/index.js`
- [Current user endpoint](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/user/index.js): `pages/api/v1/user/index.js`
- [User endpoints](https://github.com/mmoraispro/clone-tabnews/tree/main/pages/api/v1/users): `pages/api/v1/users`
- [Migration endpoint](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/migrations/index.js): `pages/api/v1/migrations/index.js`
- [Status endpoint](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/api/v1/status/index.js): `pages/api/v1/status/index.js`
- [Home page](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/index.js): `pages/index.js`
- [Status page](https://github.com/mmoraispro/clone-tabnews/blob/main/pages/status/index.js): `pages/status/index.js`

### Identity and access

- [Authorization rules](https://github.com/mmoraispro/clone-tabnews/blob/main/models/authorization.js): `models/authorization.js`
- [Credential authentication](https://github.com/mmoraispro/clone-tabnews/blob/main/models/authentication.js): `models/authentication.js`
- [Session lifecycle](https://github.com/mmoraispro/clone-tabnews/blob/main/models/session.js): `models/session.js`
- [Account activation](https://github.com/mmoraispro/clone-tabnews/blob/main/models/activation.js): `models/activation.js`
- [User records](https://github.com/mmoraispro/clone-tabnews/blob/main/models/user.js): `models/user.js`
- [Password handling](https://github.com/mmoraispro/clone-tabnews/blob/main/models/password.js): `models/password.js`

### Application services

- [Request controller](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/controller.js): `infra/controller.js`
- [Database access](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/database.js): `infra/database.js`
- [Error types](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/errors.js): `infra/errors.js`
- [Email delivery](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/email.js): `infra/email.js`
- [Web server origin](https://github.com/mmoraispro/clone-tabnews/blob/main/infra/webserver.js): `infra/webserver.js`

### Status and migrations

- [Migration model](https://github.com/mmoraispro/clone-tabnews/blob/main/models/migrator.js): `models/migrator.js`

### Other components

- **Visitor**
- **PostgreSQL**
- **SMTP service**

## Connections

- Visitor → Status page: views (evidence: `pages/status/index.js`)
- Status page → Status endpoint: fetches status (evidence: `pages/status/index.js`)
- Request controller → Session lifecycle: resolves sessions (evidence: `infra/controller.js`)
- Request controller → User records: loads users (evidence: `infra/controller.js`)
- Request controller → Authorization rules: checks features (evidence: `infra/controller.js`)
- Request controller → Error types: raises errors (evidence: `infra/controller.js`)
- Credential authentication → User records: finds account (evidence: `models/authentication.js`)
- Credential authentication → Password handling: compares password (evidence: `models/authentication.js`)
- Session lifecycle → Database access: queries sessions (evidence: `models/session.js`)
- Database access → PostgreSQL: queries (evidence: `infra/database.js`)
- Account activation → User records: updates account (evidence: `models/activation.js`)
- Account activation → Authorization rules: checks eligibility (evidence: `models/activation.js`)
- Account activation → Database access: queries tokens (evidence: `models/activation.js`)
- Account activation → Email delivery: sends activation (evidence: `models/activation.js`)
- Account activation → Web server origin: uses origin (evidence: `models/activation.js`)
- Email delivery → SMTP service: sends mail (evidence: `infra/email.js`)
- Database access → Error types: wraps failures (evidence: `infra/database.js`)
