Resumen Ejecutivo de Desarrollo

Lo más relevante

Ritmo de entrega

Commits por día en los cuatro repositorios de código durante la semana. Commits por día en los cuatro repositorios de código durante julio. Pasa el cursor sobre cada barra para ver el detalle.

Distribución del trabajo

Relación funcionalidad/corrección de 1.2 : 1 esta semana, contra 1.6 : 1 en el mes. El peso de las correcciones subió por el trabajo de seguridad en la base de datos, que se registra como fix aunque sea trabajo estructural planeado. Relación funcionalidad/corrección de 1.6 : 1 — el equipo trabajó mayoritariamente en construcción, no en apagar incendios.

Actividad por repositorio

Plataforma administrativa · admin.sozu.com

119 commits y 109 PRs esta semana. Módulos con mayor actividad: 395 commits y 332 PRs en julio. Módulos con mayor actividad:

CRM

• Pool de contactos: todos ven, pero solo el dueño (o un admin, o si no tiene dueño) edita y registra actividad.
• Contactos agrupados por persona vía RPC, con fila expandible y prevención de duplicados en el alta.
• Columna Fuente del registro alimentada por el campo origen, mostrando el dominio real de la landing en vez de sozu.com fijo.
• Módulo Meta Ads con señal MQL gestionable, campañas server-side y pestaña de Registro de envíos del log de CAPI.
• Las tareas del módulo abren la ficha del contacto en la pestaña de Actividades; los filtros se recuerdan por usuario.
• Borrado de contactos y negocios condicionado a permiso de rol.
• Carga masiva desde Excel/CSV con mapeo de columnas, vista Tablero (Kanban) con arrastre entre etapas, pipelines administrables y citas como actividad nativa.

Portal Agente y oferta digital

• Verificación de identidad facial local con @vladmandic/human y expediente unificado.
• Compartir y reenviar la oferta digital desde pipeline y prospectos; descarga de PDF bajo demanda.
• Pago de apartado por SPEI con activación por whitelist; prioriza la CLABE de la cuenta de cobranza.
• Token de reservación como credencial de los links públicos de oferta.
• CSF solicitada antes del pago, con salto automático para clientes ya existentes.
• Tabla de comisiones reutilizable con subida de factura; modales bottom-sheet en móvil.
• Rediseño integral de UI/UX del portal, esquemas escalonados dinámicos y desglose de bodega incluida en ficha técnica y PDF.

Portal Bancos

3 entregas en admin y 3 migraciones. El portal dejó de verse igual para todos: ahora cada banco entra a su propia versión. 9 entregas en admin y 8 migraciones. Nació el 10 de julio como bandeja de solicitudes de crédito y cierra el mes como portal marca blanca.

• Branding por banco: el portal se tematiza con color_marca del convenio. El color se convierte a HSL y sobrescribe las variables del design system en el contenedor raíz, así que todo lo que use bg-primary, text-primary o ring-* hereda la marca sin tocar un solo componente.
• Logo e ícono: columnas logo_url e icono_url nuevas en bancos_convenio. La pantalla Bancos ya subía el archivo al bucket documentos e intentaba guardar la URL, pero las columnas no existían: la imagen quedaba huérfana y el botón seguía diciendo «Subir». El header muestra el ícono cuadrado, o el logo si no hay ícono, o un cuadro con el color y las iniciales si no hay ninguno — el portal nunca queda sin identidad visual.
• Efecto secundario del mismo bug: useBancosConvenio pedía esas columnas en su consulta completa; al fallar caía a la consulta básica, que tampoco traía tasa_min, tasa_max, cat_min ni cat_max. Con las columnas creadas, el portal recuperó las tasas.
• Permisos desde la base de datos en lugar de listas en el código, con alta del submenú Notarías y permisos para los roles Supervisor y Operador Banco.
• Notarías por proyecto con selector visible solo para Super Admin, y directorio de contacto.
• Detalle de propiedad dentro de la solicitud, y ejecutivos inactivos ocultos del Equipo.
• Aislamiento por banco: cada usuario ve solo las solicitudes de su institución vía usuarios.id_banco, con vista global reservada a Super Admin y «Ver como» por usuario. Bitácora y asignación automática sin DDL, SLA y tasas por banco, desglose de pagos en panel lateral, y expiración de solicitudes por cron.

