# kenken64/dynaform architecture

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

- Interactive diagram: https://gitdiagram.com/kenken64/dynaform
- Repository: https://github.com/kenken64/dynaform

## Overview

##### Project type and purpose
- This is a containerized, full-stack, microservices application for converting PDF forms to JSON, analyzing form fields with an LLM, and managing form data.
- Users upload forms via an Angular frontend; a Node.js/Express API orchestrates PDF-to-PNG conversion, LLM-based field extraction, and persistent storage in MongoDB.

##### File structure
- Top-level “dynaform” folder: Angular (TypeScript) app + nginx config → the browser UI.
- “describeImge” folder: Node.js/Express API (src/ → dist/), with Controllers/Services/Middleware/Routes → MVC pattern.
- “pdf-png” folder: Python Flask service to convert PDFs to PNG.
- “ollama” folder: Docker image hosting the LLM (qwen2.5vl) for multimodal inference.
- “mongodb” folder: Dockerfile, init-scripts, configs for MongoDB; security docs and scripts for role-based access.
- Dozens of start-and-setup shell/PowerShell scripts plus multiple docker-compose.*.yml files to orchestrate dev, prod, secure, macOS, debug stacks.

##### README insights
- Orchestrates five main containers via Docker Compose:
- Frontend (Angular + Nginx) at port 4201
- API (Node/Express) at port 3000
- PDF Converter (Flask) at port 5001
- LLM service (Ollama) at port 11434
- MongoDB at port 27017
- Emphasizes on-the-fly rebuilds, secure production setup (Docker secrets), and cross-platform scripts.

##### Elements
- Rectangle with folded corner for Frontend
- Rounded rectangles for microservices (API, Flask, Ollama)
- Blue for UI components
- Green for business logic/microservices
- Orange for data stores
- Annotations for build/orchestration scripts (e.g., docker-compose .yml files, setup scripts)
- Notes on secret management (Docker secrets, .env files)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        Browser["User Web Browser"]:::ui
        Frontend["Frontend (Angular + Nginx)\nPort 4201"]:::ui
    end

    subgraph "Application Layer"
        API["API Service\nNode.js/Express\nPort 3000"]:::service
        PDF["PDF Converter Service\nFlask\nPort 5001"]:::service
        LLM["LLM Service\nOllama\nPort 11434"]:::service
    end

    subgraph "Data Layer"
        Mongo["MongoDB\nPort 27017"]:::db
    end

    subgraph "Support Components"
        Compose["Docker Compose Files"]:::scripts
        Scripts["Orchestration & Setup Scripts"]:::scripts
    end

    Browser -->|"HTTP"| Frontend
    Frontend -->|"REST /api/*"| API
    API -->|"HTTP /conversion/pdf-to-png"| PDF
    API -->|"HTTP GPU inference"| LLM
    API -->|"MongoDB Driver"| Mongo

    Compose -.-> API
    Compose -.-> Frontend
    Compose -.-> PDF
    Compose -.-> LLM
    Compose -.-> Mongo
    Scripts -.-> Compose

    click Frontend "https://github.com/kenken64/dynaform/tree/main/dynaform/"
    click Frontend "https://github.com/kenken64/dynaform/tree/main/dynaform/src/"
    click Frontend "https://github.com/kenken64/dynaform/blob/main/dynaform/nginx.conf"
    click Frontend "https://github.com/kenken64/dynaform/tree/main/dynaform/Dockerfile"
    click API "https://github.com/kenken64/dynaform/tree/main/describeImge/"
    click API "https://github.com/kenken64/dynaform/tree/main/describeImge/src/"
    click API "https://github.com/kenken64/dynaform/tree/main/describeImge/dist/"
    click API "https://github.com/kenken64/dynaform/tree/main/describeImge/Dockerfile"
    click PDF "https://github.com/kenken64/dynaform/blob/main/pdf-png/app.py"
    click PDF "https://github.com/kenken64/dynaform/tree/main/pdf-png/Dockerfile"
    click LLM "https://github.com/kenken64/dynaform/tree/main/ollama/"
    click LLM "https://github.com/kenken64/dynaform/tree/main/ollama/Dockerfile"
    click LLM "https://github.com/kenken64/dynaform/blob/main/ollama/entrypoint.sh"
    click Mongo "https://github.com/kenken64/dynaform/tree/main/mongodb/"
    click Mongo "https://github.com/kenken64/dynaform/tree/main/mongodb/Dockerfile"
    click Mongo "https://github.com/kenken64/dynaform/blob/main/mongodb/mongod.conf"
    click Mongo "https://github.com/kenken64/dynaform/blob/main/mongodb/init-scripts/01-create-app-user.js"
    click Mongo "https://github.com/kenken64/dynaform/blob/main/mongodb/init-scripts/01-init-database.js"
    click Mongo "https://github.com/kenken64/dynaform/blob/main/mongodb/init-scripts/02-create-users.sh"
    click Compose "https://github.com/kenken64/dynaform/blob/main/docker-compose.yml"
    click Compose "https://github.com/kenken64/dynaform/blob/main/docker-compose.dev.yml"
    click Compose "https://github.com/kenken64/dynaform/blob/main/docker-compose.secure.yml"
    click Compose "https://github.com/kenken64/dynaform/blob/main/docker-compose.debug.yml"
    click Compose "https://github.com/kenken64/dynaform/blob/main/docker-compose.macos.yml"
    click Scripts "https://github.com/kenken64/dynaform/blob/main/start-dev.sh"
    click Scripts "https://github.com/kenken64/dynaform/blob/main/start-secure.sh"
    click Scripts "https://github.com/kenken64/dynaform/blob/main/setup-mongodb-security.sh"
    click Scripts "https://github.com/kenken64/dynaform/blob/main/setup-ollama-models.sh"

    classDef ui fill:#D0E8FF,stroke:#0366D6,color:#0366D6;
    classDef service fill:#DFFFD0,stroke:#228B22,color:#228B22;
    classDef db fill:#FFEBCD,stroke:#FF8C00,color:#FF8C00;
    classDef scripts fill:#F0F0F0,stroke:#999,color:#666;
```
