# refusado/gerenciar-influenciadores architecture

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

- Interactive diagram: https://gitdiagram.com/refusado/gerenciar-influenciadores
- Repository: https://github.com/refusado/gerenciar-influenciadores

## Overview

##### Project Type and Purpose
- This is a full-stack JavaScript application providing an administrative platform for managing influencers and brands.
- Frontend: Next.js (React) delivering both public routes (login/signup) and a protected admin SPA.
- Backend: Fastify-based monolithic API server that also serves the built Next.js static assets.
- Database: Relational (managed via Prisma ORM).
- External service: ViaCEP API for address lookup.

##### File Structure
- Top-level folders:
- backend/ – Fastify server, Prisma migrations, API routes, controllers, utilities, tests, Swagger docs.
- frontend/ – Next.js “app” directory, React components, hooks, API clients, Tailwind styles, config.
- Important files:
- backend/src/api-routes/public & private → delineate open vs. authenticated endpoints.
- backend/prisma/schema.prisma + migrations → data model and evolution.
- frontend/src/app/(plataform) → public login/signup pages.
- frontend/src/app/admin → admin pages and internal API clients.
- Config & tooling: ESLint, Prettier, Zod, Vitest, Supertest, Axios, TanStack Query.

##### Key Insights from README
- Authentication system securing both API and web routes.
- CRUD for influencers/brands, plus association between them.
- Data validation end-to-end (Zod + TypeScript).
- Swagger/OpenAPI docs at `/api/docs`.
- Next.js in SSG mode for public and private SPAs, served by Fastify in production.

##### Main Components
a. Client (Browser)
- Public UI (login, signup)
- Admin UI (protected dashboard pages)
b. Next.js Frontend
- App router – SSG/SSR for public pages
- Bundled React SPA for admin
- Static assets (CSS, JS)
c. Fastify Server
- Static file serving (built Next.js output)
- API router – public vs. private routes
- Controllers & business logic
- Error-handling & validation (Zod integration)
- Swagger UI endpoint
d. Prisma ORM + Database
- Schema definitions & migrations
- CRUD operations
e. External Services
- ViaCEP REST API for address lookup
f. Developer Tools (optional to show)
- Vitest/Supertest test runner
- ESLint/Prettier pipeline

##### Relationships & Data Flow
- Browser → HTTP GET/POST → Next.js pages (public)
- Browser → API calls (Axios/TanStack Query) → Fastify endpoints
- Fastify → Prisma → Database
- Fastify → Axios → ViaCEP → Fastify → Database
- Fastify → serves built Next.js static files to Browser
- Swagger UI (served by Fastify) reads OpenAPI JSON

##### Architectural Patterns & Principles
- Layered architecture: Presentation (Next.js) → API layer (Fastify routes/controllers) → Data layer (Prisma/DB).
- Separation of concerns: public vs. private API namespaces.
- End-to-end type safety & validation (TypeScript + Zod).
- Monorepo with two sub-projects sharing types and validation rules.
- SPA-style data fetching in admin using TanStack Query with optimistic updates.

