# À Mesa — refeições partilhadas ## Editar receitas e lista de compras Abra uma receita e escolha **Editar receita** para alterar nome, imagem, ingredientes ou preparação. A receita mantém o identificador e as ligações ao plano. Se outra pessoa a alterar enquanto o formulário estiver aberto, a gravação é recusada com uma mensagem para reabrir a versão atual. Na **Lista de compras**, utilize **Adicionar produto**, **Editar** e **Remover**. Os ajustes são partilhados e guardados por semana, sem alterar os ingredientes das receitas. Uma quantidade editada substitui o total calculado desse produto, mesmo que o plano mude depois. Em **Ajustes desta semana** pode repor o cálculo automático ou descartar produtos manuais. Os produtos automáticos são identificados pelo nome e unidade: se editar estes campos nos ingredientes de uma receita, o novo ingrediente é calculado separadamente dos ajustes antigos. ## Atualizar a instalação existente sem perder dados Esta versão adiciona uma tabela com `CREATE TABLE IF NOT EXISTS`; não elimina nem substitui receitas ou o plano existentes. Utilize a mesma pasta de instalação, o mesmo projeto Compose e o volume `meals-data` atual. Não copie uma base de dados local por cima da base de dados do servidor. Antes de atualizar, faça uma cópia de segurança no servidor: ```sh cd /docker/angular/amesa docker compose stop app docker compose cp app:/app/data ./backup-amesa-antes-edicao docker compose start app ``` Compile no computador de desenvolvimento com `npm run build`. Copie a pasta `dist` completa, a pasta `server` e o `nginx.conf` atualizado para `/docker/angular/amesa/`, mantendo o projeto Compose e o volume existentes. O limite de upload do Nginx passa a 8 MB para permitir editar receitas com imagens. O Dockerfile utiliza os ficheiros já compilados; `.dockerignore` não deve excluir `dist`. Depois execute no servidor: ```sh cd /docker/angular/amesa docker compose up -d --build docker compose restart nginx ``` Não utilize `docker compose down -v`: elimina o volume de dados. Aceda à porta 6969 e atualize a página. A migração e a persistência são verificadas em testes com uma base de dados no formato antigo; o servidor remoto não é alterado automaticamente pelo desenvolvimento local. Angular com backend Node.js e SQLite. Todas as pessoas que acedem ao mesmo servidor veem a mesma coleção de receitas e o mesmo plano semanal. A página procura alterações a cada 5 segundos. As gravações são feitas no servidor. ## Publicar em Docker Instale Docker com Compose no servidor e execute nesta pasta: ```sh docker compose up -d --build ``` Abra `http://IP-DO-SERVIDOR:6969` nos dispositivos com acesso ao servidor. O `docker-compose.yml` inicia o Nginx com a configuração de `nginx.conf` e o backend; apenas a porta do Nginx fica publicada. O backend serve os ficheiros Angular e a API. Para acesso pela Internet, configure o domínio e HTTPS no proxy. O volume `meals-data` guarda `/app/data/amesa.sqlite`, incluindo imagens carregadas. Reiniciar ou reconstruir o container mantém os dados. Não execute `docker compose down -v` se quiser manter os dados: essa opção elimina o volume. Utilize apenas uma instância da aplicação sobre este volume SQLite. É um espaço partilhado sem contas: qualquer pessoa com acesso pode consultar e adicionar receitas e alterar o plano. Restrinja o acesso no proxy/VPN se o espaço for privado. ## Executar sem Docker Requer Node.js 24 ou superior. ```sh npm install npm run build npm start ``` Abra `http://localhost:3000` ou `http://IP-DO-SERVIDOR:3000`. O servidor serve a aplicação e a API. Guarda a base de dados em `data/amesa.sqlite`. As variáveis `PORT` e `DATA_DIR` permitem alterar a porta e a pasta. Para desenvolver, mantenha `npm start` num terminal e execute `npm run dev` noutro. Abra `http://localhost:4200`; o proxy encaminha `/api` para o backend na porta 3000. Em PowerShell com scripts desativados, utilize `npm.cmd`. ## Receitas anteriores A aba **Lista de compras** soma os ingredientes de todas as refeições da semana selecionada. Cada ocorrência de um prato conta uma receita completa. Aceita quantidades no início de cada linha (por exemplo, `200 g de arroz`, `0,5 kg de arroz`, `2 ovos`, `½ abacate`). Converte kg/g e l/ml e mantém medidas incompatíveis separadas. Ingredientes sem quantidade ou com intervalos ficam indicados para confirmação; não são estimados. Use nomes consistentes para o mesmo ingrediente. A lista acompanha automaticamente as alterações ao plano partilhado. Se existirem receitas no localStorage `amesa-v1`, aparece um botão para importar para a coleção partilhada. Abra a aplicação no navegador e no endereço/porta antigos para encontrar esses dados; por exemplo, use o servidor de desenvolvimento na porta 4200. A importação conserva os dados locais e pode ser repetida sem duplicar receitas já importadas. O plano local antigo não é importado; o novo plano é comum a todos. Fotografias carregadas (PNG, JPEG, GIF ou WebP, até 2 MB) ficam na base de dados. Para fotografias por URL, guarda-se o endereço; a imagem depende do site externo. Inclui seis receitas iniciais e começa com o plano partilhado vazio. ## Cópia de segurança Pare a aplicação antes de copiar a pasta de dados completa, incluindo eventuais ficheiros SQLite `-wal` e `-shm`. Em Docker: ```sh docker compose stop app docker compose cp app:/app/data ./backup-amesa docker compose start app ``` Para restaurar, pare a aplicação e reponha o conteúdo da pasta de dados a partir da cópia, preservando as permissões de escrita do utilizador `node` no container. ## Validação ```sh npm run build npm test ``` Os testes verificam gravações simultâneas, leitura partilhada, imagens, repetição de pedidos, remoção por identificador, validação e persistência após reiniciar o servidor.