# atechpro/lenogletterv2 architecture

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

- Interactive diagram: https://gitdiagram.com/atechpro/lenogletterv2
- Repository: https://github.com/atechpro/lenogletterv2

## Overview

##### Project type and purpose
- This is a full-stack, monolithic web application built with Python and Flask.
- Its main goal is to let users log in, select letter templates, generate letters (view as PDF in-browser), and export them to Excel.

##### File structure
- Top-level entrypoints:
- letterweb.py – defines Flask routes (HTTP handlers, session management, user flows)
- letterbackend.py – contains core business logic (letter templating, PDF & Excel generation).
- Persistence layer:
- databases/lenogdb.py – custom DB adapter (likely SQLite or flat-file storage).
- Presentation:
- templates/ – Jinja2 HTML templates for each view (login, register, main, PDF viewer, etc.)
- Deployment:
- Dockerfile & docker-compose.yml – containerize the Flask app for any host (e.g., DigitalOcean droplet).

##### Extract architectural insights from the README
- MVC-style pattern: Routes ⇒ business logic ⇒ data layer ⇒ templates ⇒ client.
- PDF viewer integrated in-browser, Excel export endpoint.
- Docker-ready for CI/CD, hosted behind HTTP on a cloud VM.

## Diagram (Mermaid)

```mermaid
flowchart TD
    direction TB

    Client["Browser (UI)"]:::client
    Infra["DigitalOcean VM"]:::infra
    Infra -->|hosts| DockerContainer

    subgraph "Docker Container"
        direction TB
        DockerContainer["Docker Container"]:::container

        FlaskApp["Flask: letterweb.py"]:::web
        LetterBL["Business Logic: letterbackend.py"]:::logic
        DBAdapter["DB Adapter: databases/lenogdb.py"]:::db
        DB["Database"]:::db

        subgraph "Templates"
            direction TB
            Tlogin["login.html"]:::template
            Tregister["register.html"]:::template
            Tmain["main.html"]:::template
            Tviewpdf["view_pdf.html"]:::template
            Texcel["excelviewer.html"]:::template
            Tack["ack.html"]:::template
            Ttoc["toc.html"]:::template
            Tscope["scope.html"]:::template
            Tclhtml["cl.html"]:::template
        end

        subgraph "Static Assets"
            direction TB
            CSS["form.css"]:::static
            Icons["icons/"]:::static
            JS["cl.js"]:::static
        end

        Dockerfile["Dockerfile"]:::infra
        Compose["docker-compose.yml"]:::infra

    end

    Client -->|HTTP request/response| FlaskApp
    FlaskApp -->|calls| LetterBL
    LetterBL -->|queries| DBAdapter
    DBAdapter -->|reads/writes| DB
    LetterBL -->|renders via Jinja2| Tmain
    FlaskApp -->|serves templates| Tlogin
    FlaskApp -->|serves templates| Tregister
    FlaskApp -->|serves templates| Tviewpdf
    FlaskApp -->|serves templates| Texcel
    FlaskApp -->|serves templates| Tack
    FlaskApp -->|serves templates| Ttoc
    FlaskApp -->|serves templates| Tscope
    FlaskApp -->|serves templates| Tclhtml
    FlaskApp -->|serves static| CSS
    FlaskApp -->|serves static| Icons
    FlaskApp -->|executes client script| JS
    LetterBL -->|generates PDF/Excel| FlaskApp

    classDef client fill:#d0e7ff,stroke:#0366d6,color:#0366d6;
    classDef infra fill:#f0f0f0,stroke:#888888,color:#333333;
    classDef container fill:#e6ffe6,stroke:#2c662d,color:#2c662d;
    classDef web fill:#d9f7be,stroke:#389e0d,color:#389e0d;
    classDef logic fill:#fff1b8,stroke:#d48806,color:#d48806;
    classDef db fill:#ffe7ba,stroke:#d46b08,color:#d46b08;
    classDef template fill:#fff7e6,stroke:#925800,color:#925800;
    classDef static fill:#f9f0ff,stroke:#531dab,color:#531dab;

    click FlaskApp "https://github.com/atechpro/lenogletterv2/blob/flask-ver/letterweb.py"
    click LetterBL "https://github.com/atechpro/lenogletterv2/blob/flask-ver/letterbackend.py"
    click DBAdapter "https://github.com/atechpro/lenogletterv2/blob/flask-ver/databases/lenogdb.py"
    click Tlogin "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/login.html"
    click Tregister "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/register.html"
    click Tmain "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/main.html"
    click Tviewpdf "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/view_pdf.html"
    click Texcel "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/excelviewer.html"
    click Tack "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/ack.html"
    click Ttoc "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/toc.html"
    click Tscope "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/scope.html"
    click Tclhtml "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/cl.html"
    click CSS "https://github.com/atechpro/lenogletterv2/blob/flask-ver/static/form.css"
    click Icons "https://github.com/atechpro/lenogletterv2/tree/flask-ver/static/icons/"
    click JS "https://github.com/atechpro/lenogletterv2/blob/flask-ver/templates/cl.js"
    click Dockerfile "https://github.com/atechpro/lenogletterv2/tree/flask-ver/dockerfile"
    click Compose "https://github.com/atechpro/lenogletterv2/blob/flask-ver/docker-compose.yml"
```
