FCG.10NETT 1.0.7

🚀 Tech Challenge - Fase 2 | Arquitetura de Microsserviços

Documentação Completa do Projeto - Transformação de aplicação monolítica em microsserviços orientados a eventos

📦 Sobre Este Projeto - FCG.Generics (FCG.10NETT) - Versão 1.0.2

⚠️ OBSERVAÇÃO IMPORTANTE: Este repositório contém o projeto compartilhado extraído da solução original para ser distribuído como pacote NuGet.

🔄 Processo de Separação

Este projeto foi separado da solução monolítica pos-tech-fcg-user-api para uma solução independente com o objetivo de:

• ✅ Gerar um pacote NuGet reutilizável
• ✅ Compartilhar código comum entre todos os microsserviços da Fase 2
• ✅ Distribuir padrões de código (.editorconfig) e convenções de projeto
• ✅ Centralizar recursos do Tech Challenge (documentação, templates, etc.)

📝 Histórico de Nomenclatura

Durante o processo de publicação, ocorreram as seguintes mudanças de nomenclatura devido a conflitos no NuGet.org:

🎯 Propósito do Pacote

O FCG.10NETT fornece:

1. 📋 Padrões de Código: .editorconfig configurado com regras C# do projeto
2. 📚 Recursos do Tech Challenge: Documentação, templates e guias na pasta Tech.Challenge
3. 🔧 Classes Utilitárias: (A serem adicionadas) Helpers, extensions e componentes compartilhados
4. ⚙️ Configurações Base: Configurações comuns para ASP.NET Core e Entity Framework

📦 Instalação

Via GitHub Packages

# Configurar fonte NuGet do GitHub (uma vez)
dotnet nuget add source "https://nuget.pkg.github.com/marcel0liveira/index.json" \
    --name "GitHub-FCG" \
    --username marcel0liveira \
    --password SEU_GITHUB_PAT

# Instalar o pacote
dotnet add package FCG.10NETT

Via NuGet.org (Futuro)

dotnet add package FCG.10NETT

🚀 Uso

Após instalar o pacote, você terá acesso a:

1. Padrões EditorConfig

O .editorconfig estará disponível em content/. Copie para a raiz da sua solução:

# PowerShell
Copy-Item "packages\FCG.10NETT.*\content\.editorconfig" ".\.editorconfig"

2. Recursos Tech.Challenge

Documentação e templates estarão em content/Tech.Challenge/:

packages/FCG.10NETT.x.x.x/
└── content/
    └── Tech.Challenge/
        ├── README.md
        ├── 00-Geral/
        ├── 10-Microsservicos/
        └── 20-Infraestrutura/

3. Componentes Compartilhados (Futuro)

using FCG.Generics;

// Exemplo de uso futuro
var validator = new GenericValidator<MyEntity>();

🔗 Microsserviços que Consomem Este Pacote

📋 Índice

• 🎯 Visão Geral
• 📊 Status do Projeto
• 📂 Documentação
• 🛠️ Stack Tecnológica
• 🚦 Começar Aqui
• 🎓 Trilhas de Aprendizado
• 📈 Progresso e Métricas
• 🔗 Links Rápidos

🎯 Visão Geral

Projeto de refatoração de aplicação monolítica para arquitetura de microsserviços orientada a eventos, aplicando as melhores práticas de engenharia de software.

Objetivos Principais

• ✅ Implementar 4 microsserviços independentes
• ✅ Aplicar Clean Architecture em todos os serviços
• ✅ Implementar comunicação assíncrona via eventos
• ✅ Configurar Message Broker (RabbitMQ)
• ✅ Orquestrar com Kubernetes
• ✅ Alcançar >80% de cobertura de testes

📊 Status do Projeto

✅ Microsserviços

⚙️ Infraestrutura

📈 Métricas Gerais

Microsserviços:    ████░░░░░░ 25%  (1/4 concluído)
Infraestrutura:    ██░░░░░░░░ 25%  (1/4 componentes)
Testes Totais:     ████░░░░░░ 46%  (190/415+ previstos)
Documentação:      ██████████ 100% (12/12 arquivos)

📂 Documentação

📋 Estrutura de Arquivos

📁 Fase.2/
│
├── 📄 README.md                      ⭐ Este arquivo (Ponto de Entrada)
│
├── 📋 DOCUMENTAÇÃO GERAL (00-04)
│   ├── 📄 00-INDEX.md                   (Índice Completo + FAQ)
│   ├── 📄 01-README.md                  (Resumo Executivo)
│   ├── 📄 02-DiarioDeBordo.md          (Checklist de Progresso)
│   ├── 📄 03-ProximasEtapas.md         (Timeline Detalhada)
│   └── 📄 04-Arquitetura.md            (Diagramas e Fluxos)
│
├── 🔧 PLANOS DE MICROSSERVIÇOS (10-13)
│   ├── 📄 10-UserAPI-Plan.md           ✅ UserAPI (Referência)
│   ├── 📄 11-CatalogAPI-Plan.md        🎮 CatalogAPI
│   ├── 📄 12-PaymentsAPI-Plan.md       💳 PaymentsAPI
│   └── 📄 13-NotificationsAPI-Plan.md  📧 NotificationsAPI
│
├── ⚙️ INFRAESTRUTURA (20)
│   └── 📄 20-Infrastructure-Plan.md     (RabbitMQ + Kubernetes)
│
└── 📚 META-DOCUMENTAÇÃO (90)
    └── 📄 90-EstruturaDaDocumentacao.md (Guia da Docs)

🎯 Navegação Rápida

🛠️ Stack Tecnológica

Backend