Acceso de cuentas y reportes

• Confirmación de correo, seis correcciones en la semana. El enlace de confirmación fallaba por varias causas encadenadas: no se declaraba el tipo de token que emitió GoTrue, el token se reconsumía tras un redirect, y un enlace vencido se veía igual que una cuenta ya confirmada. Se agregó reintento con el tipo contrario, mensajes que distinguen cada caso y el mapeo del rol Embajador al portal que le corresponde.
• Titularidad exigida: el flujo ahora pide prueba de que quien confirma es dueño de la cuenta y expone el estado real en lugar de un éxito genérico.
• Exportación a Excel: los reportes salen como .xlsx formateado en vez de CSV, servido como octet-stream porque el tipo anterior corrompía el archivo. Se sumaron columnas de Tipo y estatus al Reporte 7.

Portales verticales

• Jurídico Fase 2: actuaciones con línea de tiempo, multiasunto por expediente, subida de documentos y orquestador crear_expediente_y_bloquear_cobranza.
• Notaría: Expediente de Desarrollo a nivel proyecto con carga múltiple, y reutilización del modelo documental común en lugar de tablas propias.
• Embajador: vista global de administrador y validación contra el expediente global.
• Cliente: expediente por tipo de persona, identificación del representante legal con cámara INE y acciones de subida según estatus del documento.
• Socio Bancario: portal nuevo con Ventas e Inventario, Expedientes y avance de obra. Propietarios: onboarding Fase 2 con subdominio propio y unidades reales desde BD.

App Clientes SOZU

15 commits en sozu-cliente-app y 23 en sozu-edge-functions. La semana se fue en dejarla lista para publicar. 73 commits en sozu-cliente-app (78 PRs) y 81 en sozu-edge-functions. El repositorio nació el 7 de julio: todo lo que sigue se construyó en 23 días.

Aplicación · Flutter (web / Android / iOS)

• Base multiplataforma: portal del cliente en Flutter con un solo código para web, Android e iOS; visor in-app de PDFs e imágenes con caché en disco de 7 días.
• Publicación: un solo workflow de Codemagic publica directo a App Store y Play Store. Se agregó el ícono SOZU en launcher y notificaciones, que hasta entonces mostraban el logo por defecto de Flutter.
• Version gate: la app avisa de actualizaciones y puede forzarlas, respaldado por la edge function cliente-app-version.
• Build de Android estabilizado: applicationId configurable desde el dashboard, keystore cifrado en Codemagic, firma de release corregida y reemplazo de file_picker por file_selector, que tenía roto el build.
• Caché web: headers correctos y eliminación del service worker, que estaba sirviendo versiones viejas.
• Ficha técnica: edificio en corte con elevador animado, planta horizontal y contadores animados en web.
• Seguridad de sesión: login biométrico en móvil, auto-logout tras 5 minutos de inactividad y cierre de sesión al pasar a segundo plano.
• Mapa y ubicación: "Cómo llegar" embebido en todas las plataformas, modos a pie / auto / bici, tracking en vivo con avatar por modo y ETA.
• Paridad con el portal: auditoría de los 9 menús, fases A–D de frontend y backend, y card de "registrar mi propiedad" en el login.
• Documentación automática al mergear a main.

Publicación en tiendas · estado de las cuentas de desarrollador

Android ya está en tienda; iOS depende de un trámite de cuenta, no de desarrollo. Este es el estado al corte:

Backend de la app · edge functions

• cliente-app-version: nueva función que respalda el version gate de la app nativa.
• cliente-expediente extrae automáticamente los datos de CURP y Acta de Nacimiento al subirlos.
• Galería con video en el detalle, foto de perfil y opción de marcar notificaciones como no leídas.
• cliente-documentos mapea el estatus 4 a "vencido"; cliente-perfil incluye ocupación.
• Las notificaciones ahora rutean a cada rol el portal que le corresponde.
• Estado de cuenta y recibos: edge function por propiedad con URL de recibo y CEP por pago, numeración de parcialidades y descarga segura del PDF.
• Notificaciones push: cliente-push-token y notificaciones-push sobre FCM v1, con preferencia on/off por cliente.

Landings de proyecto

