CSharp-101

Visão geral

O CSharp-101 é um repositório educacional com exemplos práticos em C# e .NET organizados por trilhas temáticas. Cada pasta reúne projetos pequenos e focados, com documentação local padronizada para facilitar leitura, execução isolada e reaproveitamento como referência técnica.

O catálogo cobre fundamentos da linguagem, APIs web, autenticação, mensageria, cache, padrões de projeto, padrões arquiteturais, persistência, algoritmos, utilitários, testes e SDKs. As convenções de documentação ficam em docs/ e o padronizador de README em tools/.

Conceitos abordados

• Linguagem C#, orientação a objetos, LINQ, delegates, eventos e reflection.
• ASP.NET Core, Minimal APIs, middleware, gRPC, autenticação, autorização e segurança.
• Mensageria, Redis, design patterns, CQRS, Saga, persistência, algoritmos e utilitários de apoio.
• Testes, benchmarks e construção de bibliotecas e SDKs reutilizáveis.

Objetivos de aprendizagem

• Encontrar rapidamente um exemplo prático para um tema específico do ecossistema .NET.
• Executar exemplos de forma isolada, com comandos direcionados por projeto.
• Comparar abordagens diferentes para o mesmo problema técnico.
• Usar os READMEs locais como índice curto de estudo e navegação.

Estrutura do projeto

CSharp-101/
+-- 01-Fundamentals/
+-- 02-AsyncAndConcurrency/
+-- 03-WebAPIs/
+-- 04-Authentication/
+-- 05-Messaging/
+-- 06-Caching/
+-- 07-DesignPatterns/
+-- 08-ArchitecturalPatterns/
+-- 09-Data/
+-- 10-Algorithms/
+-- 11-Utilities/
+-- 12-Testing/
+-- 13-SDKsAndLibraries/
+-- docs/
+-- tools/
+-- CSharp-101.sln
+-- README.md
+\-- .github/

Como executar

Prefira comandos direcionados ao arquivo .csproj do exemplo que deseja estudar.

# Build de um exemplo console
dotnet build 01-Fundamentals/AggregationDepartmentManagement/AggregationDepartmentManagement.csproj

# Execução de uma API
dotnet run --project 03-WebAPIs/MinimalApiDemo/MinimalApiDemo.csproj

# Execução de testes
dotnet test 12-Testing/OrderRuleConsole/OrderRuleConsole.Tests/OrderRuleConsole.Tests.csproj

# Reaplicar a padronização de documentação
powershell -ExecutionPolicy Bypass -File .\tools\Standardize-Readmes.ps1

Boas práticas e pontos de atenção

• Use o README local de cada pasta antes de executar, alterar ou validar o projeto.
• Prefira build, run e test por .csproj; a solução raiz funciona melhor como índice do workspace do que como ponto único de validação.
• Exemplos com Kafka, RabbitMQ, Redis, MySQL, PostgreSQL ou MongoDB exigem serviços externos ativos.
• As convenções oficiais de documentação deste repositório estão em docs/CONVENCOES.md e docs/README_TEMPLATE.md.

Conteúdo complementar

Índice Completo de Projetos

01-Fundamentals (10 projetos)

• AggregationDepartmentManagement - Composição e agregação
• AssociationMedicalScheduling - Associação entre objetos
• CompositionOrderFulfillment - Composição de objetos
• Course - Fundamentos da linguagem
• DictionaryMaster - Estudo interativo de Dictionary<TKey, TValue>
• Events - Sistema de eventos e delegates
• Linq - Query com LINQ
• LogicalOperatorsDemo - Operadores lógicos
• Reflection - Introspecção de tipos
• SymbolicDelegates - Delegates simbólicos

02-AsyncAndConcurrency (7 projetos)

• Asynchronous - Async/await básico
• AsyncTasksDemo - Demonstração de tasks
• AtomicOperationsDemo - Operações atômicas
• BackgroudWorker - Background workers
• JobQueueDemo - Fila de trabalhos
• TaskManagement - Gerenciamento de tasks
• Threads - Manipulação de threads

