@danhachuel/prodmaker 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 Todas as versões seguem a etiqueta visual `MAJOR.MINOR.PATCH` com patch de dois dígitos
 (o registry NPM normaliza `0.1.00` → `0.1.0`).
 
+## 0.1.17 — 2026-11-01
+
+- **HOTFIX — servidor encerrando sozinho no Windows (CMD/MobaXterm/PowerShell).**
+- Launcher: no Windows o processo Python é iniciado com `shell: true` além de
+  `stdio: 'inherit'`, mantendo o terminal anexado; nova mensagem explícita
+  "O servidor está rodando. Mantenha esta janela aberta. Pressione CTRL+C para encerrar.";
+  se o filho morrer em menos de 3 segundos com código ≠ 0, o launcher imprime o
+  traceback hint e o comando manual em vez de sair em silêncio; `child.on("error")`
+  também diagnosticado.
+- **database.py à prova de crash:** `ensure_db()` recriado com try/except por
+  instrução (CREATE TABLE IF NOT EXISTS + ALTERs de migração) e recuperação de
+  arquivo SQLite corrompido — o banco ruim é movido para
+  `prodmaker.db.corrupt-AAAAMMDD-HHMMSS` e um novo é criado; o Uvicorn nunca cai
+  na inicialização por causa do banco.
+- **Fallback manual:** `app/main.py` agora tem entry point (`python -m app.main`
+  sobe o uvicorn na porta 8188) para ver o traceback completo no terminal.
+- README/MANual: seção "Se o servidor fechar sozinho" com o comando manual
+  `.\venv\Scripts\python.exe -m app.main` (na pasta do ProdMaker).
+
 ## 0.1.16 — 2026-10-31
 
 - **Fase 12 — Billing Stripe + E-mail Marketing (AdsAcademy) + Supabase multi-tenant pronto.**

package/MANUAL-INSTALACAO.md

@@ -1,10 +1,10 @@
-# Manual de Instalação — ProdMaker
+# Manual de Instala????o ??? ProdMaker
 
-## Pré-requisitos
+## Pr??-requisitos
 
-- **Node.js 20 ou superior** — https://nodejs.org
-- **Python 3.10 ou superior** — https://python.org (marcar "Add to PATH" no Windows)
-- Internet para download do pacote npm e das dependências
+- **Node.js 20 ou superior** ??? https://nodejs.org
+- **Python 3.10 ou superior** ??? https://python.org (marcar "Add to PATH" no Windows)
+- Internet para download do pacote npm e das depend??ncias
 
 ## Instalar
 
@@ -20,7 +20,7 @@ npx --yes @danhachuel/prodmaker@0.1.1 install
 
 O que o `install` faz:
 
-1. Cria a pasta de dados **PRODMAKER_HOME** (ordem de resolução: variável `PRODMAKER_HOME` → `C:\Users\danha\Documents\REPOSITORIO\ProdMaker` → `%USERPROFILE%\ProdMaker`).
+1. Cria a pasta de dados **PRODMAKER_HOME** (ordem de resolu????o: vari??vel `PRODMAKER_HOME` ??? `C:\Users\danha\Documents\REPOSITORIO\ProdMaker` ??? `%USERPROFILE%\ProdMaker`).
 2. Cria o storage local: `storage/{state,pages,produtos,artifacts,downloads,logs}` + `settings.json`.
 3. Cria um ambiente virtual Python (`venv`) dentro do PRODMAKER_HOME e instala o `requirements.txt`.
 
@@ -34,44 +34,46 @@ npx.cmd --yes --prefer-online @danhachuel/prodmaker@0.1.1
 npx --yes @danhachuel/prodmaker@0.1.1
 ```
 
-O terminal imprimirá:
+O terminal imprimir??:
 
 ```