42 commits esta semana sobre 2 landings activas, de 24 repositorios revisados en landings-sozu y sozu-com. 141 commits en julio sobre 6 landings activas, de 24 repositorios revisados en landings-sozu y sozu-com.

Las landings consumen RPCs públicas de Supabase (landing_margot_rpc, landing_daiku_rpc, landing_bottura_rpc) y sus formularios entran al CRM a través de lead-formulario-web, que registra el dominio real de origen. sozu-avances es el sitio de este mismo reporte, no una landing comercial. Los repositorios restantes están archivados, sin actividad desde 2022–2023.

Base de datos e infraestructura

66 migraciones esta semana, la mayoría concentradas en seguridad y esquema. 188 migraciones en julio. Principales bloques:

Endurecimiento de seguridad

• Las políticas RLS que tenían USING(true) o WITH CHECK(true) —es decir, que no filtraban nada— quedaron corregidas.
• Las funciones SECURITY DEFINER quedaron sin permiso de ejecución para anon y PUBLIC.
• Se cerró la escritura anónima en los catálogos que tenían una política "Allow all access", y en las policies passthrough del portal socio.
• Dos correcciones reactivas el mismo día: el revoke inicial rompió el Portal de Agentes, el Admin y el sitio público. Se re-otorgó EXECUTE a los helpers de autorización con una whitelist explícita.
• user_has_permission dejó de exigir la tabla legacy menus_roles.
• georgia_readonly quedó como miembro de georgia_mcp_ro, para que el agente respete RLS.

Limpieza de esquema

• DROP de las tablas, funciones y vistas marcadas previamente como borrar_*, más un drop dinámico que barre los remanentes de dev.
• Renumeración de migraciones para evitar colisiones de timestamp entre ramas.
• Depuración de RPCs muertas de recibo↔CEP y estandarización de fecha_actualizacion en las tablas del CRM.

Equipo

Commits productivos por persona esta semana. Haz clic en los encabezados para reordenar. Commits productivos por persona en julio. Haz clic en los encabezados para reordenar.

Infraestructura, herramientas y costos

Trabajo que no se refleja en el conteo de commits, pero que sostiene la operación de todo el equipo.

Infraestructura y DevOps

• Servidores y redes: mantenimiento de los servidores y de la VPN de la organización, y configuración de DNS de los dominios y subdominios de SOZU, incluido avances.sozu.com para este reporte.
• Entrega continua: pipelines de GitHub Actions para sozu-admin y las edge functions, Codemagic para la app móvil y Firebase Hosting para el portal del cliente; gestión de secretos, keystores y certificados de firma.
• Gobernanza de repos: CODEOWNERS, reglas de protección de ramas, validación de origen de PRs y notificaciones automáticas de PRs y deploys por WhatsApp.
• Manejo de secretos: el PAT de GitHub del pipeline de reportes pasó de vivir en disco a Google Secret Manager, con rotación central y auditoría de accesos.

Optimización de costos

• Claude: el gasto mensual bajó de forma sostenida a partir del análisis de consumo por desarrollador y de las recomendaciones de uso que se trabajaron directamente con el equipo — reducción de contexto innecesario, mejor selección de modelo por tipo de tarea y prompts más acotados.
• Lovable: el plan se reajustó y quedó en 100 USD mensuales.
• El criterio de fondo es el mismo en ambos casos: no se corta la herramienta, se corrige cómo se usa.

Agentes conversacionales · Platica

• Configuración de los agentes en Platica, la plataforma conversacional desde la que se atienden clientes y equipo: alta y ajuste de agentes, sus instrucciones, y qué información puede consultar cada uno.
• La conexión con los datos de SOZU pasa por el MCP propio (sozu-mcp), que expone las herramientas bajo un token propio y el rol de solo lectura georgia_readonly. El agente nunca escribe en la base de datos.
• Afinación continua de las respuestas conforme aparecen casos reales de uso.

Evaluación y administración de herramientas

• Evaluación continua de nuevas herramientas de desarrollo antes de incorporarlas al stack.
• Configuración inicial, acompañamiento al equipo y administración de licencias y accesos.
• Toda alta, cambio o contratación de herramienta pasa por su aprobación antes de ejecutarse.

Pendientes y riesgos

Lo que queda abierto al corte y lo que conviene vigilar.