##### Essential Elements to Capture
- Public vs. private route separation in both Next.js and Fastify.
- Data validation layer (Zod) at API boundary.
- API documentation endpoint (Swagger UI).
- Prisma migrations & schema as the source of truth for data model.
- Axios + TanStack Query for client-side data fetching.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser
    Browser["Client Browser"]:::external

    %% Frontend Layer
    subgraph "Frontend (Next.js)" 
        direction TB
        PublicPages["Public UI<br/>(Login/Signup)"]:::frontend
        AdminSPA["Admin SPA<br/>(Protected Dashboard)"]:::frontend
        APIClients["API Clients<br/>(Axios + TanStack Query)"]:::frontend
        SharedComponents["Shared Components & Modals"]:::frontend
        GlobalStyles["Global Styles & Config"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend (Fastify)" 
        direction TB
        ServerEntry["Server Entry Point<br/>(server.ts)"]:::backend
        AppSetup["App & Route Setup<br/>(app.ts, view-routes.ts)"]:::backend
        subgraph "API Routes"
            direction TB
            PublicAPI["Public API Routes"]:::backend
            PrivateAPI["Private API Routes"]:::backend
        end
        Controllers["Influencer Controllers"]:::backend
        Validation["Request Validation Schemas"]:::backend
        Swagger["Swagger UI<br/>(docs.ts)"]:::backend
        ErrorHandler["Error Handling & Validation"]:::backend
        subgraph "Prisma Layer"
            direction TB
            PrismaSchema["Prisma Schema"]:::db
            PrismaMigrations["Prisma Migrations"]:::db
            PrismaClientUtil["Prisma Client Utility"]:::backend
        end
        EnvUtil["Environment Config Utility"]:::backend
        ViaCEPUtil["ViaCEP Service Integration"]:::backend
        UploadUtil["Image Upload Utility"]:::backend
        Tests["Backend Tests"]:::backend
    end

    %% Database
    Database["Relational Database"]:::db

    %% External Service
    ViaCEP["ViaCEP API"]:::external

    %% Relationships
    Browser -->|"HTTP GET/POST"| PublicPages
    Browser -->|"SPA Data Fetch"| AdminSPA
    AdminSPA -->|"uses"| APIClients
    APIClients -->|"HTTPS/REST"| PrivateAPI
    Browser --->|"fetch assets & pages"| ServerEntry
    ServerEntry --> AppSetup
    AppSetup --> PublicAPI
    AppSetup --> PrivateAPI
    PrivateAPI --> Validation
    PrivateAPI --> Controllers
    Controllers --> PrismaClientUtil
    PrismaClientUtil --> PrismaSchema
    PrismaClientUtil --> PrismaMigrations
    PrismaClientUtil --> Database
    PrivateAPI --> ErrorHandler
    PrivateAPI --> ViaCEPUtil
    ViaCEPUtil -->|"REST Call"| ViaCEP
    ServerEntry --> Swagger
    ServerEntry --> EnvUtil
    ServerEntry --> UploadUtil
    ServerEntry --> Tests
    PublicAPI --> Validation
    Swagger -.-> AppSetup

    %% Click Events
    click PublicPages "https://github.com/refusado/gerenciar-influenciadores/tree/main/frontend/src/app/(plataform)"
    click AdminSPA "https://github.com/refusado/gerenciar-influenciadores/tree/main/frontend/src/app/admin"
    click APIClients "https://github.com/refusado/gerenciar-influenciadores/tree/main/frontend/src/app/admin/api"
    click APIClients "https://github.com/refusado/gerenciar-influenciadores/blob/main/frontend/src/lib/tanstack-query.ts"
    click SharedComponents "https://github.com/refusado/gerenciar-influenciadores/tree/main/frontend/src/components"
    click GlobalStyles "https://github.com/refusado/gerenciar-influenciadores/blob/main/frontend/src/app/globals.css"
    click GlobalStyles "https://github.com/refusado/gerenciar-influenciadores/blob/main/tailwind.config.ts"
    click ServerEntry "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/server.ts"
    click AppSetup "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/app.ts"
    click AppSetup "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/view-routes.ts"
    click PublicAPI "https://github.com/refusado/gerenciar-influenciadores/tree/main/backend/src/api-routes/public"
    click PrivateAPI "https://github.com/refusado/gerenciar-influenciadores/tree/main/backend/src/api-routes/private"
    click Controllers "https://github.com/refusado/gerenciar-influenciadores/tree/main/backend/src/api-routes/private/influencer/controllers"
    click Validation "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/api-routes/private/influencer/schemas.ts"
    click Swagger "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/docs.ts"
    click ErrorHandler "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/error-handler.ts"
    click PrismaSchema "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/prisma/schema.prisma"
    click PrismaMigrations "https://github.com/refusado/gerenciar-influenciadores/tree/main/backend/prisma/migrations"
    click PrismaClientUtil "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/utils/prisma.ts"
    click EnvUtil "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/utils/env.ts"
    click ViaCEPUtil "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/utils/viacep.ts"
    click UploadUtil "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/src/utils/upload-image.ts"
    click Tests "https://github.com/refusado/gerenciar-influenciadores/tree/main/backend/__tests__"
    click Tests "https://github.com/refusado/gerenciar-influenciadores/blob/main/backend/vitest.config.js"

    %% Styles
    classDef frontend fill:#B3DDF2,stroke:#333,stroke-width:1px
    classDef backend fill:#C6E7C5,stroke:#333,stroke-width:1px
    classDef db fill:#F4C86D,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
```
