Foto Vira Anuncio
Foto Vira Anuncio is an AI assisted system that creates a listing from a product picture with an SKU code
Core trick
A product photo and SKU go to a vision model that drafts a listing, passed through an async job contract between frontend and backend.
Description
Foto Vira Anuncio is an AI assisted system that creates a listing from a product picture with an SKU code
README excerpt
# hackathon Workspace para desenvolver a demo **Foto vira anúncio** com Codex de ponta a ponta. ## Documentação - `docs/specs/foto-vira-anuncio.md` — spec confirmada da demo. - `docs/workstreams/frontend-backend.md` — contrato e ownership para trabalho paralelo. - `CONTEXT.md` — glossário do domínio. - `docs/adr/` — decisões arquiteturais. ## Trabalho paralelo A `main` contém a aplicação funcional e uma cópia isolada do protótipo visual em `prototype/demo-ui`, com dados simulados no navegador. O protótipo continua sendo evoluído na branch `prototype/demo-ui` e não é importado pelo build da aplicação funcional. Frontend e backend trabalham em paralelo por meio do contrato HTTP e do DTO `Job`. As decisões visuais escolhidas — captura A, painel C e loja B — chegam à aplicação por handoff e são reimplementadas nas páginas existentes; manter o protótipo no repositório não o conecta ao backend. ## Como usar Clone o repositório e abra a pasta com o Codex CLI: ```bash git clone https://github.com/luizhcz/hackathon.git cd hackathon codex ``` ## Executar a demo Requisitos: Node.js 24, npm e login local do Codex ativo. ```bash npm install npm run verify npm run codex:smoke npm run dev ``` A aplicação inicia em modo `FIXTURE`, sem depender de rede ou autenticação durante o Fluxo principal. Jobs, imagens operacionais e Trilhas de auditoria ficam em `.data/foto-vira-anuncio.sqlite`. Defina `JOB_DATABASE_PATH` para usar outro caminho local. - Painel: `http://localhost:3000/pai