# tcc-fafram/web-plataforma-cursos architecture

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

- Interactive diagram: https://gitdiagram.com/tcc-fafram/web-plataforma-cursos
- Repository: https://github.com/tcc-fafram/web-plataforma-cursos

## Overview

##### Identificação do tipo de projeto e propósito
coloque um debaixo do outro
- É uma Single-Page Application (SPA) em Angular
- Objetivo: Plataforma web de cursos

##### Análise da estrutura de arquivos
coloque um debaixo do outro
- Diretório web/: projeto Angular completo
- src/app/core: módulos e serviços transversais (autenticação, interceptors, guards, UI genérica)
- src/app/services: comunicação com API REST (usuário, curso, certificado, etc.)
- src/app/pages: feature modules / páginas (login, cadastro, controle de cursos, usuários…)
- src/app/models e dtos: definições de dados e interfaces
- Configurações: angular.json, tsconfig.json, ESLint, Prettier

##### Insights do README
coloque um debaixo do outro
- “Plataforma web de cursos”
- Não há backend no repositório → API externa ou microsserviços isolados

##### Como criar o diagrama de arquitetura
a. Componentes principais (um debaixo do outro)
- Cliente Web Angular
- Módulo Core (Interceptores HTTP, Guards, Serviços transversais)
- Feature Modules / Páginas (Autenticação, Controle de Cursos, Certificados, Usuários, etc.)
- API REST Externa
- Banco de Dados (ex.: PostgreSQL, MongoDB)
- Serviço de Autenticação (emissor de JWT/OAuth)
- Armazenamento de Assets (CDN / Cloud Storage)

b. Relações e interações (fluxo de dados)
- Cliente Web → API REST (HTTP requests)
- API REST → Banco de Dados (CRUD)
- Serviço de Autenticação → Cliente Web (emissão de JWT)
- Cliente Web ←→ CDN (assets estáticos)

c. Padrões e princípios arquiteturais
- SPA com roteamento e lazy-loading
- Injeção de Dependência (Angular DI)
- Separação de concerns: Core vs. Feature Modules
- Interceptors para tratamento global de erros e tokens
- Guards para proteção de rotas

d. Tecnologias e frameworks
- Angular (Components, Modules, Services, Guards, Interceptors)
- TypeScript, RxJS
- Angular CLI, Webpack
- API RESTful (JSON over HTTP)
- Banco de Dados relacional ou NoSQL

##### Diretrizes para full-stack / SPA
coloque um debaixo do outro
- Delimitar claramente Frontend vs. Backend
- Mostrar API Gateway ou conjunto de Endpoints REST
- Incluir camada de persistência (DB)
- Destacar fluxo de autenticação (login → token → armazenamento no cliente)

##### Elementos gráficos recomendados
coloque um debaixo do outro
- Labels claros para cada componente
- Setas direcionais para fluxo de dados e dependências
- Cores ou formas distintas para:
- Frontend
- Backend / API
- Banco de Dados
- Serviços externos
- Anotar protocolos (HTTP/HTTPS, WebSocket) nas conexões

Importante: seja detalhado, listando cada módulo Angular e cada serviço crítico. Capture todas as camadas essenciais sem fragmentar em excesso, para entregar ao time visão completa e precisa da arquitetura.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend (Angular SPA)"
        direction TB
        AppComponent["App Component"]:::frontend
        subgraph "Core Module"
            direction TB
            CoreModule["Core Module"]:::frontend
            Interceptors["HTTP Interceptors"]:::frontend
            Guards["Route Guards"]:::frontend
            CoreServices["Core Services"]:::frontend
            CoreUI["Core UI Components & Layout"]:::frontend
        end
        subgraph "Feature Modules"
            direction TB
            AuthModule["Authentication Module"]:::frontend
            CoursesModule["Course Management Module"]:::frontend
            CertificatesModule["Certificate Management Module"]:::frontend
            UsersModule["User Management Module"]:::frontend
            ExamsModule["Exam Management Module"]:::frontend
            FarmsModule["Farm Management Module"]:::frontend
            RolesModule["Role Management Module"]:::frontend
            HomePage["Home Page"]:::frontend
        end
        subgraph "Shared & Config"
            direction TB
            Models["Models (Data Definitions)"]:::frontend
            DTOs["DTOs (Interfaces & Payloads)"]:::frontend
            Pipes["Custom Pipes"]:::frontend
            Resolvers["Resolvers (Data Preloading)"]:::frontend
            Configs["CLI & Tool Configs"]:::frontend
            Assets["Static Assets"]:::frontend
        end
    end

    %% External / Backend Layer
    subgraph "Backend / External Services"
        direction TB
        API["External REST API"]:::backend
        AuthService["Authentication Service (JWT/OAuth)"]:::external
        CDN["CDN / Cloud Storage"]:::external
        Database["Database (PostgreSQL / MongoDB)"]:::database
    end

    %% Data Flows
    AppComponent -->|"lazy-loads modules"| CoreModule
    CoreModule -->|uses| Interceptors
    CoreModule -->|uses| Guards
    CoreModule -->|uses| CoreServices
    CoreModule -->|uses| CoreUI
    AppComponent -->|routes to| AuthModule
    AppComponent -->|routes to| CoursesModule
    AppComponent -->|routes to| CertificatesModule
    AppComponent -->|routes to| UsersModule
    AppComponent -->|routes to| ExamsModule
    AppComponent -->|routes to| FarmsModule
    AppComponent -->|routes to| RolesModule
    AppComponent -->|routes to| HomePage
    AuthModule -->|calls| API
    CoursesModule -->|calls| API
    CertificatesModule -->|calls| API
    UsersModule -->|calls| API
    ExamsModule -->|calls| API
    FarmsModule -->|calls| API
    RolesModule -->|calls| API
    API -->|CRUD operations| Database
    AuthService -->|issues tokens| AuthModule
    AppComponent <-->|fetch assets via HTTP/HTTPS| CDN

    %% Click Events
    click AppComponent "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/app.component.ts"
    click CoreModule "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/core"
    click Interceptors "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/core/http/interceptor"
    click Guards "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/core/http/guard"
    click CoreServices "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/core/services"
    click CoreUI "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/core/ui"
    click AuthModule "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/pages/autenticacao"
    click CoursesModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.cursos"
    click CertificatesModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.certificados"
    click UsersModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.usuarios"
    click ExamsModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.provas"
    click FarmsModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.fazendas"
    click RolesModule "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/controle.funcao"
    click HomePage "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/src/app/pages/home/home.component.ts"
    click Models "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/models"
    click DTOs "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/dtos"
    click Pipes "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/pipe"
    click Resolvers "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/app/resolvers"
    click Configs "https://github.com/tcc-fafram/web-plataforma-cursos/blob/main/web/angular.json"
    click Assets "https://github.com/tcc-fafram/web-plataforma-cursos/tree/main/web/src/assets"

    %% Styling
    classDef frontend fill:#e0f7fa,stroke:#006064,color:#004d40;
    classDef backend fill:#ffe0b2,stroke:#bf360c,color:#3e2723;
    classDef external fill:#f3e5f5,stroke:#4a148c,color:#311b92;
    classDef database fill:#c8e6c9,stroke:#1b5e20,color:#2e7d32;
```
