Sous Lite

Versão leve do Sous para uma cozinha doméstica: Vite, JavaScript, Fastify e SQLite em um único container. A interface é PT-BR por padrão e os dados ficam em um volume local, sem serviço externo ou chave de IA.

Como o estoque se comporta

• Registrar um item que já existe soma à quantidade guardada em vez de criar uma linha repetida. 500 g entram em um item medido em kg; un só soma com un, então "3 cebolas" e "1 kg de cebola" continuam separados.
• A validade estimada é calculada uma única vez, quando o item entra no estoque. Ajustar a quantidade ou renomear o item não adia essa data — só informar outra data no formulário muda a validade. Salvar o campo de validade vazio remove a data.
• Na lista de compras, o que já está marcado como comprado nunca recebe soma: pedir o mesmo item de novo cria uma linha pendente.
• "Mover comprados para o estoque" (POST /api/shopping/checkout) transfere todos os itens marcados para o estoque e os remove da lista.
• Diminuir a quantidade registra consumo. Depois de algumas baixas o item mostra o uso semanal estimado e o atalho de reposição usa esse valor.
• Excluir um item mostra Desfazer por alguns segundos.
• Exportar / Importar no cabeçalho grava e restaura estoque, lista e histórico em JSON (GET/POST /api/backup). A importação substitui os dados atuais. O arquivo sous.db no volume continua válido como cópia bruta do banco.

Em produção o app registra um service worker e pode ser instalado no celular (manifest em /manifest.webmanifest). A API não é cacheada: só a interface fica disponível offline.

Execução local com Docker

Requer Docker com Compose. Para iniciar uma instância local:

cp .env.example .env
docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build

Abra http://localhost:3000. Para usar outra porta no host, altere SOUS_PORT no .env e recrie o container:

docker compose -f docker-compose.yml -f docker-compose.local.yml up -d --build

O banco SQLite é persistido no volume sous_data. Prefira Exportar na interface para um backup em JSON; copiar sous.db do volume ainda funciona se a aplicação estiver parada. Não remova o volume durante atualizações.

Deploy no Coolify

Use docker-compose.yml como o Compose da aplicação. O arquivo base não publica portas no host: o Coolify/Traefik deve encaminhar o domínio para a porta interna 3000 do serviço. Não inclua docker-compose.local.yml no deploy do Coolify, pois ele publica 3000 no host e pode colidir com o proxy.

O volume persistente é sous_data. Não remova volumes antigos durante uma atualização; eles contêm o banco SQLite da instalação.

Desenvolvimento

npm install
npm run dev

O frontend roda em 5173 e encaminha /api para o backend em 3000.

Em outro terminal, inicie o backend quando necessário:

npm start

Produção

npm run check

check roda o lint, os testes e o build. O endpoint de saúde é GET /healthz. O banco fica no volume sous_data; não há Postgres nem serviço externo.