# alfonsomedina/fastapitest architecture

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

- Interactive diagram: https://gitdiagram.com/alfonsomedina/fastapitest
- Repository: https://github.com/alfonsomedina/fastapitest

## Overview

##### Project type and purpose
- This is primarily a FastAPI-based backend service (monolithic HTTP API) whose job is to process and manage PDF documents, integrate with external SOAP/Web‐service endpoints (e.g. IPAS, SFE, WIPO), send emails, and expose endpoints for frontend or third-party callers. There is a minimal static front-end (HTML/CSS under a `static` folder), but the heart of the system is the FastAPI application in `main.py`.

##### File structure
- Top-level entry points:
- `main.py` – defines FastAPI app and HTTP routes
- `Create-serv_fastApi.py`, `Create-serv_flask.py`, `CreateService.py` – helper or legacy service‐bootstrappers
- `compile/` – scripts to compile `.py` to `.pyc`
- Business logic modules:
- `dinapi/` – SFE‐related logic (`sfe.py`)
- `publicaciones/` – “publicaciones” feature set
- `wipo/` – WIPO integration
- Models:
- `models/InsertUserDocModel.py`, `insertRegModel.py`, `insertRenModel.py` – Pydantic or data‐transfer schemas
- PDF and document processing:
- `pdf/` – sample PDF documents
- `auto_process.py`, `getFileDoc.py`, `tools/doc_pdf.py` – PDF generation/extraction
- `temp_pdf/` – temporary output
- Email sending:
- `email_pdf_AG.py`, `email_reg_sfe.py`, `email_ren_sfe.py`, `tools/send_mail.py`
- Tools and helpers:
- `tools/` – various utilities (SOAP wrappers, database connectors in `connect.py`, data formatters, test scripts)
- Static assets:
- `static/css/style.css`, `registroMOPC.html`

##### README for additional insights
- Confirms it’s a FastAPI service launched via `uvicorn main:app --host 0.0.0.0 --port 3600`
- No explicit database folder, so persistence likely happens via SOAP calls or direct DB drivers in `tools/connect.py`
- Integration points to Nuxeo REST API, SOAP endpoints for process and action queries

a. Main components
- Client / Static UI (HTML/CSS)
- FastAPI HTTP Server (main.py)
- Pydantic Models (models/)
- Business Logic Modules (dinapi/, publicaciones/, wipo/)
- PDF Processor (auto_process, tools/doc_pdf)
- Email Sender (email_*.py, tools/send_mail)
- Utility Layer (tools/)
- External Services:
- IPAS Web Service
- SFE/SFE_REGISTRO SOAP Service
- WIPO Service
- Nuxeo REST API
- Data Store/DB (if any, or represented by SOAP backends)

b. Relationships and interactions
- HTTP requests flow from Client → FastAPI Controller
- Controllers validate payloads against Pydantic Models → invoke Business Logic
- Business Logic orchestrates:
- PDF creation / extraction via PDF Processor
- Data storage or retrieval via SOAP or DB connector
- Email dispatch via Email Sender
- Business Logic may call Utility Layer for shared routines
- External calls from Business Logic → External Services (SOAP or REST)
- Responses propagate back through the same layers to the client

c. Architectural patterns and design principles
- Layered architecture (Presentation → API Layer → Domain/Business Logic → Infrastructure/Utilities → External Systems)
- Separation of concerns:
- Pydantic models purely for validation/serialization
- Business modules grouped by feature (dinapi, publicaciones, wipo)
- Utility scripts factored under `tools/`
- Single monolith – no separate microservices