-┌─────────────────────────────────────────────┐
-│  ProdMaker rodando em:                      │
-│  >>>  http://localhost:8188  <<<            │
-│  Abra esta URL MANUALMENTE no navegador.    │
-└─────────────────────────────────────────────┘
+?????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
+???  ProdMaker rodando em:                      ???
+???  >>>  http://localhost:8188  <<<            ???
+???  Abra esta URL MANUALMENTE no navegador.    ???
+?????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????????
 ```
 
 **Abra a URL manualmente.** O ProdMaker nunca abre o navegador sozinho (REGRA ZERO).
-O box de inicialização também imprime o **Código de Ativação Mestre** (default: `1234`) —
-no login, use qualquer e-mail + esse código (ou digite `admin` como código).
-Código customizado: variável de ambiente `PRODMAKER_MASTER_CODE`.
-Se a porta 8188 estiver ocupada, o launcher usará automaticamente 8189–8199 e informará.
+O box de inicializa????o tamb??m imprime o **C??digo de Ativa????o Mestre** (default: `1234`) ???
+no login, use qualquer e-mail + esse c??digo (ou digite `admin` como c??digo).
+C??digo customizado: vari??vel de ambiente `PRODMAKER_MASTER_CODE`.
+Se a porta 8188 estiver ocupada, o launcher usar?? automaticamente 8189???8199 e informar??.
 
-- Login: informe qualquer e-mail e o **Código de Ativação Mestre** impresso no terminal ao iniciar (default: `1234`; ou digite `admin`).
+- Login: informe qualquer e-mail e o **C??digo de Ativa????o Mestre** impresso no terminal ao iniciar (default: `1234`; ou digite `admin`).
 - Para encerrar: `Ctrl+C` no terminal.
 
-## Diagnóstico
+## Diagn??stico
 
 ```bash
 npx.cmd --yes @danhachuel/prodmaker@0.1.0 doctor
 ```
 
-Verifica Node, Python, venv, dependências, storage, backend e porta.
+Verifica Node, Python, venv, depend??ncias, storage, backend e porta.
 
-## Solução de problemas
+## Solu????o de problemas
 
-| Problema | Solução |
+| Problema | Solu????o |
 |---|---|
-| "Python não encontrado" | Instale o Python 3.10+ e rode `prodmaker install` novamente. |
-| Porta 8188 ocupada | O launcher migra para 8189–8199 automaticamente; confira a URL impressa. |
-| `settings.json corrompido` | O sistema preserva a cópia em `storage/state/settings.corrupt.json` e não sobrescreve. Restaure manualmente. |
+| "Python n??o encontrado" | Instale o Python 3.10+ e rode `prodmaker install` novamente. |
+| Porta 8188 ocupada | O launcher migra para 8189???8199 automaticamente; confira a URL impressa. |
+| `settings.json corrompido` | O sistema preserva a c??pia em `storage/state/settings.corrupt.json` e n??o sobrescreve. Restaure manualmente. |
 | Erro no Windows sobre scripts desabilitados | Use `npx.cmd` (CMD/MobaXterm) em vez do `npx` do PowerShell. |
-| `'prodmaker' não é reconhecido` ao rodar o npx | Execute os comandos npx **fora da pasta do repositório** (ex.: `%USERPROFILE%`). Dentro da pasta do projeto, o npx prioriza o pacote local (que não tem `node_modules/.bin`). Para desenvolvimento local use `node scripts\cli.mjs` na raiz do repositório. |
+| `'prodmaker' n??o ?? reconhecido` ao rodar o npx | Execute os comandos npx **fora da pasta do reposit??rio** (ex.: `%USERPROFILE%`). Dentro da pasta do projeto, o npx prioriza o pacote local (que n??o tem `node_modules/.bin`). Para desenvolvimento local use `node scripts\cli.mjs` na raiz do reposit??rio. |
+| **O servidor fecha sozinho / terminal volta ao prompt** | Rode manualmente para ver o traceback completo: `.\venv\Scripts\python.exe -m app.main` (dentro da pasta do ProdMaker). O launcher diagnostica encerramentos em menos de 3 segundos com essa mesma instru????o. Banco corrompido ?? recuperado automaticamente (backup `prodmaker.db.corrupt-*`). |
 
 ## Importante
 
-- **Nunca rode os comandos npx dentro de `C:\Users\danha\Documents\REPOSITORIO\ProdMaker`** — o npx entende que você quer executar o projeto local. Use qualquer outra pasta.
-- O ProdMaker **nunca abre o navegador** (REGRA ZERO): após iniciar, abra manualmente a URL impressa no terminal.
+- **Nunca rode os comandos npx dentro de `C:\Users\danha\Documents\REPOSITORIO\ProdMaker`** ??? o npx entende que voc?? quer executar o projeto local. Use qualquer outra pasta.
+- O ProdMaker **nunca abre o navegador** (REGRA ZERO): ap??s iniciar, abra manualmente a URL impressa no terminal.
+

package/README.md

@@ -1,43 +1,59 @@
 # ProdMaker
 
-🚀 **SaaS local para criação de infoprodutos low-ticket, landing pages, campanhas de tráfego e tracking** — baseado no sistema AdsX, executado no seu computador via `npx` e acessado manualmente no navegador.
+???? **SaaS local para cria????o de infoprodutos low-ticket, landing pages, campanhas de tr??fego e tracking** ??? baseado no sistema AdsX, executado no seu computador via `npx` e acessado manualmente no navegador.
 
-> ⚠️ **REGRA ZERO:** o ProdMaker **nunca abre o navegador**. Ao iniciar, ele apenas imprime a URL (`http://localhost:8188`) no terminal — você abre manualmente.
+> ?????? **REGRA ZERO:** o ProdMaker **nunca abre o navegador**. Ao iniciar, ele apenas imprime a URL (`http://localhost:8188`) no terminal ??? voc?? abre manualmente.
 
