Pular para o conteúdo principal
Versão: main (dev) 🚧

Quick Start

Do template instalado a um serviço respondendo HTTP — o caminho mínimo. Cada passo tem um guide detalhado em Guides.

# 1. Gere o projeto
dotnet new itlab-fullstack -n MyService -o ./MyService
cd MyService

# 2. Crie seu appsettings de dev (gitignored)
cp src/MyService.Api/appsettings.Development.json.sample \
src/MyService.Api/appsettings.Development.json

# 3. Restore + build + test
dotnet restore
dotnet build
dotnet test

# 4. Aplique as migrations no SQL Server
dotnet ef database update \
--project src/MyService.Infrastructure \
--startup-project src/MyService.Api

# 5. Rode
dotnet run --project src/MyService.Api

Pronto — a API sobe com:

  • GET /health — liveness probe
  • GET /scalar/v1 — UI navegável da API
  • POST /v1/auth/session e demais endpoints de autenticação local (API)
  • POST/GET/PATCH /v1/orders/... — feature canon Orders (API)
  • SPA React servido na raiz

Para fazer login, configure Identity:Admin:{Email,Password} no appsettings.Development.json antes do primeiro run (detalhes em Configurar ambiente dev) — o admin de bootstrap é seedado na startup.

Próximos passos

  • Configurar ambiente dev — connection string, admin seed, signing key, SPA com HMR.
  • Features — o que o canon entrega pronto.
  • Criar sua primeira feature: o CLAUDE.md do projeto gerado traz o passo-a-passo de vertical slice ancorado no canon Orders.