chore: scaffold painel-clientes-web

.env.example

@@ -0,0 +1,13 @@
+# Copie para .env e preencha antes de rodar (nunca commitar o .env real).
+
+ADMIN_USER=admin
+ADMIN_PASSWORD=SUBSTITUA_POR_UMA_SENHA_FORTE
+
+# Banco de dev (mesmo container do projeto n8n / contatos-chave-web):
+#   DB_HOST=host.docker.internal   (se este app tambem rodar em container)
+#   DB_HOST=127.0.0.1              (se este app rodar direto na maquina)
+DB_HOST=127.0.0.1
+DB_PORT=3307
+DB_NAME=gtisoftw_clientes_dev
+DB_USER=root
+DB_PASSWORD=devpassword123

.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.venv/
+.env

Dockerfile

@@ -0,0 +1,7 @@
+FROM python:3.12-slim
+WORKDIR /app
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+COPY app ./app
+EXPOSE 8000
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]

docker-compose.yml

@@ -0,0 +1,8 @@
+services:
+  painel:
+    build: .
+    ports:
+      - "8010:8000"
+    env_file:
+      - .env
+    restart: unless-stopped

pytest.ini

@@ -0,0 +1,3 @@
+[pytest]
+testpaths = tests
+pythonpath = .

requirements-dev.txt

@@ -0,0 +1,3 @@
+-r requirements.txt
+pytest==8.3.3
+httpx==0.27.2

requirements.txt

@@ -0,0 +1,6 @@
+fastapi==0.115.0
+uvicorn[standard]==0.30.6
+jinja2==3.1.4
+python-multipart==0.0.9
+PyMySQL==1.1.1
+python-dotenv==1.0.1

tests/conftest.py

@@ -0,0 +1,16 @@
+"""
+Configuração compartilhada dos testes. Define defaults de conexão iguais ao
+.env.example ANTES de qualquer módulo do app ser importado, para os testes
+rodarem direto contra o container de dev (licenciamento-mysql-dev, porta
+3307) sem exigir setup manual — quem rodar `pytest` só precisa ter esse
+container de pé (docker-compose.yml de licenciamento-n8n/ ou Banco para Prod/).
+"""
+import os
+
+os.environ.setdefault("ADMIN_USER", "admin")
+os.environ.setdefault("ADMIN_PASSWORD", "teste123")
+os.environ.setdefault("DB_HOST", "127.0.0.1")
+os.environ.setdefault("DB_PORT", "3307")
+os.environ.setdefault("DB_NAME", "gtisoftw_clientes_dev")
+os.environ.setdefault("DB_USER", "root")
+os.environ.setdefault("DB_PASSWORD", "devpassword123")