Dispensa

Use quando o usuário pedir para anotar, guardar ou adicionar algo à lista de compras, ao mercado ou à despensa ("anota aí leite", "põe café na lista", "preciso lembrar de comprar sabonete"). Canonicaliza o produto, adiciona à lista e devolve a marca que a pessoa costuma comprar. `texto` é o *o quê* (sabonete, café), não a marca. Confirme em linguagem natural. Não mostre o codigo LIS-….

Use quando o usuário disser qual marca, tipo ou quantidade prefere ("agora eu prefiro café Três Corações", "meu leite é sempre o integral"). Grava a preferência como evidência de peso máximo: o que o usuário diz vale mais que o histórico de compras.

Use só quando o usuário pedir explicitamente para apagar todos os seus dados no Dispensa. Nunca para remover um item (use remover_item). Apaga todas as linhas deste usuário; produtos globais ficam. Confirme com o usuário antes de enviar confirmar=true.

Use quando o usuário disser que uma compra registrada está errada ("não era Pilão, era Melitta", "o total foi outro", "a data está errada"). Conserta a transcrição e realimenta o motor; a correção é evidência de peso máximo. Pegue o codigo CMP-… em ver_historico; nunca o mostre ao usuário.

Use quando o usuário pedir uma cópia de todos os seus dados no Dispensa ("exporta meus dados", "quero um backup das minhas compras"). Exporta lista, compras, preferências e ajustes deste usuário.

Use quando o usuário perguntar o que falta comprar ou o que está acabando em casa ("o que preciso comprar?", "o que falta no mercado?", "vou ao mercado, o que levo?"). Cruza frequência, última compra e quantidade típica. Devolve probabilidade e evidência, não uma lista seca.

Use só para diagnóstico técnico do Dispensa, quando o usuário pedir para testar a conexão ou ver o estado da conta. Não use para pedidos de compra. Devolve contadores, versão do motor de preferência e estado do perfil.

Use quando o usuário mandar a foto do cupom fiscal / nota do mercado, ou contar o que comprou ("comprei hoje no mercado…", "registra essa nota"). Registra a compra em lote; é com ela que o Dispensa aprende as marcas e prevê o que vai faltar. Confirme itens e valores com o usuário ANTES de gravar. O servidor não vê a imagem e não consulta a SEFAZ: você transcreve, o servidor guarda evidência. A chave_nfe (44 dígitos do QR) dá idempotência e o CNPJ canônico da loja. Origem é obrigatória: transcricao, manual ou correcao. Item pode vir sem preço e sem quantidade. Em cada item, `texto` é o *o quê* (sabonete, não "sabonete nivea"). Marca e variante vão nos campos. O servidor ainda tira a marca do slug.

Use quando o usuário pedir para tirar, riscar ou remover um item da lista de compras ("tira o arroz da lista", "já peguei o leite"). Chame ver_lista antes para obter o codigo; nunca o mostre ao usuário.

Use quando o usuário perguntar o que comprou, quando ou por quanto ("quando comprei café?", "quanto paguei no leite?", "compras do mês"). Devolve o histórico de compras, com data, loja e preço.