-## Instalação
+## Instala????o
 
 ```bash
-# CMD/MobaXterm (Windows)
-npx.cmd --yes --prefer-online @danhachuel/prodmaker@0.1.1 install
-npx.cmd --yes --prefer-online @danhachuel/prodmaker@0.1.1
+# CMD/MobaXterm (Windows) ??? fora da pasta do reposit??rio
+npx.cmd --yes --prefer-online @danhachuel/prodmaker@0.1.17 install
+npx.cmd --yes --prefer-online @danhachuel/prodmaker@0.1.17
 
 # Linux/macOS/PowerShell
-npx --yes @danhachuel/prodmaker@0.1.1 install
-npx --yes @danhachuel/prodmaker@0.1.1
+npx --yes @danhachuel/prodmaker@0.1.17 install
+npx --yes @danhachuel/prodmaker@0.1.17
 ```
 
-1. `install` cria a pasta de dados (`PRODMAKER_HOME`), o storage local e instala as dependências Python.
+1. `install` cria a pasta de dados (`PRODMAKER_HOME`), o storage local e instala as depend??ncias Python.
 2. O segundo comando inicia o servidor em `http://localhost:8188` e imprime a URL no terminal.
-3. **Abra a URL manualmente no navegador**, faça login (qualquer e-mail + o **Código de Ativação Mestre** impresso no terminal — default `1234` — ou `admin`) e acesse o painel.
+3. **Abra a URL manualmente no navegador**, fa??a login (qualquer e-mail + o **C??digo de Ativa????o Mestre** impresso no terminal ??? default `1234` ??? ou `admin`) e acesse o painel.
 
-## O que está incluído (0.1.01 — Parte 2: Frontend)
+## Se o servidor fechar sozinho no Windows
 
-| Área | Estado |
+Se o terminal voltar para o prompt sem manter o servidor (ou travar), rode manualmente
+para ver o traceback completo:
+
+```bash
+# dentro da pasta do ProdMaker (PRODMAKER_HOME)
+.\venv\Scripts\python.exe -m app.main
+```
+
+O comando acima sobe o servidor na porta 8188 com o log completo no terminal. O launcher
+tamb??m passou a diagnosticar encerramento imediato (menos de 3 segundos) imprimindo essa
+mesma instru????o. Se o banco local estiver corrompido, o sistema faz backup autom??tico
+(`prodmaker.db.corrupt-*`) e recria ??? o servidor n??o cai mais na inicializa????o.
+
+## O que est?? inclu??do (0.1.01 ??? Parte 2: Frontend)
+
+| ??rea | Estado |
 |---|---|
