À 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:
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:
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:
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.
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:
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
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.