• .NET 8 - Framework principal
• ASP.NET Core Web API - APIs RESTful
• Entity Framework Core 8 - ORM
• FluentValidation - Validação de dados
• MassTransit - Message broker abstraction

Banco de Dados

• PostgreSQL 16 - Banco de dados relacional

Message Broker

• RabbitMQ 3.12 - Comunicação assíncrona

DevOps & Infraestrutura

• Docker - Containerização
• Docker Compose - Orquestração local
• Kubernetes - Orquestração em produção

Testes

• xUnit - Framework de testes
• FluentAssertions - Assertions fluentes
• Moq - Mocking
• Testcontainers - Testes de integração

Observabilidade

• OpenTelemetry - Logs, métricas e tracing
• Health Checks - Monitoramento de saúde
• Serilog - Logging estruturado

🚦 Começar Aqui

👶 Para Iniciantes

1. 00-INDEX.md - Entenda a estrutura completa
2. 01-README.md - Leia o resumo executivo
3. 04-Arquitetura.md - Estude os diagramas
4. 10-UserAPI-Plan.md - Analise o exemplo completo

👨‍💻 Para Desenvolvedores Experientes

1. 03-ProximasEtapas.md - Veja a timeline
2. 04-Arquitetura.md - Entenda os fluxos
3. Escolha um plano: CatalogAPI, PaymentsAPI ou NotificationsAPI

🔧 Para DevOps

1. 20-Infrastructure-Plan.md - RabbitMQ e Kubernetes
2. 03-ProximasEtapas.md - Docker Compose master

🎓 Trilhas de Aprendizado

📚 Conceitos Fundamentais

Clean Architecture

• ✅ API Layer: Controllers, endpoints
• ✅ Application Layer: DTOs, interfaces, validações
• ✅ Domain Layer: Entidades, value objects, regras de negócio
• ✅ Infrastructure Layer: Repositórios, banco de dados, serviços externos

Event-Driven Architecture

• ✅ Publishers: Publicam eventos após ações
• ✅ Consumers: Consomem eventos e executam ações
• ✅ Message Broker: RabbitMQ para comunicação assíncrona
• ✅ Event Sourcing: Registro de eventos como fonte da verdade

🛤️ Jornada de Desenvolvimento

Semana 1: CatalogAPI (2-3 dias) + PaymentsAPI (2 dias)
   ↓
Semana 2: NotificationsAPI (1-2 dias) + RabbitMQ (2 dias)
   ↓
Semana 3: Kubernetes (2 dias) + Integração (2 dias)
   ↓
Semana 4: Testes E2E (1 dia) + Vídeo (1 dia) + Entrega (1 dia)

📈 Progresso e Métricas

🎯 Entregas Finais

• UserAPI - Funcionando com 190+ testes ✅
• FCG.10NETT (NuGet) - Pacote compartilhado publicado ✅
• CatalogAPI - CRUD de jogos + eventos
• PaymentsAPI - Processamento simulado
• NotificationsAPI - E-mails simulados
• RabbitMQ - Message broker configurado
• Kubernetes - Todos os pods rodando
• Docker Compose - Ambiente local completo
• Vídeo - Demonstração de 20min
• Relatório - Documentação de entrega

📊 Estatísticas Detalhadas

🔗 Links Rápidos

📚 Documentação do Projeto

🔧 Planos de Microsserviços

⚙️ Infraestrutura

🌐 Links Externos

📦 Repositórios GitHub

💡 Dicas de Produtividade

✅ Boas Práticas

1. Instale o pacote FCG.10NETT em todos os microsserviços para consistência
2. Leia o plano completo antes de começar a desenvolver
3. Use o UserAPI como referência - já está 100% concluído
4. Siga a Clean Architecture - mantém o código organizado
5. Escreva testes desde o início - economiza tempo depois
6. Documente conforme desenvolve - não deixe para depois

⚠️ Armadilhas Comuns

• ❌ Começar a codificar sem ler a arquitetura
• ❌ Pular os testes automatizados
• ❌ Não seguir o padrão de nomenclatura (use .editorconfig do pacote)
• ❌ Ignorar a documentação do README
• ❌ Deixar a integração de eventos para o final

📞 Suporte e Recursos

💻 Código de Referência

• UserAPI Completo: GitHub Repository
• Plano UserAPI: 10-UserAPI-Plan.md
• Pacote NuGet Compartilhado: GitHub Packages

📚 Documentação Adicional

• FAQ Completo: 00-INDEX.md#-faq---perguntas-frequentes
• Guia da Documentação: 90-EstruturaDaDocumentacao.md

🤝 Comunidade

• Discord do grupo
• GitHub Issues para dúvidas técnicas
• Code Reviews via Pull Requests

🎉 Próximos Passos

Esta Semana

1. ✅ UserAPI Concluído (100%)
2. ✅ FCG.10NETT Publicado (100%)
3. 🔴 Iniciar CatalogAPI → Ver Plano

Próximas Semanas

4. 🔴 PaymentsAPI → Ver Plano
5. 🔴 NotificationsAPI → Ver Plano
6. 🔴 RabbitMQ → Ver Guia
7. 🔴 Kubernetes → Ver Guia

📄 Licença e Créditos

Projeto Acadêmico - FIAP Tech Challenge - Fase 2

Equipe: [Nomes dos integrantes]
Data: Janeiro 2025
Versão da Documentação: 2.4
Pacote NuGet: FCG.10NETT v1.0.0

🚀 Vamos construir algo incrível!

Para começar, acesse o Índice Geral (00-INDEX.md) ou escolha um Plano de Microsserviço para desenvolver.

📦 Não esqueça de instalar o pacote compartilhado: dotnet add package FCG.10NETT