Manual de Utilização

1.1 Criar a tua empresa

Na página inicial, escreve o nome do teu restaurante e prime "Começar". No passo seguinte confirmas a tua identidade através de um ecrã de login seguro (o mesmo email fica sempre associado à mesma conta, mesmo em visitas seguintes).

De volta à aplicação, confirmas o registo: o nome do restaurante já vem preenchido, a área de actuação está fixada em "Restaurante" (única disponível nesta fase) e escolhes a moeda de utilização — usada depois em todos os preços e custos mostrados na app, por isso não é uma escolha trivial de mudar mais tarde. Por fim aceitas os Termos de Utilização.

A partir daí entras directamente na aplicação, já como administrador, com o catálogo completamente vazio — pronto a começar pelos Ingredientes (ver capítulo 3).

1.2 Aceitar um convite

Se um administrador já te convidou (ver capítulo 6), recebes acesso associado ao teu email. Basta entrares na aplicação com esse mesmo email. Se ainda não tiveres aceitado os Termos de Utilização mais recentes, a aplicação pede-te isso antes de avançares — a página mostra o nome da empresa que te convidou, para confirmares que é a que esperavas.

1.3 Pertencer a mais do que uma empresa

Se fores membro de várias empresas, o menu junto ao teu avatar (canto inferior do menu lateral) mostra "As tuas empresas" com um atalho para trocar entre elas. Cada empresa tem o seu próprio catálogo, equipa e configurações — completamente independentes. Para criar uma empresa adicional a partir da aplicação, usa o logótipo "Mise en Place" no topo do menu, que volta à página inicial sem terminar a sessão.

É a página de abertura, sempre que entras na aplicação. Mostra um tile por Pratos, Preparações e Ingredientes, cada um com um anel a indicar a fatia desse tipo no catálogo total, e a percentagem por baixo. Cada tile é clicável — atalho directo para essa lista.

Quando existirem Pratos ou Preparações Desactivo por rever (ver 3.4), o respectivo tile mostra também uma segunda linha "+N desactivos", a amarelo — um sinal rápido de que há trabalho por terminar nessa lista, sem precisar de a abrir para descobrir.

Com o catálogo ainda vazio (empresa acabada de criar), aparece uma mensagem a sugerir começar pelos Ingredientes, em vez de três tiles a zero sem contexto.

3.1 Três tipos, uma lógica comum

Ingredientes são a base — o que compras (unidade de compra, % de perda na preparação, e um histórico de preços ao longo do tempo). Preparações são passos intermédios que rendem uma certa quantidade por lote (ex.: um refogado, um molho) e podem ser usadas dentro de outros Pratos ou Preparações — uma base usada em cinco pratos configura-se uma única vez. Pratos são o que sai para o cliente, com categoria de menu e, opcionalmente, um preço de venda para estimar margem.

Todos os três têm uma tabela própria com pesquisa (por nome, "no meio da palavra", sem distinguir maiúsculas nem acentos) e, no caso de Pratos e Preparações, um filtro adicional por categoria e por estado. Clicar em "Ver" abre sempre em modo de leitura; "Editar" dentro desse ecrã é que activa a edição.

3.2 Componentes e alternativas

Dentro de um Prato ou Preparação, a secção de componentes lista o que entra nele — cada linha aponta para um Ingrediente ou outra Preparação, com uma quantidade e uma unidade. As unidades disponíveis ajustam-se sozinhas à família certa (peso, volume ou unidades) consoante o que escolheres.

Duas ou mais linhas podem partilhar o mesmo nome de "alternativa" (ex.: "Molho" em duas versões) — na altura de calcular (capítulo 4), escolhe-se qual das alternativas usar, sem ter de duplicar o Prato inteiro. Uma delas fica marcada como "padrão", usada automaticamente até se escolher outra.

3.3 Fotografias e ficha técnica

Pratos e Preparações aceitam até duas fotografias — por upload, colando uma imagem copiada (Ctrl+V) ou, no telemóvel, tirando a foto na hora. O botão "Ficha técnica" gera um PDF com nome, categoria, fotos, componentes e procedimento, com a opção de incluir ou não os preços/custo.

3.4 Activo e desactivo

Um Prato ou Preparação novo nasce sempre Desactivo — mesmo criado à mão — para poderes montá-lo com calma (nome, procedimento, componentes, ao longo de várias sessões) sem ele entrar por engano num cálculo real antes de estar pronto. Enquanto desactivo, fica de fora da Calculadora e do Calendário, e qualquer prato que o use mostra o custo como incompleto.