03-WebAPIs (15 projetos)

• BlazorHelloWorld - Aplicação Blazor
• CustomFilterApi - Filtros customizados em API
• CustomMiddleware - Middleware customizado
• FluentValidationUserApi - Validação com Fluent Validation
• GrpcSample (3 subprojetos)
  • GrpcSample.Client - Cliente gRPC
  • GrpcSample.Contracts - Contratos Protobuf
  • GrpcSample.Server - Servidor gRPC
• IdempotencyCacheApi - Idempotência com cache
• InvoiceThrottlingApi - Throttling de requisições
• MinimalApiDemo - Minimal APIs (ASP.NET Core)
• ShareableUser - Recurso compartilhável
• SimpleWebAPI - API básica
• SwaggerClientCode - Geração de código via Swagger
• TransactionalOrderApi - Transações em pedidos
• WebApplication (1 subprojeto)
  • MyAPI - Aplicação web

04-Authentication (7 projetos)

• AdvancedAuthSystem - Sistema avançado de autenticação
• Authentication (2 subprojetos)
  • Auth - Autenticação básica
  • OAuthApplication - OAuth 2.0
• Security (3 subprojetos)
  • EncryptDecrypt - Criptografia
  • SafeVault - Armazenamento seguro
  • SecurityAndAuthentication - Segurança integrada
• SessionManagement - Gerenciamento de sessão

05-Messaging (6 projetos)

• Kafka (2 subprojetos)
  • Send - Produtor Kafka
  • Receive - Consumidor Kafka
• KafkaStreamApi - Streaming com Kafka
• QueueExample - Exemplo de fila
• RabbitMQ (2 subprojetos)
  • Send - Produtor RabbitMQ
  • Receive - Consumidor RabbitMQ

06-Caching (7 projetos)

• Caching (6 subprojetos)
  • CacheAside - Padrão Cache-Aside
  • CacheIncrement - Incremento com cache
  • CachePatterns - Padrões de cache
  • FusionCache - Biblioteca FusionCache
  • RedisMySQLIntegration - Redis + MySQL
  • RedisConsoleApp - Redis (console)
• UnifiedCacheSdk - SDK unificado de cache
• Caching/RedisMetaData - Metadados do Redis

07-DesignPatterns (17 projetos)

• SOLIDExamples - Princípios SOLID
• StrategyIntegration - Padrão Strategy
• ObjectCalisthenics (2 subprojetos)
  • BadOrderApi - Implementação inadequada
  • GoodOrderApi - Implementação adequada
• RichVsAnemicDomain (2 subprojetos)
  • AnemicDomain - Domínio anêmico
  • RichDomain - Domínio rico
• DesignPattern/Behavioral (6 subprojetos)
  • ChainOfResponsibility - Cadeia de responsabilidade
  • Mediator - Mediador
  • State - Estado
  • Strategy - Estratégia
  • UnitOfWork - Unidade de trabalho
  • Visitor - Visitante
• DesignPattern/Creational (2 subprojetos)
  • Builder - Construtor
  • Factory - Fábrica
• DesignPattern/Structural (3 subprojetos)
  • Adapter - Adaptador
  • Composite - Composto
  • Decorator - Decorador

08-ArchitecturalPatterns (9 projetos)

• CarriedEvent - Eventos persistidos
• CircuitBreakerDemo - Disjuntor
• CQRSDemo - Command Query Responsibility Segregation
• PersistencePatterns - Padrões de persistência
• SagaPattern - Padrão Saga
• ServiceRegistration - Registro de serviços
• TransactionPattern - Padrão de transação
• TransactionScript - Script de transação
• UseCases - Casos de uso

09-Data (9 projetos)

• Data (8 subprojetos)
  • Dapper - Micro ORM Dapper
  • DapperExample - Exemplo com Dapper
  • MoneyStorageApi - API de armazenamento
  • MongoUserApi - API com MongoDB
  • MysqlExample - Exemplo com MySQL
  • Postgres - Exemplo com PostgreSQL
  • ProcedureExample - Procedimentos armazenados
  • sqlite-sample-api - API com SQLite
  • sqlite-sample-api.Tests - Testes