-| Launcher npm (`install` / `run` / `doctor`) | ✅ |
-| Backend FastAPI (auth local, settings, health) | ✅ |
-| Storage persistente local (fora do cache npm) | ✅ |
-| Seeds de negócio (prompts, negativas, defaults, decisão, checklist) | ✅ |
-| `/legal` (index, privacidade LGPD, termos) | ✅ |
-| Workflow de publicação NPM via GitHub Actions | ✅ |
-| Frontend React + Vite + Tailwind (login + painel AdsX) | ✅ |
-| Seus Produtos (CRUD real: análise → aprovação) | ✅ |
-| Tema claro/escuro | ✅ |
+| Launcher npm (`install` / `run` / `doctor`) | ??? |
+| Backend FastAPI (auth local, settings, health) | ??? |
+| Storage persistente local (fora do cache npm) | ??? |
+| Seeds de neg??cio (prompts, negativas, defaults, decis??o, checklist) | ??? |
+| `/legal` (index, privacidade LGPD, termos) | ??? |
+| Workflow de publica????o NPM via GitHub Actions | ??? |
+| Frontend React + Vite + Tailwind (login + painel AdsX) | ??? |
+| Seus Produtos (CRUD real: an??lise ??? aprova????o) | ??? |
+| Tema claro/escuro | ??? |
 
 ## Estrutura
 
-Consulte o [Planejamento Único](./PRODMAKER%20—%20PLANEJAMENTO%20ÚNICO%20E%20COMPLETO.md) para a visão completa (arquitetura, UI AdsX, módulos, fases e regras), o [Manual de Instalação](./MANUAL-INSTALACAO.md) e as [Regras do Repositório](./AGENTS.md).
+Consulte o [Planejamento ??nico](./PRODMAKER%20???%20PLANEJAMENTO%20??NICO%20E%20COMPLETO.md) para a vis??o completa (arquitetura, UI AdsX, m??dulos, fases e regras), o [Manual de Instala????o](./MANUAL-INSTALACAO.md) e as [Regras do Reposit??rio](./AGENTS.md).
+
+## Licen??a
 
-## Licença
+MIT ??? ver [LICENSE](./LICENSE) e [THIRD-PARTY-NOTICES](./THIRD-PARTY-NOTICES.md).
 
-MIT — ver [LICENSE](./LICENSE) e [THIRD-PARTY-NOTICES](./THIRD-PARTY-NOTICES.md).

package/app/main.py

@@ -15,7 +15,7 @@ from .services.database import ensure_db, get_db, now_str, row_to_dict
 from .services.llm import LLMError, analyze_product, list_providers
 from .services.store import PRODMAKER_HOME, STORAGE, STATE, ensure_state_dir, get_master_code, get_settings, save_settings
 
-APP_VERSION = "0.1.16"
+APP_VERSION = "0.1.17"
 COOKIE_NAME = "prodmaker_session"
 SESSION_DAYS = 30
 MASTER_ALIAS = "admin"
@@ -272,7 +272,7 @@ def health():
 
 @app.get("/api/version")
 def version():
-    return {"version": APP_VERSION, "canonical": "0.1.16"}
+    return {"version": APP_VERSION, "canonical": "0.1.17"}
 
 
 @app.get("/api/settings")
@@ -392,3 +392,16 @@ def spa_fallback(full_path: str):
     if full_path and candidate.is_file():
         return FileResponse(candidate)
     return _spa_index()
+
+
+# ---------------------------------------------------------------------------
+# Entry point manual — permite rodar sem o launcher (útil para ver tracebacks):
+#   .\venv\Scripts\python.exe app/main.py
+# ---------------------------------------------------------------------------
+
+if __name__ == "__main__":
+    import uvicorn
+
+    porta = int(os.environ.get("PRODMAKER_PORT") or 8188)
+    print(f"[ProdMaker] Iniciando em http://127.0.0.1:{porta} — mantenha esta janela aberta (CTRL+C para encerrar).")
+    uvicorn.run(app, host="127.0.0.1", port=porta)

package/app/services/database.py

