# miguel-educa/daw-proyecto architecture

> Architecture diagram of the GitHub repository miguel-educa/daw-proyecto, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/miguel-educa/daw-proyecto
- Repository: https://github.com/miguel-educa/daw-proyecto

## Overview

##### Project type and purpose
- This is a full-stack web application called “Pass Warriors,” a secure password manager with storage, sharing, and random password generation.
- The README and file tree confirm three layers: a PHP-based REST API backend (api/), a relational database schema (db/), and a Vue.js frontend (frontend/).

##### File structure
- Top level:
- api/ – PHP REST API (entry point index.php, route files, controllers/, models/, schemas/, tools/).
- frontend/ – Vue 3 single-page application (components/, views/, router/, stores/, public/).
- api/controllers and api/models follow an MVC-style organization.
- Configuration/deployment files: example-env, .htaccess, package.json, vite.config.js.
- README.md pointers describe each module.

##### Key insights from README
- Backend: handles authentication (sessions, 2FA, account recovery), folder/password CRUD, sharing.
- Database: MySQL with tables for users, sessions, passwords, folders, shared_passwords, account_recovery.
- Frontend: Vue.js + Bulma CSS, components for login/register, vault UI, password generator, audit, settings.

##### Detailed breakdown of API sub-components (optional inset)
- Controllers: Session, User, 2FA, Passwords, Folders, SharedPasswords
- Tools: DB, Encrypt, GoogleAuthenticator, Request/Response, HttpCode, SessionDuration
- Models & Schemas: match each table/entity
- Route files: map HTTP methods to controllers

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Layer"
        VueSPA["Vue.js SPA"]:::frontend
        Router["Router (vue-router)"]:::frontend
        Stores["State Stores"]:::frontend
        Components["UI Components"]:::frontend
        Views["Views"]:::frontend
    end

    %% API Layer
    subgraph "API Layer"
        APIEntry["API Entry Point\n(index.php)"]:::backend

        subgraph "API Routes"
            RouteSession["session.php"]:::backend
            Route2FA["2fa.php"]:::backend
            RouteUsers["users.php"]:::backend
            RoutePasswords["passwords.php"]:::backend
            RouteFolders["folders.php"]:::backend
            RouteShared["shared-passwords.php"]:::backend
            RouteRecovery["account-recovery.php"]:::backend
        end

        subgraph "Controllers"
            ControllersGroup["Controllers"]:::backend
        end

        subgraph "Models"
            ModelsGroup["Models"]:::backend
        end

        subgraph "Schemas"
            SchemasGroup["Schemas"]:::backend
        end

        subgraph "Tools"
            ToolsGroup["Tools"]:::backend
            External2FA["Google Authenticator\n(External)"]:::external
        end
    end

    %% Data Layer
    subgraph "Data Layer"
        MySQLDB["MySQL Database"]:::db
        SQLScript["DB Schema SQL"]:::db
        ERDiagram["ER Diagram"]:::db
        RelDiagram["Relational Diagram"]:::db
    end

    %% Connections
    VueSPA --> Router
    VueSPA --> Stores
    Router -->|calls API| APIEntry
    Stores -->|calls API| APIEntry

    APIEntry --> API_Routes[/"Mapped Routes"/]
    API_Routes --> RouteSession
    API_Routes --> Route2FA
    API_Routes --> RouteUsers
    API_Routes --> RoutePasswords
    API_Routes --> RouteFolders
    API_Routes --> RouteShared
    API_Routes --> RouteRecovery

    API_Routes --> ControllersGroup
    ControllersGroup --> ModelsGroup
    ControllersGroup --> ToolsGroup
    ToolsGroup --> External2FA
    ModelsGroup --> MySQLDB

    SQLScript -.-> MySQLDB
    ERDiagram -.-> MySQLDB
    RelDiagram -.-> MySQLDB

    %% Click Events
    click VueSPA "https://github.com/miguel-educa/daw-proyecto/tree/main/frontend/src/"
    click Router "https://github.com/miguel-educa/daw-proyecto/blob/main/frontend/src/router/index.js"
    click Stores "https://github.com/miguel-educa/daw-proyecto/tree/main/frontend/src/stores/"
    click Components "https://github.com/miguel-educa/daw-proyecto/tree/main/frontend/src/components/"
    click Views "https://github.com/miguel-educa/daw-proyecto/tree/main/frontend/src/views/"
    click APIEntry "https://github.com/miguel-educa/daw-proyecto/blob/main/api/index.php"
    click RouteSession "https://github.com/miguel-educa/daw-proyecto/blob/main/api/session.php"
    click Route2FA "https://github.com/miguel-educa/daw-proyecto/blob/main/api/2fa.php"
    click RouteUsers "https://github.com/miguel-educa/daw-proyecto/blob/main/api/users.php"
    click RoutePasswords "https://github.com/miguel-educa/daw-proyecto/blob/main/api/passwords.php"
    click RouteFolders "https://github.com/miguel-educa/daw-proyecto/blob/main/api/folders.php"
    click RouteShared "https://github.com/miguel-educa/daw-proyecto/blob/main/api/shared-passwords.php"
    click RouteRecovery "https://github.com/miguel-educa/daw-proyecto/blob/main/api/account-recovery.php"
    click ControllersGroup "https://github.com/miguel-educa/daw-proyecto/tree/main/api/controllers/"
    click ModelsGroup "https://github.com/miguel-educa/daw-proyecto/tree/main/api/models/"
    click SchemasGroup "https://github.com/miguel-educa/daw-proyecto/tree/main/api/schemas/"
    click ToolsGroup "https://github.com/miguel-educa/daw-proyecto/tree/main/api/tools/"
    click SQLScript "https://github.com/miguel-educa/daw-proyecto/blob/main/db/db_pass_warriors_structure.sql"
    click ERDiagram "https://github.com/miguel-educa/daw-proyecto/blob/main/assets/modelo-entidad-relacion.drawio"
    click RelDiagram "https://github.com/miguel-educa/daw-proyecto/blob/main/assets/modelo-relacional.drawio"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#0000FF,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#006400,stroke-width:1px
    classDef db fill:#FFA500,stroke:#FF8C00,stroke-width:1px
    classDef external fill:#F5F5F5,stroke:#A9A9A9,stroke-dasharray: 5 5,stroke-width:1px
```