10-Algorithms (5 projetos)

• GraphTraversalDemo - Travessia de grafos
• LoadBalancingAlgorithms - Algoritmos de balanceamento
• PriorityQueueDemo - Fila de prioridade
• RealWorldBubbleSort - Bubble sort prático
• SlidingWindows - Janela deslizante

11-Utilities (9 projetos)

• ClassToDTO - Conversão classe para DTO
• ClassToXml - Conversão classe para XML
• CompressDecompress - Compressão/descompressão
• DictionaryMerge - Fusão de dicionários
• NPOIDemo - NPOI para Excel/Word
• PDFGenerator - Geração de PDF
• Serialization - Serialização
• SerilogExample - Logging estruturado com Serilog
• XmlBasics - Manipulação XML

12-Testing (3 projetos)

• BenchmarkTool - Benchmark de performance
• OrderRuleConsole (2 subprojetos)
  • OrderRuleConsole - Aplicação
  • OrderRuleConsole.Tests - Testes

13-SDKsAndLibraries (3 projetos)

• MySimpleSdk (3 subprojetos)
  • MySimpleSdk - Biblioteca principal
  • MySimpleSdk.Demo - Demonstração
  • MySimpleSdk.Tests - Testes
• BlockchainDemo - Demonstração de blockchain (sem .csproj)

Tools (1 projeto)

• ReadmeStandardizer - Utilitário de padronização de READMEs

---

Total: 108+ subprojetos distribuídos em 13 trilhas temáticas + tools

Trilhas temáticas

Pasta	Foco principal	Exemplos de referência
01-Fundamentals	Fundamentos da linguagem e OO	Course, DictionaryMaster, Events, Linq, Reflection
02-AsyncAndConcurrency	Async/await, tasks, threads e coordenação	Asynchronous, AsyncTasksDemo, JobQueueDemo
03-WebAPIs	APIs, middleware, gRPC e aplicações web	MinimalApiDemo, GrpcSample, CustomMiddleware
04-Authentication	JWT, OAuth, sessão e segurança	Auth, SessionManagement, AdvancedAuthSystem
05-Messaging	Filas, brokers e streaming	Kafka, RabbitMQ, KafkaStreamApi
06-Caching	Estratégias de cache e Redis	CacheAside, CachePatterns, FusionCache
07-DesignPatterns	GoF, SOLID e modelagem OO	DesignPattern, SOLIDExamples, ObjectCalisthenics
08-ArchitecturalPatterns	Organização de casos de uso e padrões arquiteturais	UseCases, CQRSDemo, SagaPattern
09-Data	Bancos de dados, ORMs e acesso a dados	Dapper, MongoUserApi, MoneyStorageApi
10-Algorithms	Estruturas de dados e análise de cenários	GraphTraversalDemo, PriorityQueueDemo, SlidingWindows
11-Utilities	Transformação de dados, serialização e observabilidade	Serialization, NPOIDemo, SerilogExample
12-Testing	Benchmarks e validação de comportamento	BenchmarkTool, OrderRuleConsole
13-SDKsAndLibraries	Bibliotecas e SDKs reutilizáveis	MySimpleSdk

Serviços externos comuns

# RabbitMQ
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:management

# Redis
docker run -d --name redis -p 6379:6379 redis

# Kafka (exemplo da pasta Kafka)
cd 05-Messaging/Kafka
docker compose up -d

Ferramentas de documentação

• docs/CONVENCOES.md: convenções de escrita e manutenção dos READMEs.
• docs/README_TEMPLATE.md: template base para novos exemplos.
• tools/ReadmeStandardizer/: utilitário em C# para padronização em lote.

Referências

• Documentação do .NET
• ASP.NET Core
• Entity Framework Core
• Refactoring Guru

Documentação complementar

• docs/CONVENCOES.md - Convenções de documentação do repositório.
• docs/README_TEMPLATE.md - Template base para READMEs padronizados.