De Lá do Pará

Loja de produtos paraenses (alimentos sem refrigeração e artesanato), com procedência, produtores, entrega e retirada. Projeto de portfólio, executado localmente, sem custo de serviços.

• Backend: Spring Boot (monólito modular, perfis API/worker), PostgreSQL, Kafka.
• Frontend: Angular (vitrine com SSR + áreas privadas).
• Diferencial técnico: checkout confiável com outbox transacional, consumidores idempotentes e conciliação de resultado desconhecido.
• Integrações de teste: Asaas Sandbox e Melhor Envio Sandbox (opt-in).

Estado: bootstrap C06–C11b implementado; observabilidade HTTP C12 e CI inicial C13 disponíveis nesta branch. A loja, checkout e integrações reais continuam em desenvolvimento. Plano em docs/PLANO-MESTRE.md e evidências em tasks/progress.md.

Começar

cd /home/gaalbu/codigos
git clone https://github.com/Gaalbu/de-la-do-para.git
cd de-la-do-para
# Somente se ainda não existir; preserve sua configuração:
test -f .env || cp .env.example .env
# Ajuste a senha local antes de subir os serviços.
docker compose --profile local up -d
npm ci --prefix frontend

Requisitos: JDK 25 (Temurin 25.0.4 usado na CI), Node 22.23.2, npm 12.0.2 e Docker. A infraestrutura usa portas próprias: guia local. API e Angular são executados separadamente neste estágio:

./backend/mvnw -f backend/pom.xml spring-boot:run -Dspring-boot.run.arguments=--server.port=18080
# Em outro terminal:
npm --prefix frontend start

A API real oferece /actuator/health, /actuator/health/liveness e /actuator/health/readiness. /api/v1/status é apenas um stub WireMock; catálogo e checkout ainda não estão implementados. O proxy Angular /api ainda aponta para 8080; ajustar a porta quando integrar endpoints de negócio.

Verificar

scripts/verify.sh backend
scripts/verify.sh contracts
scripts/verify.sh frontend

• CI e requisitos: gates reproduzíveis, relatórios e limitações.
• API: contrato canônico e exemplos executáveis.
• Observabilidade: correlação, logs e probes.
• Imagens de release: API, worker e frontend em imagens imutáveis.
• Backup e restauração: migrations com dados, cópia do banco e conferência em banco separado.

Regras do repositório

• Nomes e código em inglês; guias e textos da loja em pt-BR.
• Conventional Commits (feat, fix, test, docs, refactor, build, ci, chore).
• Cada funcionalidade entrega contrato, exemplos, testes e evidência juntos.
• Sem segredos no Git; credenciais de sandbox só em ambiente local opt-in.

Dados de produtos, produtores, preços e origem são fictícios e identificados como demonstração. Não há atendimento presencial nem retirada real.