d. Key technologies, frameworks, libraries
- FastAPI + Uvicorn (ASGI server)
- Pydantic for models
- Python stdlib + third-party packages (as per requirements.txt)
- HTTP clients or `zeep`/`suds` for SOAP
- External REST integration with Nuxeo
- Virtualenv for environment isolation

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation/UI"
        UI_CSS["style.css"]:::presentation
        UI_HTML["registroMOPC.html"]:::presentation
    end

    %% API Layer
    subgraph "API Layer"
        API["FastAPI App"]:::api
        Boot1["Create-serv_fastApi.py"]:::api
        Boot2["Create-serv_flask.py"]:::api
        Boot3["CreateService.py"]:::api
    end

    %% Models
    subgraph "Pydantic Models"
        M1["InsertUserDocModel.py"]:::model
        M2["insertRegModel.py"]:::model
        M3["insertRenModel.py"]:::model
    end

    %% Business Logic
    subgraph "Business Logic"
        subgraph "SFE (dinapi)"
            SFE["dinapi/sfe.py"]:::biz
        end
        subgraph "Publicaciones"
            Pub1["Publicaciones.py"]:::biz
            Pub2["pub_2023.py"]:::biz
        end
        subgraph "WIPO Integration"
            WIP1["function_for_reception_in.py"]:::biz
            WIP2["insertGroupProcessMEA.py"]:::biz
            WIP3["ipas.py"]:::biz
        end
    end

    %% PDF Processor
    subgraph "PDF Processor"
        AP["auto_process.py"]:::infra
        GF["getFileDoc.py"]:::infra
        DP["tools/doc_pdf.py"]:::infra
        FULL["compile/full.py"]:::infra
    end

    %% Email Sender
    subgraph "Email Sender"
        E1["email_pdf_AG.py"]:::infra
        E2["email_reg_sfe.py"]:::infra
        E3["email_ren_sfe.py"]:::infra
        SM["tools/send_mail.py"]:::infra
    end

    %% Utilities
    subgraph "Utilities"
        C1["tools/connect.py"]:::infra
        B64["tools/base64Decode.py"]:::infra
        DF["tools/data_format.py"]:::infra
        IPDOC["tools/ipas_document.py"]:::infra
        PS["tools/params_seting.py"]:::infra
        SS["tools/service_system.py"]:::infra
    end

    %% External Services
    subgraph "External Services"
        ES1["IPAS Web Service"]:::external
        ES2["SFE/SFE_REGISTRO SOAP"]:::external
        ES3["WIPO Service"]:::external
        ES4["Nuxeo REST API"]:::external
        SMTP["SMTP"]:::external
    end

    %% Connections
    UI_CSS -->|HTTP| API
    UI_HTML -->|HTTP| API

    API -->|validate JSON| M1
    API -->|validate JSON| M2
    API -->|validate JSON| M3

    API -->|invoke| SFE
    API -->|invoke| Pub1
    API -->|invoke| Pub2
    API -->|invoke| WIP1
    API -->|invoke| WIP2
    API -->|invoke| WIP3

    SFE -->|SOAP| ES1
    SFE -->|SOAP| ES2

    Pub1 -->|REST| ES4
    Pub2 -->|REST| ES4

    WIP1 -->|SOAP| ES3
    WIP2 -->|SOAP| ES3
    WIP3 -->|SOAP| ES3

    SFE --> AP
    Pub1 --> AP
    WIP1 --> AP

    AP --> GF
    GF --> DP
    DP --> FULL

    SFE --> C1
    Pub1 --> C1
    WIP1 --> C1

    SFE --> E1
    SFE --> E2
    SFE --> E3
    Pub1 --> E1
    Pub2 --> E2
    WIP1 --> E3

    E1 -->|SMTP| SMTP
    E2 -->|SMTP| SMTP
    E3 -->|SMTP| SMTP
    SM -->|SMTP| SMTP

    %% Bootstrap connections
    Boot1 --> API
    Boot2 --> API
    Boot3 --> API

    %% Click Events
    click UI_CSS "https://github.com/alfonsomedina/fastapitest/blob/main/static/css/style.css"
    click UI_HTML "https://github.com/alfonsomedina/fastapitest/blob/main/registroMOPC.html"
    click API "https://github.com/alfonsomedina/fastapitest/blob/main/main.py"
    click Boot1 "https://github.com/alfonsomedina/fastapitest/blob/main/Create-serv_fastApi.py"
    click Boot2 "https://github.com/alfonsomedina/fastapitest/blob/main/Create-serv_flask.py"
    click Boot3 "https://github.com/alfonsomedina/fastapitest/blob/main/CreateService.py"
    click SFE "https://github.com/alfonsomedina/fastapitest/blob/main/dinapi/sfe.py"
    click Pub1 "https://github.com/alfonsomedina/fastapitest/blob/main/publicaciones/Publicaciones.py"
    click Pub2 "https://github.com/alfonsomedina/fastapitest/blob/main/publicaciones/pub_2023.py"
    click WIP1 "https://github.com/alfonsomedina/fastapitest/blob/main/wipo/function_for_reception_in.py"
    click WIP2 "https://github.com/alfonsomedina/fastapitest/blob/main/wipo/insertGroupProcessMEA.py"
    click WIP3 "https://github.com/alfonsomedina/fastapitest/blob/main/wipo/ipas.py"
    click M1 "https://github.com/alfonsomedina/fastapitest/blob/main/models/InsertUserDocModel.py"
    click M2 "https://github.com/alfonsomedina/fastapitest/blob/main/models/insertRegModel.py"
    click M3 "https://github.com/alfonsomedina/fastapitest/blob/main/models/insertRenModel.py"
    click AP "https://github.com/alfonsomedina/fastapitest/blob/main/auto_process.py"
    click GF "https://github.com/alfonsomedina/fastapitest/blob/main/getFileDoc.py"
    click DP "https://github.com/alfonsomedina/fastapitest/blob/main/tools/doc_pdf.py"
    click FULL "https://github.com/alfonsomedina/fastapitest/blob/main/compile/full.py"
    click E1 "https://github.com/alfonsomedina/fastapitest/blob/main/email_pdf_AG.py"
    click E2 "https://github.com/alfonsomedina/fastapitest/blob/main/email_reg_sfe.py"
    click E3 "https://github.com/alfonsomedina/fastapitest/blob/main/email_ren_sfe.py"
    click SM "https://github.com/alfonsomedina/fastapitest/blob/main/tools/send_mail.py"
    click C1 "https://github.com/alfonsomedina/fastapitest/blob/main/tools/connect.py"
    click B64 "https://github.com/alfonsomedina/fastapitest/blob/main/tools/base64Decode.py"
    click DF "https://github.com/alfonsomedina/fastapitest/blob/main/tools/data_format.py"
    click IPDOC "https://github.com/alfonsomedina/fastapitest/blob/main/tools/ipas_document.py"
    click PS "https://github.com/alfonsomedina/fastapitest/blob/main/tools/params_seting.py"
    click SS "https://github.com/alfonsomedina/fastapitest/blob/main/tools/service_system.py"

    %% Styles
    classDef presentation fill:#ADD8E6,stroke:#000;
    classDef api fill:#90EE90,stroke:#000;
    classDef biz fill:#FFA500,stroke:#000;
    classDef model fill:#FFFF00,stroke:#000;
    classDef infra fill:#D3D3D3,stroke:#000;
    classDef external fill:#9370DB,stroke-dasharray: 5 5,stroke:#9370DB;
```
