# devtecnologirl/portifolio-pessoal architecture

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

- Interactive diagram: https://gitdiagram.com/devtecnologirl/portifolio-pessoal
- Repository: https://github.com/devtecnologirl/portifolio-pessoal

## Overview

##### Project type and purpose
- This is a single‐page application (SPA) built with Vue.js (via Vue CLI) and Quasar variables, intended as a personal portfolio website.
- Its role is purely front-end: presenting your resume (PDF), projects, experience, contact form, etc., all statically hosted.

##### File structure
- Top-level “3.0/meu-portifolio” contains the Vue project created by `vue create`.
- “public/” holds static assets (index.html, cvcamilly.pdf).
- “src/” contains:
- App.vue – root component
- main.js – application entry point
- assets/ – global CSS files (base.css, main.css)
- components/ – Vue UI components (MainHeader, MyAbout, MyProjects, etc.)
- stores/ – state management modules (navigation.js, splash.js)
- Configuration files: package.json (dependencies), vite.config.js (build config), jsconfig.json (editor paths), .gitignore, .vscode settings.

##### Review the README
- Instructs installing Vue CLI, creating the project, and running `npm run serve`.
- No backend or API calls are defined here; it’s a static SPA.

##### Main components and their relationships
a. Developer workstation – uses Git + Node/npm + Vue CLI →
b. Source code (src/, public/) →
c. Vite build process (vite.config.js) bundles JS/CSS/assets →
d. Production output (dist/) →
e. Static web server/CDN (e.g., GitHub Pages, Netlify) →
f. Client browser loads index.html →
g. main.js bootstraps Vue app →
h. App.vue + child components render UI →
i. Components read/write state via stores (navigation, splash) →
j. User interacts, navigates to sections (MyAbout, MyProjects, MyContact).

##### Architectural patterns and design principles
- Component-based UI (Vue single-file components).
- Unidirectional data flow via centralized stores.
- Separation of concerns:
- Presentation layer (Vue components + CSS)
- State layer (stores)
- Build layer (Vite)
- Deployment layer (static hosting).
- Convention-based routing (via component names and conditional rendering, not a full router).

##### Technologies, frameworks, and libraries
- Vue.js 3 (CLI, single-file components)
- Vite (fast bundler/dev server)
- Quasar variables (SASS/CSS theming)
- npm (package management)
- Git (version control)

##### Essential elements
- Clear, descriptive labels on every component and pipeline stage.
- Optional: note version control (.git) and local dev server (npm run serve).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Development Environment"
        Dev["Developer Workstation"]:::dev
        Git["Source Code Repository\n(3.0/meu-portifolio/)"]:::dev
    end
    Dev -->|git push| Git

    subgraph "Build/CI Pipeline"
        Vite["Build Pipeline\n(Vite)"]:::build
        Config["vite.config.js"]:::build
        Package["package.json"]:::build
    end
    Git -->|npm run build| Vite
    Vite --> Config
    Vite --> Package

    subgraph "Hosting"
        Host["Static Host/CDN"]:::hosting
    end
    Vite -->|deploy| Host

    subgraph "Client Browser"
        Browser["Client Browser"]:::runtime
        Index["index.html"]:::runtime
        MainJS["main.js"]:::runtime
        App["App.vue"]:::runtime
        subgraph "Components"
            MH["MainHeader.vue"]:::runtime
            MAp["MyApresentation.vue"]:::runtime
            MAb["MyAbout.vue"]:::runtime
            MP["MyProjects.vue"]:::runtime
            ME["MyExperience.vue"]:::runtime
            MS["MyStudy.vue"]:::runtime
            MC["MyContact.vue"]:::runtime
            SS["SocialSide.vue"]:::runtime
            SP["SplashScreen.vue"]:::runtime
        end
        subgraph "Stores"
            Nav["navigation.js"]:::runtime
            Splash["splash.js"]:::runtime
        end
        Assets["assets/\n(base.css, main.css)"]:::runtime
        QVars["quasar-variables.sass"]:::runtime
    end
    Host -->|GET /index.html| Browser
    Browser -->|load| Index
    Index -->|include| MainJS
    MainJS -->|init| App
    App -->|"Vue render"| Components
    Components -->|"store.commit"| Stores
    App -->|"import CSS"| Assets
    App -->|"import theming"| QVars

    click Git "https://github.com/devtecnologirl/portifolio-pessoal/tree/main/3.0/meu-portifolio/"
    click Config "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/vite.config.js"
    click Package "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/package.json"
    click Index "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/public/index.html"
    click MainJS "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/main.js"
    click App "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/App.vue"
    click MH "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MainHeader.vue"
    click MAp "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyApresentation.vue"
    click MAb "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyAbout.vue"
    click MP "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyProjects.vue"
    click ME "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyExperience.vue"
    click MS "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyStudy.vue"
    click MC "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/MyContact.vue"
    click SS "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/SocialSide.vue"
    click SP "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/components/SplashScreen.vue"
    click Nav "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/stores/navigation.js"
    click Splash "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/stores/splash.js"
    click Assets "https://github.com/devtecnologirl/portifolio-pessoal/tree/main/3.0/meu-portifolio/src/assets/"
    click QVars "https://github.com/devtecnologirl/portifolio-pessoal/blob/main/3.0/meu-portifolio/src/quasar-variables.sass"

    classDef dev fill:#dddddd,stroke:#333,stroke-width:1px;
    classDef build fill:#ff8800,stroke:#333,stroke-width:1px;
    classDef hosting fill:#0088ff,stroke:#333,stroke-width:1px;
    classDef runtime fill:#88cc88,stroke:#333,stroke-width:1px;
```
