# villan7667/secrets-7667 architecture

> Architecture diagram of the GitHub repository villan7667/secrets-7667, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/villan7667/secrets-7667
- Repository: https://github.com/villan7667/secrets-7667

## Overview

##### Project Type and Purpose
- This is a full-stack web application (“Secrets Web Application”) built on Node.js/Express with EJS templates.
- Purpose: allow users to register, log in, and anonymously post/view “secrets” with secure authentication and a responsive UI.

##### File Structure
- Top Level
- index.js – Express app entry point (routing, middleware, DB connection)
- package.json / package-lock.json – dependencies and scripts
- .env (optional) – environment variables (e.g., DB URI, JWT secret)
- public/ – static assets served by Express
- css/styles.css – styling
- js/script.js – client-side behavior
- views/ – server-rendered EJS templates (MVC “View” layer)
- partials/header.ejs & footer.ejs – reusable layout components
- home.ejs, login.ejs, register.ejs, secret.ejs – page templates

##### README for Insights
- Tech stack: Express.js (server), EJS (templating), MongoDB Atlas via Mongoose (data), Bcrypt + JWT + Cookies (auth), vanilla JS/CSS (frontend).
- Features: user registration/login, password hashing, JWT session management, secret posting, responsive UI.

a. Main Components
- Client (Browser)
- CDN/Static Asset Server (public folder)
- Web Server / API Layer (Express.js)
- Templating Engine (EJS)
- Authentication Module (Bcrypt + JWT + Cookie middleware)
- Data Access Layer (Mongoose ORM)
- Database (MongoDB Atlas)
b. Relationships & Data Flows
1. Browser → HTTP(S) → Express routes
2. Express → reads/writes → MongoDB via Mongoose
3. Express ↔ JWT Cookie exchanged with Browser for session state
4. Express → renders → EJS templates + serves static CSS/JS from public/
c. Architectural Patterns & Principles
- MVC-inspired separation:
- Views: EJS templates
- Controller logic: route handlers in index.js
- Model: Mongoose schemas (implied)
- Stateless authentication with signed JWTs stored in HTTP-only cookies
- Modularization: static assets, views/partials, middleware grouped by concern
d. Key Technologies & Frameworks
- Node.js & Express.js
- EJS (server-side rendering)
- MongoDB Atlas + Mongoose
- Authentication: Bcrypt (password hashing), JSON Web Tokens (JWT), secure cookies
- Frontend: HTML5, CSS3, Vanilla JavaScript

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Presentation Layer
    subgraph "Presentation Layer" 
        direction TB
        Browser["Browser"]:::frontend
        subgraph "Static Asset Server"
            direction TB
            CSS["CSS Styles"]:::frontend
            JS["Client-side JS"]:::frontend
        end
        Browser -->|"requests CSS/JS via HTTPS"| CSS
        Browser -->|"requests CSS/JS via HTTPS"| JS
    end

    %% Application Layer
    subgraph "Application Layer"
        direction TB
        Express["Express Server"]:::backend
        EJS["EJS Templating Engine"]:::backend
        Auth["Auth & Session Middleware"]:::auth
        Routes["Route Handlers"]:::backend
        Config["Env Configuration"]:::config

        Browser -->|"HTTP(S) Requests"| Express
        Express -->|"renders views"| EJS
        Express -->|uses| Auth
        Express -->|handles| Routes
        Config -->|provides| Express
    end

    %% Views
    subgraph "Views (EJS Templates)"
        direction TB
        Home["Home Page"]:::frontend
        Login["Login Page"]:::frontend
        Register["Register Page"]:::frontend
        SecretPage["Secret Display"]:::frontend
        Header["Header Partial"]:::frontend
        Footer["Footer Partial"]:::frontend
        Routes -->|renders| Home
        Routes -->|renders| Login
        Routes -->|renders| Register
        Routes -->|renders| SecretPage
        Home --> Header
        Home --> Footer
        Login --> Header
        Login --> Footer
        Register --> Header
        Register --> Footer
        SecretPage --> Header
        SecretPage --> Footer
    end

    %% Data Layer
    subgraph "Data Layer"
        direction TB
        Mongoose["Mongoose ORM"]:::backend
        MongoDB["MongoDB Atlas"]:::db
        Express -->|"DB operations via Mongoose"| Mongoose
        Mongoose -->|CRUD| MongoDB
    end

    Browser -->|"JWT in HTTP-only Cookies"| Auth
    Auth -->|"validates & signs JWT"| Browser

    %% Click Events
    click Express "https://github.com/villan7667/secrets-7667/blob/main/index.js"
    click Auth "https://github.com/villan7667/secrets-7667/blob/main/index.js"
    click Routes "https://github.com/villan7667/secrets-7667/blob/main/index.js"
    click Config "https://github.com/villan7667/secrets-7667/blob/main/.env"
    click CSS "https://github.com/villan7667/secrets-7667/blob/main/public/css/styles.css"
    click JS "https://github.com/villan7667/secrets-7667/blob/main/public/js/script.js"
    click Home "https://github.com/villan7667/secrets-7667/blob/main/views/home.ejs"
    click Login "https://github.com/villan7667/secrets-7667/blob/main/views/login.ejs"
    click Register "https://github.com/villan7667/secrets-7667/blob/main/views/register.ejs"
    click SecretPage "https://github.com/villan7667/secrets-7667/blob/main/views/secret.ejs"
    click Header "https://github.com/villan7667/secrets-7667/blob/main/views/partials/header.ejs"
    click Footer "https://github.com/villan7667/secrets-7667/blob/main/views/partials/footer.ejs"
    click Mongoose "https://github.com/villan7667/secrets-7667/blob/main/index.js"
    click README "https://github.com/villan7667/secrets-7667/blob/main/README.md"
    click packageJson "https://github.com/villan7667/secrets-7667/blob/main/package.json"
    click packageLock "https://github.com/villan7667/secrets-7667/blob/main/package-lock.json"

    %% Styles
    classDef frontend fill:#D6EAF8,stroke:#3498DB,color:#1B4F72;
    classDef backend fill:#D5F5E3,stroke:#27AE60,color:#145A32;
    classDef db fill:#FCF3CF,stroke:#F1C40F,color:#7D6608;
    classDef auth fill:#FADBD8,stroke:#E74C3C,color:#641E16;
    classDef config fill:#FCF3D9,stroke:#F39C12,color:#7E5109;
```
