O Blog Pessoal é uma API backend que permite que usuários publiquem, editem e visualizem postagens relacionadas a diferentes temas de forma organizada e segura.

O projeto foi desenvolvido com fins educacionais, simulando uma aplicação real utilizada em ambientes profissionais, com foco na construção de APIs REST escaláveis utilizando NestJS e TypeScript.

Entre os principais recursos disponíveis:

1. Criação, edição e exclusão de postagens
2. Associação de postagens a temas específicos
3. Cadastro e autenticação de usuários
4. Consulta de postagens por tema ou usuário
5. Controle de acesso em operações protegidas

A API foi desenvolvida utilizando Node.js, NestJS e TypeScript, seguindo princípios de:

• Arquitetura modular
• Separação de responsabilidades
• Padrão REST
• Boas práticas de organização de código backend

A aplicação disponibiliza endpoints para gerenciamento dos recursos:

• Usuário
• Postagem
• Tema

permitindo a interação entre usuários e conteúdos publicados.

1. Cadastro, autenticação e atualização de usuários
2. Gerenciamento de temas para classificação das postagens
3. Criação, edição, listagem e exclusão de postagens
4. Relacionamento entre postagens, autores e temas
5. Autenticação baseada em JWT para proteção das rotas

O diagrama abaixo representa a estrutura lógica das entidades da aplicação e seus relacionamentos dentro da API.

classDiagram
class Postagem {
  id : number
  titulo : string
  texto : string
  data : Date
  tema : Tema
  usuario : Usuario
}

class Tema {
  id : number
  descricao : string
  postagens : Postagem[]
}

class Usuario {
  id : number
  nome : string
  usuario : string
  senha : string
  foto : string
  postagens : Postagem[]
}

Tema --> Postagem : classifica
Usuario --> Postagem : cria

O DER representa como os dados estão organizados no banco relacional e como as entidades se relacionam.

erDiagram
    tb_usuarios ||--o{ tb_postagens : escreve
    tb_temas ||--o{ tb_postagens : classifica

    tb_usuarios {
        bigint id PK
        varchar nome
        varchar usuario
        varchar senha
        varchar foto
    }

    tb_temas {
        bigint id PK
        varchar descricao
    }

    tb_postagens {
        bigint id PK
        varchar titulo
        varchar texto
        datetime data
        bigint tema_id FK
        bigint usuario_id FK
    }

O projeto foi desenvolvido utilizando a arquitetura modular proposta pelo NestJS, promovendo organização, escalabilidade e facilidade de manutenção do código.

Cada domínio da aplicação é isolado em um módulo próprio, contendo suas responsabilidades bem definidas:

• Controller → recebe e trata requisições HTTP
• Service → contém as regras de negócio
• Entity → representa as tabelas do banco de dados
• Repository/ORM → comunicação com o banco (via TypeORM)

Essa separação facilita testes, evolução do sistema e reutilização de código.

A organização segue o padrão recomendado pelo NestJS:

📦src
 ┣ 📂auth
 ┣ 📂data
 ┣ 📂postagem
 ┣ 📂tema
 ┣ 📂usuario
 ┣ 📂util
 ┣ 📜app.controller.ts
 ┣ 📜app.module.ts
 ┣ 📜app.service.ts
 ┗ 📜main.ts

Exemplo:

📦usuario
 ┣ 📂controllers
 ┃ ┗ 📜usuario.controller.ts
 ┣ 📂entities
 ┃ ┗ 📜usuario.entity.ts
 ┣ 📂services
 ┃ ┗ 📜usuario.service.ts
 ┗ 📜usuario.module.ts

Esse padrão permite crescimento do sistema sem acoplamento excessivo entre funcionalidades.

A autenticação da API utiliza JSON Web Token (JWT) para proteger rotas sensíveis.

1. O usuário realiza login informando credenciais
2. A API valida os dados
3. Um token JWT é gerado
4. O cliente envia o token no header das próximas requisições:

Authorization: Bearer TOKEN

5. Os Guards do NestJS validam o token antes de permitir acesso às rotas protegidas.

Esse modelo é amplamente utilizado em aplicações modernas por ser:

• Stateless
• Escalável
• Compatível com APIs REST

A aplicação utiliza:

• class-validator
• class-transformer

para garantir integridade dos dados recebidos pela API.

Exemplo conceitual:

• Campos obrigatórios são verificados automaticamente
• Tipos inválidos são rejeitados antes da regra de negócio
• Respostas de erro seguem padrão HTTP

Isso reduz erros e aumenta a confiabilidade da API.

Durante o desenvolvimento foram aplicados conceitos utilizados em projetos reais:

• Organização modular do NestJS
• Separação entre controller e regras de negócio
• Tipagem forte com TypeScript
• Padronização REST
• Autenticação baseada em token
• Estrutura preparada para escalabilidade

Este projeto demonstra competências importantes para desenvolvimento backend moderno:

✅ Construção de API REST com NestJS ✅ Arquitetura modular escalável ✅ Autenticação JWT ✅ Modelagem relacional (Usuário → Postagem → Tema) ✅ Integração com banco de dados MySQL via ORM ✅ Validação automática de dados ✅ Documentação interativa com Swagger ✅ Uso profissional de TypeScript no backend

Para executar o projeto localmente:

• Node.js 18+
• npm
• MySQL
• Insomnia

git clone https://github.com/rafaelq80/blogpessoal_nest_tjs13.git
cd blogpessoal_nest_tjs13

npm install

Crie um arquivo .env na raiz do projeto:

DB_HOST=localhost
DB_PORT=3306
DB_USERNAME=root
DB_PASSWORD=root
DB_DATABASE=db_blogpessoal

JWT_SECRET=secret

npm run start:dev

A API será iniciada em:

http://localhost:4000

Após iniciar o projeto, acesse:

http://localhost:4000

O Swagger permitirá:

• visualizar endpoints
• testar requisições
• consultar modelos de dados

Para rodar os testes automatizados:

npm run test

• Paginação de resultados
• Upload de imagens para usuários e postagens
• Sistema de comentários
• Refresh Token

Sugestões, melhorias e pull requests são bem-vindos.

Você pode contribuir com:

• Melhorias arquiteturais
• Refatorações
• Testes automatizados
• Documentação

Este projeto está sob licença MIT — livre para uso educacional e profissional.

Ana Beatriz — Desenvolvedora Full Stack

🔗 GitHub: https://github.com/itsbya

🔗 LinkedIn: https://www.linkedin.com/in/ana-beatriz-carvalho-esmaile

Projeto desenvolvido para aprendizado contínuo, demonstração técnica e portfólio profissional.