refactor: models_api.py vira ponto de entrada sobre admin/api/

A ponte JSON do app tinha 1.395 linhas e 37 comandos de oito assuntos diferentes num arquivo só. Agora models_api.py guarda apenas a referência dos comandos, a tabela de despacho e o main(); cada assunto virou um módulo em admin/api/ (models, project, editing, zoom, subtitles, transcription, voice, review), com a base comum em shared.py. Nada muda para o app: ele continua chamando admin/models_api.py por caminho, e os 37 comandos respondem igual — verificado rodando a ponte de verdade. Duas coisas que a divisão obrigou a arrumar: - A saída passa por `shared.emit` chamada pelo módulo, não pelo nome importado. Isso preserva a propriedade de que trocar `emit` num lugar só captura a saída de todos os comandos — que era acidental quando tudo morava no mesmo arquivo, e vira intencional agora. - `_CANCEL` e o lock eram globais compartilhados. O registro de downloads foi para models.py, junto de quem o usa, com lock próprio: o antigo protegia ao mesmo tempo o dicionário e a escrita em stdout, duas coisas sem relação. Também: admin/test_models_api.py estava fora de `testpaths` e nunca rodava. Movido para code/tests/ e ligado ao gate — 1441 → 1454 testes (ver Engine/docs/05_EXPERIENCIAS.md #24). Lint zerado, 1454 testes passando. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-19 21:46:47 -04:00
parent 4f5cf94443
commit 6090e229e9
14 changed files with 1649 additions and 1254 deletions
@@ -0,0 +1,75 @@
+"""Projeto: inspecionar o .fcpxml e lembrar a pasta/arquivo em uso.
+
+Extraído de models_api.py — a tabela de comandos segue lá.
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+# code/ is the package root for fcpxml and server modules.
+_CODE_DIR = str(Path(__file__).resolve().parent.parent / "code")
+if _CODE_DIR not in sys.path:
+    sys.path.insert(0, _CODE_DIR)
+
+from fcpxml.model_manager import (
+    load_project_config,
+    save_project_config,
+)
+from fcpxml.parser import parse_fcpxml
+
+from . import shared
+
+
+def cmd_inspect(args: dict) -> int:
+    """Validate an FCPXML file and return a summary of its projects/timelines."""
+    path = str(args.get("path", ""))
+    if not path:
+        shared.emit({"ok": False, "error": "Nenhum arquivo informado."})
+        return 1
+    if not Path(path).exists():
+        shared.emit({"ok": False, "error": "Arquivo não encontrado."})
+        return 1
+    try:
+        proj = parse_fcpxml(path)
+    except Exception as exc:
+        shared.emit({"ok": False, "error": f"Erro ao ler o projeto: {exc}"})
+        return 1
+
+    timelines = []
+    for tl in proj.timelines:
+        timelines.append(
+            {
+                "name": tl.name,
+                "duration_seconds": round(tl.duration.seconds, 3),
+                "frame_rate": round(tl.frame_rate, 3),
+                "width": tl.width,
+                "height": tl.height,
+                "clips": tl.total_clips,
+                "cuts": tl.total_cuts,
+                "connected": len(tl.connected_clips),
+                "markers": len(tl.markers),
+            }
+        )
+    shared.emit(
+        {
+            "ok": True,
+            "path": path,
+            "name": proj.name,
+            "fcpxml_version": proj.fcpxml_version,
+            "timelines": timelines,
+        }
+    )
+    return 0
+
+def cmd_project_config(args: dict) -> int:
+    """Read the last project folder/file the app was working on."""
+    shared.emit({"ok": True, **load_project_config()})
+    return 0
+
+def cmd_set_project_config(args: dict) -> int:
+    """Persist the last project folder/file. Only the given fields change."""
+    config = save_project_config(folder=args.get("folder"), file=args.get("file"))
+    shared.emit({"ok": True, **config})
+    return 0