Improve portable startup diagnostics

backend/app/portable_launcher.py

@@ -3,12 +3,27 @@ from __future__ import annotations
 import socket
 import threading
 import time
+import traceback
 import urllib.request
 import webbrowser
+from pathlib import Path
 
 import uvicorn
 
-from app.runtime_config import RuntimeSettings, apply_runtime_config
+from app.runtime_config import RuntimeSettings, apply_runtime_config, resolve_app_root
+
+
+def _append_startup_log(message: str, log_path: Path | None) -> None:
+    text = str(message).rstrip()
+    print(text, flush=True)
+    if log_path is None:
+        return
+    try:
+        log_path.parent.mkdir(parents=True, exist_ok=True)
+        with log_path.open("a", encoding="utf-8") as handle:
+            handle.write(f"{text}\n")
+    except Exception:
+        pass
 
 
 def _first_available_port(host: str, preferred_port: int, max_attempts: int = 20) -> int:
@@ -37,11 +52,13 @@ def _wait_for_server_and_open_browser(url: str, timeout_s: float = 45.0) -> None
             time.sleep(0.5)
 
 
-def _build_server(settings: RuntimeSettings) -> tuple[uvicorn.Server, str]:
+def _build_server(settings: RuntimeSettings, log_path: Path | None) -> tuple[uvicorn.Server, str]:
     port = _first_available_port(settings.host, settings.port)
     url = f"http://{settings.host}:{port}"
 
+    _append_startup_log("[mesa] importando backend...", log_path)
     from app.main import app
+    _append_startup_log("[mesa] backend importado com sucesso", log_path)
 
     config = uvicorn.Config(
         app=app,
@@ -54,13 +71,34 @@ def _build_server(settings: RuntimeSettings) -> tuple[uvicorn.Server, str]:
 
 
 def main() -> int:
-    settings = apply_runtime_config()
-    server, url = _build_server(settings)
+    early_log_path = resolve_app_root() / "MesaFrame-startup.log"
+    try:
+        early_log_path.unlink(missing_ok=True)
+    except Exception:
+        pass
 
-    print(f"[mesa] iniciando servidor local em {url}")
-    if settings.config_path is not None:
-        print(f"[mesa] configuracao carregada de {settings.config_path}")
-    print(f"[mesa] runtime local em {settings.runtime_dir}")
+    _append_startup_log("[mesa] iniciando aplicativo...", early_log_path)
+
+    try:
+        settings = apply_runtime_config()
+        log_path = settings.app_root / "MesaFrame-startup.log"
+        if log_path != early_log_path:
+            try:
+                early_log_text = early_log_path.read_text(encoding="utf-8")
+                log_path.write_text(early_log_text, encoding="utf-8")
+            except Exception:
+                pass
+        _append_startup_log(f"[mesa] pasta do app: {settings.app_root}", log_path)
+        if settings.config_path is not None:
+            _append_startup_log(f"[mesa] configuracao carregada de {settings.config_path}", log_path)
+        _append_startup_log(f"[mesa] runtime local em {settings.runtime_dir}", log_path)
+        server, url = _build_server(settings, log_path)
+        _append_startup_log(f"[mesa] iniciando servidor local em {url}", log_path)
+    except Exception:
+        detail = traceback.format_exc()
+        _append_startup_log("[mesa] falha ao iniciar o aplicativo", early_log_path)
+        _append_startup_log(detail, early_log_path)
+        return 1
 
     if settings.open_browser:
         opener = threading.Thread(target=_wait_for_server_and_open_browser, args=(url,), daemon=True)
@@ -69,7 +107,11 @@ def main() -> int:
     try:
         server.run()
     except KeyboardInterrupt:
-        print("[mesa] encerrando aplicativo")
+        _append_startup_log("[mesa] encerrando aplicativo", log_path)
+    except Exception:
+        _append_startup_log("[mesa] falha durante a execucao do servidor", log_path)
+        _append_startup_log(traceback.format_exc(), log_path)
+        return 1
     return 0
 
 

build/windows/appsettings.example.json

@@ -5,10 +5,9 @@
     "open_browser": true
   },
   "paths": {
-    "runtime_dir": "%LOCALAPPDATA%\\MesaFrame",
-    "models_dir": "\\\\servidor\\mesa\\dados\\modelos_dai",
-    "trabalhos_tecnicos_db": "\\\\servidor\\mesa\\dados\\trabalhos_tecnicos\\trabalhos_tecnicos.sqlite3",
-    "users_file": "\\\\servidor\\mesa\\dados\\usuarios\\usuarios.json"
+    "models_dir": "..\\dados\\modelos_dai",
+    "trabalhos_tecnicos_db": "..\\dados\\trabalhos_tecnicos\\trabalhos_tecnicos.sqlite3",
+    "users_file": "..\\dados\\usuarios\\usuarios.json"
   },
   "env": {
     "APP_LOGS_MODE": "disabled"