Plantillas IA

Quiero que construyas una aplicación web sencilla en Python (Flask), de un solo usuario, que corra en localhost y automatice consultas de opinión de cumplimiento vía FIEL contra la API de SAT-GO (https://api.sat-go.com), endpoint POST /api/v2/Consultar/ocfiel.

Objetivo funcional:
1. Página principal con un formulario simple: campo de texto tipo password (enmascarado) para pegar el JWT de SAT-GO, e input de archivo para subir un Excel (.xlsx) con una fila por contribuyente y estas columnas obligatorias: rfc, ruta_certificado (ruta local al .cer), ruta_llave (ruta local al .key) y contraseña (contraseña de la llave privada FIEL). Botón "Procesar".
2. Al enviar el formulario, el backend procesa cada fila del Excel: abre el .cer y el .key en modo binario (no se codifican en base64; se mandan tal cual como archivos del form-data) y llama al endpoint ocfiel como multipart/form-data con los headers RFC y Authorization: Bearer {jwt}. La respuesta 200 es el PDF directo en binario (Content-Type: application/pdf, con Content-Disposition: attachment; filename=OpionDeCumplimiento.pdf); se guarda tal cual, sin parsear JSON, en una carpeta salidas/ nombrado opinion_cumplimiento_{rfc}_{fecha}.pdf.
3. Página de resultados (misma página tras el submit, o vía JS/fetch mostrando progreso fila por fila): tabla con una fila por RFC procesado (RFC, estado OK/error, mensaje de error si aplica, botón/link para descargar el PDF de esa fila), botón "Descargar todo en ZIP" que junte todos los PDFs generados, y un resumen arriba de la tabla tipo "X de Y RFCs procesados correctamente".
4. El JWT nunca se guarda en disco ni queda en el Excel; solo vive en memoria durante esa ejecución del request.

Diseño visual: interfaz limpia y moderna (HTML + CSS simple, puede ser Bootstrap por CDN o CSS propio), indicador de "procesando..." mientras corre (puede tardar varios segundos por fila porque cada llamada implica login FIEL contra el SAT), colores claros para distinguir éxito (verde) y error (rojo) en la tabla de resultados.

Contrato del endpoint (ya confirmado con una petición real, no está sujeto a interpretación):
POST https://api.sat-go.com/api/v2/Consultar/ocfiel
Headers: RFC: {rfc}, Authorization: Bearer {jwt}, Content-Type: multipart/form-data (lo arma requests solo).
Body multipart/form-data con 3 partes: llavePrivada (archivo binario, el .key de la FIEL), Certificado (archivo binario, el .cer de la FIEL) y Contrasena (texto plano, contraseña de la llave privada).
Respuesta 200: Content-Type application/pdf, Content-Disposition attachment; filename=OpionDeCumplimiento.pdf — el body ES el PDF, guardar bytes directo a disco.
Respuesta 401: JWT inválido o vencido. Aún no está confirmado con la API el código o forma exacta de error si la contraseña de la FIEL es incorrecta o el .cer/.key no corresponden al RFC del header, así que el script debe capturar cualquier respuesta no-200/no-PDF como error y mostrar el body de la respuesta para diagnóstico.
Ejemplo equivalente con requests: files = {"llavePrivada": (nombre_key, open(ruta_llave, "rb")), "Certificado": (nombre_cer, open(ruta_certificado, "rb"))}, data = {"Contrasena": contrasena}, headers = {"RFC": rfc, "Authorization": f"Bearer {jwt}"}, resp = requests.post(url, headers=headers, files=files, data=data).

Requisitos técnicos: Python 3.10+, librerías flask, requests y pandas (o openpyxl) para leer el Excel. Debe existir un run.py (o lógica al inicio de app.py) que intente importar cada librería requerida y, si falta alguna, la instale automáticamente con subprocess.check_call([sys.executable, "-m", "pip", "install", paquete]) — usar siempre sys.executable, nunca pip a secas, para garantizar que se instale en el mismo intérprete que está corriendo la app. Si el pip install falla (sin internet, sin permisos, etc.), muestra un mensaje claro con el comando exacto que el usuario debe correr a mano, en vez de tronar con un traceback críptico. Incluye igualmente un requirements.txt para quien prefiera instalar todo antes con pip install -r requirements.txt. El JWT y las contraseñas de la FIEL nunca deben imprimirse en logs ni guardarse en disco. Maneja reintentos (2-3) solo para timeouts de red intermitentes; no reintentes en 401 (JWT vencido) — marca todas las filas restantes como error y muestra un mensaje pidiendo renovar el JWT. Valida antes de llamar a la API que las rutas de certificado y llave existen y son legibles; si falta un archivo, marca esa fila como error sin tronar el resto del proceso.

Estructura de archivos esperada: una carpeta app/ con run.py (arranca el servidor Flask en localhost:5000), app.py (rutas Flask / y /procesar), satgo_client.py (wrapper del endpoint ocfiel), excel_loader.py (lectura/validación del Excel), una subcarpeta templates/ con index.html (formulario JWT + Excel) y resultados.html (tabla de resultados + descargas), una subcarpeta static/ con style.css, una carpeta salidas/ para los PDFs generados (créala si no existe) y requirements.txt.

Muy importante para evitar el error jinja2.exceptions.TemplateNotFound: Flask necesita que index.html y resultados.html vivan físicamente dentro de una carpeta llamada templates/ (y style.css dentro de static/), al mismo nivel que app.py, no sueltos junto a él. Este es el error más común al entregar o copiar el proyecto, así que: crea las carpetas por código si no existen (os.makedirs("templates", exist_ok=True) y os.makedirs("static", exist_ok=True) al inicio de run.py) y escribe ahí los .html/.css si tu flujo de entrega los genera como archivos sueltos, para que la estructura quede garantizada aunque el usuario copie los archivos a mano. En el README.md incluye explícitamente el árbol de carpetas final esperado y, si entregas los archivos uno por uno en vez de una carpeta completa, los comandos de PowerShell para reacomodarlos (mkdir templates, static / move index.html templates\ / move resultados.html templates\ / move style.css static\). Menciona también en el README una verificación rápida (dir templates y dir static deben mostrar los archivos esperados) antes de correr py run.py.

Nota sobre OneDrive: si el usuario va a correr la app dentro de una carpeta sincronizada con OneDrive, menciona en el README que normalmente no da problema, pero que si aparecen errores raros de "archivo en uso" o de permisos al escribir los PDFs en salidas/, mueva la carpeta del proyecto fuera de OneDrive (por ejemplo a C:\Users\{usuario}\satgo-app) como primer paso de diagnóstico.

Incluye un requirements.txt y un README.md corto con instrucciones de uso: cómo instalar, cómo levantar el servidor, y cómo abrirlo en el navegador (http://localhost:5000). En Windows a veces el comando python no está registrado en el PATH aunque sí lo esté el launcher py (viene con el instalador oficial de Python), así que el README debe incluir ambos comandos como opción (python run.py, y si no se reconoce, py run.py), indicando que se use el que funcione en la máquina del usuario.

Entregable: código completo y funcional de la app Flask (backend + templates HTML + CSS básico), con manejo de errores legible y comentarios breves en español explicando cada función. Si la herramienta que lo genera comparte los archivos sueltos en vez de una carpeta o zip que respete las subcarpetas, di explícitamente al final cuáles archivos van dentro de templates/ y cuáles dentro de static/, para que no tenga que adivinarlo — esto es justo lo que causa el error TemplateNotFound cuando se pierde la estructura de carpetas al descargar.