Release v4928.1.4.2 stable

docs/CLIENTFLOW_V41_NOTES.md

@@ -0,0 +1,34 @@
+# ClientFlow v4.1 — Correções de deploy e scripts operacionais
+
+Esta versão é incremental sobre a v4.0 e corrige o problema encontrado no remoto:
+
+```text
+ModuleNotFoundError: No module named 'app'
+```
+
+## Alterações
+
+- `scripts/apply_migrations.py` passa a resolver automaticamente a raiz do projeto.
+- `scripts/check_clientflow_health.py` passa a resolver automaticamente a raiz do projeto.
+- `scripts/process_outbox.py` também passa a mudar para a raiz do projeto antes de carregar `.env`.
+- `scripts/test_jasmin_connection.py` e `scripts/test_packlink_connection.py` passam a carregar `.env` a partir da raiz do projeto mesmo quando executados de outra pasta.
+
+## Comandos depois do deploy
+
+```bash
+cd /mnt/ssd/home/plx/clientflow_backend
+source .venv/bin/activate
+
+python scripts/apply_migrations.py --dry-run
+python scripts/apply_migrations.py
+python scripts/check_clientflow_health.py
+
+sudo systemctl restart clientflow-api
+sudo systemctl status clientflow-api --no-pager
+```
+
+Já não deve ser necessário executar com `PYTHONPATH=.`.
+
+## Nota
+
+O `.env` continua excluído do `rsync` e deve permanecer apenas no servidor remoto.