O botão "Activar" no ecrã Ver/Editar torna-o Activo, disponível para uso; "Desactivar" faz o caminho inverso a qualquer momento — útil para tirar temporariamente um prato de produção (ex.: fora de época) sem perder os seus componentes nem o preço configurado. O filtro "Todos os estados / Activo / Desactivo", junto à pesquisa, ajuda a encontrar rapidamente o que ainda falta rever.

3.5 Importar uma receita por foto ou PDF

O botão "Importação por IA" nos ecrãs de Pratos e Preparações aceita uma foto (tirada na hora ou colada com Ctrl+V) ou um PDF de uma receita. A aplicação extrai automaticamente o nome, o procedimento e os ingredientes, e cria logo o registo — sempre Desactivo, para reveres antes de activar (ver 3.4). Se algum ingrediente da receita corresponder a uma Preparação já existente na tua empresa, é ligado directamente a ela em vez de criar um Ingrediente novo.

Se algo não for reconhecido com confiança (uma quantidade em falta, uma unidade pouco clara), aparece uma nota no início do procedimento a assinalar o que vale a pena confirmar à mão antes de activar.

3.6 Importar ingredientes por CSV ou Excel

No ecrã de Ingredientes, o botão de importação aceita um ficheiro CSV ou Excel (.xlsx) com nome, unidade e preço — categoria, perda e data são opcionais. Um botão "Descarregar modelo" dá-te um ficheiro Excel já com as colunas certas, pronto a preencher. Um nome igual a um ingrediente já existente nunca cria duplicado: entra como um preço novo no histórico desse ingrediente.

4.1 Calculadora

Escreve a quantidade de doses de cada Prato que vais produzir (a pesquisa por nome ajuda quando o catálogo tem muitos pratos) — a lista de compras e a lista de preparações aparecem logo por baixo, recalculadas em tempo real.

4.2 Calendário

Planeamento semanal: cada um dos sete dias tem a sua própria lista de pratos e quantidades, adicionados através de um campo de pesquisa próprio de cada dia — escreve para filtrar pelo nome do prato e escolhe directamente, sem teres de percorrer uma lista comprida. Um dia pode ser temporariamente excluído do cálculo (a checkbox no cabeçalho do dia) sem apagar o que lá está — por exemplo, um dia de encerramento. Navega entre semanas com as setas no topo.

4.3 Lista de compras e lista de preparações

Tanto a Calculadora como o Calendário terminam no mesmo painel de resultados: uma árvore que desdobra cada prato nas suas preparações e ingredientes, somando automaticamente o que é partilhado entre vários pratos. Quando um componente tem alternativas configuradas (ver 3.2), um selector permite escolher qual usar nesse cálculo. Cada linha mostra o custo estimado; se faltar algum preço ou algum componente estiver desactivo, aparece assinalado como incompleto, nunca como erro. Um botão "Imprimir PDF" exporta a lista de compras ou a lista de preparações, prontas para a cozinha.

O menu junto ao teu avatar, no fundo do menu lateral, reúne as escolhas pessoais: um nome de apresentação (usado em vez do teu email nos sítios onde apareces, ex.: junto ao papel na Equipa), o idioma da interface (Português, English, Español) e o tema (claro, escuro, ou a seguir o sistema). Todas estas escolhas são só tuas — não afectam o que os teus colegas veem. É também aqui que terminas a sessão ("Sair").

Convida alguém pelo email e escolhe logo a sua função: administrador (acesso total, incluindo Equipa e Configurações), gestor (pode criar e editar o catálogo e usar a Calculadora/Calendário, sem acesso a Equipa/Configurações) ou consulta (só pode ver, nunca editar). A função de qualquer conta, excepto a tua própria, pode ser alterada a qualquer momento num selector directamente na lista.

Uma conta pode ser desactivada sem a remover — perde o acesso à empresa mas os seus dados de autoria (ex.: quem criou um prato) mantêm-se; "Reactivar" devolve o acesso. A checkbox "Mostrar desactivadas" revela as contas escondidas por omissão dessa lista.

7.1 Dados de contacto

NIF, morada, localidade, código postal, distrito, telefone, email e país — todos opcionais, usados apenas nos cabeçalhos dos PDFs exportados (ficha técnica, listas de compras/preparações). Não afectam nada do funcionamento da aplicação em si.

7.2 Encerramento de empresa

Na "Zona de risco", no fundo da página, podes encerrar definitivamente a empresa — apaga todos os seus dados (catálogo, equipa, histórico) sem possibilidade de recuperação. Para evitar um encerramento acidental, o botão só liga depois de escreveres o nome exacto da empresa, e ainda pede uma confirmação final antes de agir.