Comercio BES

Vitrine digital e guia comercial de Boa Esperanca do Sul - SP.

O produto ajuda moradores a encontrar estabelecimentos, consultar informacoes essenciais e iniciar contato pelos canais oficiais da loja. Carrinho, pedido, pagamento, estoque e entrega nao fazem parte do nucleo do Comercio BES.

Direcao do produto

• O Comercio BES e a fonte da descoberta local: busca, categorias, perfil, fotos, horario, mapa, contato e moderacao.
• O Braga Commerce e a fonte da transacao: catalogo comercial, estoque, carrinho, pedido, pagamento, entrega e pos-venda.
• A integracao sera feita por um adapter read-only e links assinados/deep links quando o contrato estiver definido.
• As interfaces e APIs do marketplace legado foram removidas; as tabelas historicas permanecem somente ate a migracao controlada dos dados.
• Dados transacionais existentes somente poderao ser removidos apos inventario, backup restauravel e aprovacao da politica de retencao.

A decisao completa esta em docs/adr/0001-product-scope-and-braga-commerce.md.

Stack

• Frontend: HTML, CSS e JavaScript vanilla, distribuido como PWA.
• Backend: Node.js + Express.
• Banco: PostgreSQL 16 via Prisma.
• Proxy/SSL: Caddy.
• Deploy: Docker Compose.

Fonte do frontend

index.html, manifest.json, sw.js, css/, js/, html/, icons/, images/ e data/ na raiz sao a unica fonte versionada do site. backend/public/ e um artefato ignorado pelo Git: nunca edite ou versione arquivos ali.

O build do backend recria o artefato e o check confirma que ele corresponde byte a byte a fonte:

cd backend
npm run frontend:build
npm run frontend:check

Subir com Docker

Crie .env a partir de .env.example e troque senhas/chaves.

docker compose up -d postgres
docker compose run --rm api npm run db:push
docker compose run --rm api npm run seed
docker compose up -d

URLs:

• API: https://api.comerciobes.com.br/api
• Health: https://api.comerciobes.com.br/api/health
• Painel: https://api.comerciobes.com.br/minha-conta

Desenvolvimento sem Docker

Requer Node.js 24+.

cd backend
npm install
npm run db:push
npm run seed
npm run dev

URLs locais:

• Site/API: http://localhost:3000
• Painel: http://localhost:3000/minha-conta

PORT=3000 e apenas o padrao. Em qualquer porta HTTP(S) local, o frontend usa a API da mesma origem; por exemplo, http://127.0.0.1:4317 chama http://127.0.0.1:4317/api. Somente a abertura direta por file:// usa http://localhost:3000/api como fallback explicito.

Credenciais seed

• Admin: admin@comerciobes.com / admin123
• Lojista: lojista@comerciobes.com / lojista123
• Alias lojista: comerciante@demo.com / demo123

Qualidade

cd backend
npm run build
npm run frontend:check
npm test
npm audit --omit=dev --audit-level=high

Documentacao

• Roadmap, milestones e issues
• ADR de escopo e Braga Commerce
• Operacao, backup e migracao
• Auditoria de seguranca