Web Dev Labs

Base de conhecimento sobre desenvolvimento web do Caramelo Tech - do HTML ao system design.

As notas deste repositório são publicadas no site do Caramelo Labs.

Conteúdo

Tópico	Descrição
Fundamentos Web	HTML e CSS
Engenharia de Software	Design de código, princípios SOLID
APIs	HTTP e REST
Databases	SQL e ACID
Escalabilidade	Escala vertical, horizontal e organizacional
Transações Distribuídas	Consistência entre microsserviços, Sagas, dual-write
System Design na Prática	Estudos de caso resolvidos (encurtador de URL)
Ferramentas	Git, Conventional Commits, Pull Requests, fluxos e GPG

A ordem das seções segue uma progressão pensada para entrevistas de backend: da escrita de código (Engenharia de Software) até sistemas distribuídos em escala (Transações Distribuídas e System Design na Prática).

Estrutura do repositório

web-dev-labs/
├── notes/           → Anotações em Markdown puro (publicadas no site do Caramelo Labs)
├── sidebar.json     → Seções da barra lateral no site
├── examples/        → Exemplos, exercícios e projetos práticos
└── LICENSE

Este repositório contém apenas conteúdo - não há build, dependências ou configuração de site. A estrutura web (Astro + Starlight) vive no repositório hub labs, que busca as notas daqui a cada atualização e publica o site.

Escrevendo notas

As notas em notes/ são Markdown puro, sem frontmatter:

• A primeira linha da nota deve ser o título: # Título da Nota
• Use prefixo numérico no nome do arquivo para controlar a ordem na barra lateral: 01-introducao.md, 02-conceitos.md
• Agrupe por tema em subpastas
• Imagens ficam junto das notas (ex: notes/secao/assets/img.png) e são referenciadas com caminho relativo: ![descrição](./assets/img.png)
• Links para outras notas do site usam o caminho completo: /labs/web-dev/<secao>/<nota>/

Ao criar uma nova subpasta de tema, adicione a seção correspondente em sidebar.json.

Como usar

1. Comece pelas anotações em notes/ (ou pelo site)
2. Explore os exemplos em examples/
3. Resolva os exercícios em examples/exercises.md
4. Construa os projetos em examples/projects.md

Contribuição

Contribuições são bem-vindas! Veja o Guia de Contribuição para detalhes.

Licença

MIT