Valverde Jurídico
Sistema SaaS de gestión jurídica para un despacho de abogados: clientes, procesos, agenda, portal del cliente y sitio institucional, del UX al back-end
- Mi rol
- Desarrollador Full Stack · Diseñador UX/UI
Valverde JurídicoContexto
Valverde Jurídico es un despacho de abogados. Fui el único responsable del proyecto: diseñé la experiencia y desarrollé todo el sistema, de la base de datos a las pantallas. Partí del sitio institucional, que migré a Next.js manteniendo el design system, y construí por sprints el panel del despacho y el portal del cliente.
- Cliente
- Valverde Jurídico
- Categoría
- SaaS · Jurídico
- Roles
- Desarrollador Full Stack, Diseñador UX/UI
- Stack
- Next.js, React, NestJS, Prisma, PostgreSQL, Redis
Desafío
Clientes, procesos, plazos y audiencias estaban dispersos en planillas y agendas, sin visión del avance de cada caso. El sistema tenía que reunir todo en un solo lugar y, al mismo tiempo, respetar quién puede ver y hacer qué: socios, abogados, asistentes, finanzas y el propio cliente, con datos sensibles protegidos y cada cambio registrado.
El sistema, pantalla por pantalla
Todas las pantallas con la misma estructura: menú lateral por módulo, búsqueda arriba, números del momento en tarjetas, tablas y estados de colores y un único botón dorado para la acción principal.
- 01 / 20
Sitio institucional
La puerta de entrada del despacho: la promesa de asesoría jurídica estratégica, las áreas de actuación, los diferenciales, testimonios y el formulario de contacto con validación en el navegador y en el servidor.
- 02 / 20
Portal del cliente
Un área separada para que el cliente del despacho entre con su propio e-mail y siga su caso, con login, recuperación de contraseña y el mismo sistema visual del sitio.
- 03 / 20
Dashboard
La visión general del despacho: clientes activos, procesos activos, procesos urgentes y tareas pendientes, la distribución de procesos por estado y los procesos actualizados recientemente, con prioridad y estado en cada fila.
- 04 / 20
Clientes
El CRM jurídico: búsqueda por nombre, CPF/CNPJ o e-mail, filtros por estado, tipo de persona, ciudad, estado, responsable y etiquetas, acciones en lote y exportación.
- 05 / 20
Ficha del cliente
Todo sobre el cliente en una página: datos de la persona o de la empresa, contactos, dirección y etiquetas, con pestañas de observaciones, línea de tiempo, documentos, procesos, finanzas y agenda.
- 06 / 20
Nuevo cliente
El registro cambia según el tipo, persona física o jurídica, y valida CPF y CNPJ por los dígitos verificadores antes de guardar.
- 07 / 20
Importación por CSV
Para traer la cartera que ya existía en planillas: el despacho arrastra un archivo CSV y el sistema registra a los clientes de una vez.
- 08 / 20
Procesos
La lista de procesos con número CNJ, cliente, área del derecho, clase, tribunal, juzgado, estado, prioridad y abogado responsable, con filtros por período, tribunal, juzgado y etiquetas.
- 09 / 20
Kanban de procesos
Los mismos procesos en columnas por estado (nuevo, en curso, esperando documentación, esperando audiencia…). Arrastrar la tarjeta cambia el estado y queda registrado en la línea de tiempo.
- 10 / 20
Ficha del proceso
El número CNJ validado, estado y prioridad arriba y los datos del proceso: clase, asunto, tribunal, comarca, juzgado, instancia y valor de la causa, con pestañas para todo lo que ocurre en el caso.
- 11 / 20
Partes involucradas
Demandante, demandado, terceros, testigos y peritos de cada proceso y, en la pestaña de al lado, los responsables del equipo: abogado principal, auxiliar y asistente.
- 12 / 20
Comentarios con menciones
La conversación del equipo dentro del proceso, con editor de texto, respuestas y @menciones que avisan al colega.
- 13 / 20
Checklist
Lo que falta para que el proceso avance (poder, documentos, cálculos), con el progreso de los ítems completados.
- 14 / 20
Movimientos
El registro de cada movimiento con fecha y autor. El origen queda guardado: manual o proveniente de integraciones con tribunales, como el DataJud del CNJ y el PJe.
- 15 / 20
Línea de tiempo
La auditoría del caso: cada registro, parte, responsable, comentario y cambio de estado aparece en orden, con quién lo hizo y cuándo.
- 16 / 20
Agenda jurídica
Los compromisos del despacho en números (hoy, próximos 7 y 30 días, plazos y tareas atrasados), los plazos críticos destacados y las próximas audiencias y reuniones.
- 17 / 20
Calendario
Vistas de día, semana, mes y lista, con cada tipo de evento en un color. Se puede arrastrar un evento para reprogramarlo o hacer clic en un horario libre para crearlo.
- 18 / 20
Plazos
Plazos procesales con responsable, prioridad y estado (pendiente, atrasado), vinculados al proceso y con recordatorios automáticos antes del vencimiento.
- 19 / 20
Tareas
Las tareas del equipo con checklist y porcentaje completado, prioridad, estado y plazo.
- 20 / 20
Integraciones
La infraestructura para conectar el despacho con servicios externos: colas de sincronización de procesos, e-mail, notificaciones, OCR, documentos e inteligencia artificial, con providers, webhooks y logs.
En el celular
El panel se reorganiza para pantallas pequeñas: los indicadores se vuelven tarjetas apiladas, el kanban se desplaza de lado y la agenda muestra primero los números del día.
Arquitectura
Un monorepo con pnpm y Turborepo, que separa el front-end, que solo habla con su propio origen, del back-end, donde viven las reglas.
- Front-end
- Next.js 15 (App Router) y React 19, Tailwind, shadcn/ui, TanStack Table, dnd-kit en el kanban, TipTap en los comentarios, React Hook Form y Zod
- Back-end
- NestJS 11 en módulos (auth, clientes, procesos, agenda, finanzas, integraciones, auditoría…), con casos de uso y repositorios separados
- Datos
- PostgreSQL con Prisma: 48 tablas y migraciones versionadas; archivos en Supabase Storage
- Colas
- Redis y BullMQ para sincronizaciones, e-mails y recordatorios, con cola de fallos (dead letter queue)
Seguridad e integridad
Un sistema jurídico guarda datos sensibles, así que la seguridad se trató en el back-end desde el primer sprint:
- Autenticación
- Tokens JWT de acceso y renovación en cookies httpOnly, contraseñas con argon2 y recuperación de contraseña por e-mail
- Perfiles
- 6 perfiles con permisos propios: administrador, socio, abogado, asistente, finanzas y cliente
- Protecciones
- Verificación de origen contra CSRF, límite de solicitudes por ruta y encabezados de seguridad
- Validación
- CPF, CNPJ y número CNJ verificados por los dígitos verificadores, en el navegador y en el servidor
- Auditoría
- Registro de quién hizo cada cambio, con línea de tiempo por cliente y por proceso
En números
Construido en sprints: sitio y base, clientes, procesos, integraciones y agenda. El módulo financiero (contratos, honorarios, cuotas y gastos) ya existe en el back-end, con sus pantallas en desarrollo.
13
módulos en el back-end
48
tablas en la base de datos
6
perfiles de acceso con permisos propios
Sistema Visual
Un aspecto sobrio para un despacho de abogados: beige y blanco en los fondos, el dorado como color de acción, Playfair Display en los títulos para el tono tradicional e Inter en el resto para leer tablas y formularios.
Paleta
Dorado
#C4A36E
Botones, ítem activo del menú y destacados
Dorado Claro
#F3EDE2
Íconos, avatares y selección
Beige Fondo
#FAF8F5
Fondo de las pantallas
Beige Menú
#F6F3EE
Menú lateral
Grafito
#2B2B2B
Títulos y textos
Tipografía
Playfair Display
400 / 700
Títulos y logotipo
Inter
400 / 500 / 600
Interfaz, tablas y formularios
Aprendizaje
Construir un sistema de este tamaño solo exige orden: empezar por el modelo de datos y las reglas, entregar un módulo por sprint y solo entonces diseñar las pantallas sobre lo que el back-end garantiza. La arquitectura en módulos permitió crecer de clientes a procesos, agenda e integraciones sin reescribir lo que ya funcionaba.
Otros proyectos para conocer.
SaaS · Service DeskSETTE Tecnologia: Service Desk
Service Desk SaaS: portal del colaborador para abrir tickets y agendar atención, central del equipo de TI con cola, SLA y agenda, y app mobile, del UX al back-end
Ver proyecto
SaaS · Producto propioSeu Barba
SaaS de agendamiento para barberías: marca, app y landing page de ventas, producto propio en desarrollo
Ver proyecto
SaaS · GestiónMinas Gás
Sistema de gestión para una distribuidora de gas: pedidos, stock y envases, entregas, caja y finanzas en una sola aplicación web, con app para los conductores
Ver proyecto