Skip to content

Cloud9

Sistema inteligente de gestão para pequenos negócios do setor de alimentação, voltado à redução de desperdícios, otimização de recursos e melhoria da tomada de decisões.

Core trick

Turns ingredient expiry dates into a prioritized action plan and deducts recipe-linked stock automatically when an order is paid.

Tags

Description

Sistema inteligente de gestão para pequenos negócios do setor de alimentação, voltado à redução de desperdícios, otimização de recursos e melhoria da tomada de decisões. A solução utiliza dados do próprio estabelecimento para entender padrões de consumo, demanda e operação, auxiliando na distribuição de insumos, no planejamento do estoque e na eficiência do negócio.
KlayvemGuimaraes/estoqueChef★ 00 forksTypeScriptCreated Aug 19, 2026 · last push Aug 19, 2026

README excerpt

# EstoqueChef

Copiloto anti-desperdício para pequenos restaurantes. O MVP transforma validade em um plano de ação e conecta pedido, pagamento demonstrativo, fichas técnicas e baixa automática de estoque.

## Rodando localmente

```bash
npm install
cp .env.example .env.local
npm run dev
```

Acesse `http://localhost:3000`. O banco SQLite e o restaurante fictício **Sabor da Casa** são criados automaticamente.

Sem chave, o copiloto funciona em modo local para perguntas sobre validade, compras e capacidade. Chaves iniciadas por `gsk_` pertencem à **Groq** e devem ser configuradas como `GROQ_API_KEY`. O projeto também aceita `XAI_API_KEY` para o Grok da xAI e `OPENAI_API_KEY` para OpenAI.

Nunca coloque tokens reais no `.env.example`. Copie o arquivo para `.env.local`, use credenciais novas e reinicie o servidor depois da alteração.

## Follow-ups no Telegram

1. Crie ou abra seu bot no BotFather e configure um token novo em `TELEGRAM_BOT_TOKEN` no `.env.local`.
2. Defina `TELEGRAM_PAIRING_CODE` e envie `/start SEU_CODIGO` ao bot. Sem essa variável, `/start` simples funciona apenas para a demo local.
3. Na aplicação, abra **Validades** e clique em **Conectar mensagens recentes**.
4. Confira a prévia e use **Enviar follow-up agora**.

Cada mensagem informa o ingrediente prioritário, validade, sobra provável, valor em risco e prato recomendado. O código evita assinantes não autorizados e o envio é idempotente: o mesmo plano é entregue no máximo uma vez por chat a cada dia.

Para a

Team