Smart Commerce
SaaS multi-tenant de lojas virtuais independentes com gestão financeira e operacional inteligente.
Estado e escopo
Validações locais: autenticação, empresa/loja, catálogo básico, estoque, vitrine pública fotos, descrição e variações, reservas, entrega, carrinho, integração da Sprint 3, pedido no backend, checkout na vitrine, pedidos no admin e revisão integrada da Sprint 3 (modelo de ameaças). A suíte atual possui 162 testes backend aprovados (SC-011). Publicação e CI remota das alterações desde 1a04070 permanecem pendentes.
Backend Spring Boot, admin e vitrine Next.js separados, PostgreSQL/Flyway e CI preparados. A SC-002 acrescenta o fluxo local de solicitação por e-mail, confirmação com definição de senha, login, consulta de identidade e logout. A SC-003 acrescenta criação e consulta da empresa/loja do proprietário, com isolamento por vínculo. O catálogo permite cadastrar, listar e editar produtos; o estoque registra entradas e ajustes. A vitrine pública mostra somente lojas e produtos publicados explicitamente, com preços e disponibilidade descontadas as reservas ativas. A loja configura retirada e/ou frete fixo, e o comprador monta um carrinho com cotação calculada pelo backend. Em DEV, o comprador finaliza o pedido até PENDING_PAYMENT, com reserva de 30 minutos e página de acompanhamento. Pagamentos, pedidos no admin, IA e recuperação de senha ainda não integram esta entrega.
Decisões: ADR-0004. Resultados e limitações: validação SC-001. O isolamento implementado para empresa/loja e catálogo é verificado por testes A/B; observabilidade ampliada da SC-004 continua pendente.
SC-001 publicada no repositório privado confirmado pelo usuário. A CI remota aprovou backend e admin no commit b6475731a0b5eb88b3c9c963e06fb2b78ce25b7b: seis testes backend sem falhas/erros/ignorados, lint, tipos, build e smoke HTTP do admin aprovados. A primeira execução falhou no seletor Corretto; foi corrigido para Java 21, sem alterar dependências da aplicação. SEC-003 permanece aberta, sem exceção aprovada: a última auditoria registrou cinco alertas altos na cadeia de desenvolvimento e zero com --omit=dev; ESLint 9 está fora de suporte. CI verde não aceita esse risco; a autorização da SC-002 foi concedida separadamente pelo responsável. Detalhes em validação, segurança e publicação.
Agentes de IA: instruções em AGENTS.md (Claude via CLAUDE.md); checks e revisão em docs/quality/README.md; ferramentas e pendências do toolkit em docs/setup.md.
Estrutura
A página inicial do admin (/) apresenta a plataforma e leva ao cadastro e ao login. As demonstrações /admin/produtos, /loja/produto e /componentes foram removidas no bloco 2a do MVP (validação). Para operar lojas reais, use /entrar e /lojas; a vitrine real continua na aplicação storefront-web. As URLs operacionais foram preservadas. Ver validação da landing.
backend/ Spring Boot, Maven Wrapper, Flyway e testes
admin-web/ Next.js App Router, TypeScript e shell administrativo
storefront-web/ Next.js App Router, vitrine pública de consulta
infrastructure/ Compose e inicialização técnica do PostgreSQL
scripts/ execução local do backend em PowerShell
docs/ produto, arquitetura, ADRs, papéis e evidências
.github/workflows/ci.yml
Ferramentas
- JDK 21. A validação local utilizou Corretto 21.0.9; a CI aprovou OpenJDK 21.0.12.1 / Corretto 21.0.12.12.1. O adaptador Corretto da action aceita somente a major
21, selecionando seu patch disponível. Selecione o JDK no terminal; o Java global pode continuar em outra versão.
- Maven 3.10.0 obtido pelo Maven Wrapper 3.3.4, sem instalação global.
- Spring Boot 4.1.1; dependências gerenciadas pelo parent/BOM no
backend/pom.xml.
- Node.js 24.12.0; npm local 11.21.0 e npm remoto aprovado 11.6.2 (ambos atendem ao engine 11 do projeto). Versões exatas das bibliotecas nos manifests e lockfiles de
admin-web/ e storefront-web/; a vitrine reutiliza as versões do admin.
- Docker Desktop/Engine Linux e Compose v2. O CLI instalado sem engine acessível não basta.
- PostgreSQL 18.6 Bookworm, com digest fixado no Compose e nos testes.
Os primeiros downloads de Maven, npm e imagens exigem rede. Nenhum serviço pago ou credencial de produção é necessário.
Executar localmente no Windows (PowerShell)
Comece na raiz. Substitua o caminho ilustrativo de JAVA_HOME pela instalação do seu JDK 21.
$env:JAVA_HOME = 'C:\caminho\para\seu\jdk-21'
$env:Path = "$env:JAVA_HOME\bin;$env:Path"
java -version
node --version
npm --version
docker info
Inicie Docker Desktop e aguarde o engine Linux. Crie o arquivo local somente se ele não existir:
if (-not (Test-Path infrastructure/.env)) {
Copy-Item infrastructure/.env.example infrastructure/.env
}
This is the beginning of the README. Read the rest at the original. Read the full README ↗