@@ -3,6 +3,9 @@
 Esquema unico para os dois engines. Todas as tabelas carregam `user_id` (preparacao
 multi-tenant — hoje vazio). `ensure_db()` cria o que falta e aplica ALTERs de migracao.
 """
+import sqlite3
+import time
+
 from .dbengine import (
     add_column_if_missing,
     is_postgres,
@@ -273,19 +276,96 @@ def get_db():
     return connect()
 
 
-def ensure_db() -> None:
-    with get_db() as conn:
-        if is_postgres():
-            for ddl in TABLES.values():
+def _create_tables(conn) -> list[str]:
+    """Cria todas as tabelas; erros por instrução são coletados, nunca abortam."""
+    erros: list[str] = []
+    if is_postgres():
+        for nome, ddl in TABLES.items():
+            try:
                 conn.execute(_pg_ddl(ddl))
-        else:
-            for ddl in TABLES.values():
-                conn.execute(ddl)
-            # Migracao: bancos criados antes da coluna user_id / da tabela investimentos
-            for table in ALL_TABLES:
-                add_column_if_missing(conn, table, "user_id TEXT NOT NULL DEFAULT ''", "user_id")
-        conn.execute("CREATE INDEX IF NOT EXISTS idx_vendas_gclid ON vendas (gclid)")
-        conn.execute("CREATE INDEX IF NOT EXISTS idx_visitas_gclid ON visitas (gclid)")
+            except Exception as exc:  # noqa: BLE001
+                erros.append(f"{nome}: {exc}")
+        return erros
+    for nome, ddl in TABLES.items():
+        try:
+            conn.execute(ddl)
+        except sqlite3.DatabaseError as exc:
+            erros.append(f"{nome}: {exc}")
+    # Migracao: bancos criados antes da coluna user_id / das novas tabelas
+    for table in ALL_TABLES:
+        try:
+            add_column_if_missing(conn, table, "user_id TEXT NOT NULL DEFAULT ''", "user_id")
+        except Exception as exc:  # noqa: BLE001
+            erros.append(f"user_id/{table}: {exc}")
+    for index in ("CREATE INDEX IF NOT EXISTS idx_vendas_gclid ON vendas (gclid)", "CREATE INDEX IF NOT EXISTS idx_visitas_gclid ON visitas (gclid)"):
+        try:
+            conn.execute(index)
+        except sqlite3.DatabaseError:
+            pass
+    return erros
+
+
+def _sqlite_file():
+    from .dbengine import _sqlite_path
+
+    return _sqlite_path()
+
+
+_CORRUPCAO_MARCADORES = ("not a database", "malformed", "encrypted", "corrupt", "database disk image")
+
+
+def _parece_corrupcao(exc: Exception) -> bool:
+    texto = str(exc).lower()
+    return any(marcador in texto for marcador in _CORRUPCAO_MARCADORES)
+
+
+def _recriar_banco() -> None:
+    arquivo = _sqlite_file()
+    backup = arquivo.with_name(f"prodmaker.db.corrupt-{time.strftime('%Y%m%d-%H%M%S')}")
+    try:
+        arquivo.rename(backup)
+        print(f"[ProdMaker] Banco SQLite corrompido movido para: {backup.name} — recriando vazio.")
+    except OSError:
+        try:
+            arquivo.unlink(missing_ok=True)
+            print("[ProdMaker] Banco SQLite corrompido removido — recriando vazio.")
+        except OSError:
+            print("[ProdMaker] Banco SQLite corrompido e não pode ser removido.")
+            return
+    with get_db() as conn:
+        _create_tables(conn)
+
+
+def ensure_db() -> None:
+    """Cria/migra o banco. Se o arquivo SQLite estiver CORROMPIDO, faz backup e recria
+    (o Uvicorn nunca cai na inicialização por causa do banco)."""
+    if is_postgres():
+        with get_db() as conn:
+            _create_tables(conn)
+        return
+    conn = get_db()
+    try:
+        try:
+            _create_tables(conn)
+            # Probe de integridade: leitura real detecta arquivo corrompido.
+            conn.execute("SELECT COUNT(*) FROM produtos").fetchone()
+            return
+        except sqlite3.DatabaseError as exc:
+            if not _parece_corrupcao(exc):
+                # Erro de disco/permissão etc: não descarta o arquivo do usuário.
+                print(f"[ProdMaker] Aviso na inicialização do banco: {exc}")
+                return
+            corrompido = True
+    finally:
+        # IMPORTANTE (Windows): o context manager do sqlite3 NÃO fecha a conexão;
+        # sem close() o arquivo fica travado e o rename do recovery falha.
+        try:
+            conn.close()
+        except Exception:  # noqa: BLE001
+            pass
+    if not corrompido:
+        return
+    _recriar_banco()
 
 
 ensure_db()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/prodmaker",
-  "version": "0.1.16",
+  "version": "0.1.17",
   "description": "ProdMaker — SaaS local para criação de infoprodutos, landing pages, campanhas e tracking (base AdsX).",
   "license": "MIT",
   "type": "module",

package/scripts/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/* ProdMaker launcher — install | run | doctor
+/* ProdMaker launcher ??? install | run | doctor
  * REGRA ZERO: este launcher NUNCA abre o navegador. Apenas imprime a URL.
  */
 import { spawn, spawnSync } from "node:child_process";
@@ -14,7 +14,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = path.resolve(__dirname, "..");
 const APP_DIR = path.join(PKG_ROOT, "app");
 const REQUIREMENTS = path.join(PKG_ROOT, "requirements.txt");
-const APP_VERSION = "0.1.16";
+const APP_VERSION = "0.1.17";
 const DEFAULT_PORT = 8188;
 
 const STORAGE_FOLDERS = ["state", "pages", "produtos", "artifacts", "downloads", "logs"];
@@ -117,17 +117,17 @@ function runCommand(cmd, args, options = {}) {
 
 async function commandInstall(flags) {
   const home = resolveHome();
-  console.log(`ProdMaker ${APP_VERSION} — install`);
+  console.log(`ProdMaker ${APP_VERSION} ??? install`);
   console.log(`Pasta de dados (PRODMAKER_HOME): ${home}`);
   const settingsPath = ensureInstallSkeleton(home);
   console.log(`Storage pronto. Settings: ${settingsPath}`);
 
   if (flags.skipPythonDeps) {
-    console.log(" (--skip-python-deps) Dependências Python ignoradas.");
+    console.log(" (--skip-python-deps) Depend??ncias Python ignoradas.");
   } else {
     const base = findSystemPython();
     if (!base) {
-      console.error("Python 3.10+ não encontrado. Instale o Python e rode 'prodmaker install' novamente.");
+      console.error("Python 3.10+ n??o encontrado. Instale o Python e rode 'prodmaker install' novamente.");
       process.exit(1);
     }
     const venvDir = path.join(home, "venv");
@@ -141,17 +141,17 @@ async function commandInstall(flags) {
       }
     }
     const python = venvPython(home);
-    console.log("Instalando dependências Python (requirements.txt)...");
+    console.log("Instalando depend??ncias Python (requirements.txt)...");
     const code = await runCommand(python, ["-m", "pip", "install", "--upgrade", "pip"]);
     const code2 = await runCommand(python, ["-m", "pip", "install", "-r", REQUIREMENTS]);
     if (code2 !== 0) {
-      console.error("Falha ao instalar dependências Python.");
+      console.error("Falha ao instalar depend??ncias Python.");
       process.exit(1);
     }
   }
 
   console.log("");
-  console.log("Instalação concluída. Para iniciar:");
+  console.log("Instala????o conclu??da. Para iniciar:");
   console.log("  npx --yes @danhachuel/prodmaker");
   console.log("Depois abra http://localhost:8188 MANUALMENTE no navegador (o sistema nunca abre o navegador).");
 }
@@ -175,7 +175,7 @@ async function commandRun() {
   const home = resolveHome();
   const settingsPath = storagePath(home, "state", "settings.json");
   if (!fs.existsSync(settingsPath)) {
-    console.error("ProdMaker ainda não está instalado. Rode primeiro: prodmaker install");
+    console.error("ProdMaker ainda n??o est?? instalado. Rode primeiro: prodmaker install");
     process.exit(1);
   }
   let preferred = DEFAULT_PORT;
@@ -186,20 +186,20 @@ async function commandRun() {
 
   const python = venvPython(home) || findSystemPython();
   if (!python) {
-    console.error("Python não encontrado. Rode: prodmaker install");
+    console.error("Python n??o encontrado. Rode: prodmaker install");
     process.exit(1);
   }
   if (!fs.existsSync(path.join(APP_DIR, "main.py"))) {
-    console.error("Backend não encontrado (app/main.py).");
+    console.error("Backend n??o encontrado (app/main.py).");
     process.exit(1);
   }
 
   const port = await pickPort(preferred);
   if (!port) {
-    console.error("Nenhuma porta disponível entre " + preferred + " e " + (preferred + 11) + ".");
+    console.error("Nenhuma porta dispon??vel entre " + preferred + " e " + (preferred + 11) + ".");
     process.exit(1);
   }
-  if (port !== preferred) console.log(`Porta ${preferred} ocupada — usando ${port}.`);
+  if (port !== preferred) console.log(`Porta ${preferred} ocupada ??? usando ${port}.`);
 
   const pythonCmd = venvPython(home) ? python : python;
   const pythonArgs = venvPython(home)
@@ -211,28 +211,49 @@ async function commandRun() {
   console.log("Iniciando ProdMaker...");
   const masterCode = await fetchMasterCode(pythonCmd, home);
   printUrlBox(port, masterCode);
+  console.log("O servidor est?? rodando. Mantenha esta janela aberta. Pressione CTRL+C para encerrar.");
+  console.log("");
 
   const env = { ...process.env, PRODMAKER_HOME: home, PRODMAKER_PORT: String(port) };
+  // No Windows usamos shell:true para o terminal ficar anexado ao processo
+  // (comportamento correto no CMD/MobaXterm/PowerShell).
+  const useShell = process.platform === "win32";
   const child = spawn(pythonCmd, pythonArgs, {
     cwd: PKG_ROOT,
     stdio: "inherit",
     env,
-    shell: false,
+    shell: useShell,
   });
+  const started = Date.now();
   const stop = () => {
     child.kill();
     process.exit(0);
   };
   process.on("SIGINT", stop);
   process.on("SIGTERM", stop);
+  child.on("error", (error) => {
+    console.error(`Falha ao iniciar o Python (${error.message}).`);
+    console.error("Rode manualmente para ver o erro completo:");
+    console.error(`  ${pythonCmd} -m uvicorn app.main:app --host 127.0.0.1 --port ${port}`);
+    process.exit(1);
+  });
   child.on("close", (code) => {
-    console.log(`ProdMaker encerrou (código ${code ?? 0}).`);
+    if (Date.now() - started < 3000 && code !== 0) {
+      console.error(`O servidor encerrou imediatamente (c??digo ${code ?? 0}). Poss??vel erro de banco ou depend??ncia.`);
+      console.error("Para ver o traceback completo, rode manualmente (dentro da pasta do ProdMaker):");
+      console.error(`  cd ${home} && .\\venv\\Scripts\\python.exe -m app.main`);
+      console.error("  (ou .\\venv\\Scripts\\python.exe -m uvicorn app.main:app --host 127.0.0.1 --port " + port + ")");
+      process.exit(code ?? 1);
+    }
+    console.log(`ProdMaker encerrou (c??digo ${code ?? 0}).`);
     process.exit(code ?? 0);
   });
+  // Mant??m o processo vivo enquanto o filho estiver rodando
+  await new Promise((resolve) => child.on("close", resolve));
 }
 
 async function commandDoctor() {
-  console.log(`ProdMaker ${APP_VERSION} — doctor`);
+  console.log(`ProdMaker ${APP_VERSION} ??? doctor`);
   console.log(`Node: ${process.version}`);
   const home = resolveHome();
   console.log(`PRODMAKER_HOME: ${home}`);
@@ -241,10 +262,10 @@ async function commandDoctor() {
   console.log(`Venv: ${venv || "ausente"}`);
   if (venv) {
     const check = spawnSync(venv, ["-c", "import fastapi, uvicorn"], { encoding: "utf8" });
-    console.log(`Dependências Python (fastapi/uvicorn): ${check.status === 0 ? "OK" : "FALTANDO (rode install)"}`);
+    console.log(`Depend??ncias Python (fastapi/uvicorn): ${check.status === 0 ? "OK" : "FALTANDO (rode install)"}`);
   } else {
     const base = findSystemPython();
-    console.log(`Python do sistema: ${base || "não encontrado"}`);
+    console.log(`Python do sistema: ${base || "n??o encontrado"}`);
   }
   console.log(`Backend (app/main.py): ${fs.existsSync(path.join(APP_DIR, "main.py")) ? "OK" : "FALTANDO"}`);
   const dist = path.join(PKG_ROOT, "frontend", "dist", "index.html");
@@ -268,3 +289,4 @@ main().catch((error) => {
   console.error(error);
   process.exit(1);
 });
+