# phoenixcodergit/facturacion_electronica_bolivia_compra_venta architecture

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

- Interactive diagram: https://gitdiagram.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta
- Repository: https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta

## Overview

##### Project type and purpose
- This is a full-stack web application for “Facturación Electrónica con firma digital” (electronic invoicing with digital signature), targeting the Compra-Venta sector in Bolivia and integrating with national tax authority systems.
- The backend is a PHP-based MVC app (controllers, models, views) and the frontend is a JavaScript SPA (built via Webpack).

##### File structure
- Top level:
- index.php (PHP entry point)
- dist/ (compiled PHP + assets ready for deployment)
- src/ (JS source code, webpack.config.js, package.json)
- Inside dist/App:
- ajax/ (AJAX endpoints for login & session)
- controladores/ (MVC controllers for Facturas, Clientes, Usuarios, etc.)
- modelos/ (database‐mapping models)
- lib/ (Database connection, routing, base Model/View classes)
- config/ (constants, access.json)
- Routing is handled by App/lib/routes.php and .htaccess in dist.
- The build tool (Webpack) bundles JS from src/index.js into a dist artifact served by the PHP app.

##### README
- Confirms electronic invoicing with digital signature, authorized by the national tax authority.
- Implies an external government signature API or web service and a local relational database (e.g., MySQL/PostgreSQL).

a. Main components:
- Browser (User Interface)
- Frontend JS App (Webpack bundle)
- Backend PHP MVC App
- Database (e.g., MySQL)
- External Tax Authority Signature API
- (Optional) File Storage for signed documents
b. Relationships & interactions:
1. User → Browser loads index.php → serves HTML/JS/CSS
2. Browser ↔ AJAX → PHP controllers (via App/ajax & routes)
3. PHP controllers → Models → Database (CRUD ops)
4. PHP controllers → Digital Signature API → handle signed payloads
5. PHP → View templates → HTML responses (where applicable)
c. Architectural patterns & principles:
- MVC (controllers/models/views)
- Single-page/partial-page front end with AJAX calls
- Layered architecture (Presentation → Business logic → Persistence)
- Build-time bundling (Webpack) separated from runtime PHP
d. Key technologies & libraries:
- PHP 7+ (App/lib/Database.php, PrincipalModelo, PrincipalVista)
- Apache + .htaccess for routing
- Webpack + npm (src/index.js, package.json)
- JSON config (App/config/access.json)
- Digital signature integration (government API)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend"
        Browser["Browser UI / HTML Entry Point"]:::frontend
        FrontendSource["JS Source (src/index.js)"]:::frontend
        WebpackConfig["Webpack Configuration"]:::frontend
        PackageJSON["npm Package Definition"]:::frontend
        DistBundle["Compiled Deployment Bundle"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend"
        Htaccess["Apache Routing Rules (.htaccess)"]:::backend
        Router["Route Resolver (routes.php)"]:::backend
        Controllers["PHP MVC Controllers (15+ controllers)"]:::backend
        subgraph "AJAX Endpoints"
            AjaxSession["Session AJAX Endpoint"]:::backend
            AjaxLogin["Login AJAX Endpoint"]:::backend
        end
        Models["PHP Models"]:::backend
        DBConn["Database Connection Library"]:::backend
        BaseClasses["Base Model & View Classes"]:::backend
        ErrorLog["Error Logging Utility"]:::backend
        ConfigConst["Application Configuration Constants"]:::backend
        ConfigAccess["Access Configuration (access.json)"]:::backend
        ViewTemplates["View Templates"]:::backend
    end

    %% Database and External
    DB["Database (MySQL/PostgreSQL)"]:::db
    TaxAPI["Tax Authority Signature API"]:::external

    %% Build Pipeline
    FrontendSource -->|"bundled by Webpack"| DistBundle
    WebpackConfig --> DistBundle
    PackageJSON --> DistBundle

    %% Client-Server Flow
    Browser -->|"HTTP Request"| DistBundle
    DistBundle -->|"uses .htaccess"| Htaccess
    Htaccess -->|"routes to"| Router
    Router --> Controllers

    %% AJAX Flow
    Browser -->|"AJAX/JSON"| AjaxSession
    Browser -->|"AJAX/JSON"| AjaxLogin
    AjaxSession --> Controllers
    AjaxLogin --> Controllers

    %% MVC Interactions
    Controllers --> Models
    Controllers --> ViewTemplates
    Controllers -->|"uses DB driver"| DBConn
    Models --> DB
    Controllers --> ErrorLog
    Controllers --> ConfigConst
    Controllers --> ConfigAccess
    Controllers --> BaseClasses

    %% External Service
    Controllers -->|"signature request XML/JSON over HTTPS"| TaxAPI
    TaxAPI -.->|"callback async"| Controllers

    %% Click Events
    click Browser "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/index.php"
    click FrontendSource "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/src/index.js"
    click WebpackConfig "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/webpack.config.js"
    click PackageJSON "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/package.json"
    click DistBundle "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/tree/main/dist/"
    click Htaccess "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/.htaccess"
    click Router "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/lib/routes.php"
    click Controllers "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/tree/main/dist/App/controladores/"
    click AjaxSession "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/ajax/SessionAjax.php"
    click AjaxLogin "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/ajax/loginAjax.php"
    click Models "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/tree/main/dist/App/modelos/"
    click DBConn "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/lib/Database.php"
    click BaseClasses "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/lib/PrincipalModelo.php"
    click BaseClasses "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/lib/PrincipalVista.php"
    click ErrorLog "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/lib/ErrorLog.php"
    click ConfigConst "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/config/Constants.php"
    click ConfigAccess "https://github.com/phoenixcodergit/facturacion_electronica_bolivia_compra_venta/blob/main/dist/App/config/access.json"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef backend fill:#87CEEB,stroke:#333,stroke-width:1px
    classDef db fill:#9ACD32,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
```
