Recién Llegado - Modo Demo de MaraDocs y Arquitectura de Software

Hemos aprovechado el fin de semana de Pascua para desarrollar y publicar un Modo Demo para MaraDocs.

El blog de MaraDocs es una mezcla entre plataforma de anuncios de eventos relacionados con MaraDocs y también un lugar para plasmar reflexiones relacionadas con temas legales y tecnológicos.

Estamos increíblemente orgullosos...

Raui y yo hemos trabajado intensamente en MaraDocs durante el último año. Después de varios meses de trabajo preliminar de mi parte, hemos dedicado seguramente 8 meses de puro desarrollo de producto. Siempre con el objetivo en mente: crear la solución de preparación de documentos para despachos jurídicos que nos libere a todos del dolor de las bandejas de entrada de correo postal de calidad cada vez peor.

Hemos colaborado con algunos despachos asociados (¡un saludo para RA Bafteh de BSvH!) para asegurarnos de no desarrollar de espaldas al usuario final. Y hemos recibido muchos consejos muy útiles: por ejemplo, la vista previa de documentos surgió en gran medida gracias al feedback de una usuaria temprana (abogada en derecho de familia de Friburgo, ¡muchas gracias! :)) y las observaciones del personal de secretaría del despacho Kurtz & Lynen (https://kanzlei-kurtz.net).

...y sin embargo, todavía hay mucho por hacer

Un buen producto por sí solo no hace un producto exitoso. MaraDocs es excelente y es utilizado y apreciado diariamente por quienes lo usan para su trabajo cotidiano. Pero aquellos que aún no lo usan, generalmente todavía no lo conocen.

En un mundo sobrecargado de atención, no es fácil captar la atención de clientes potenciales.

El camino del cliente potencial es largo:

• Hay algo por ahí...

• Voy a probarlo...

• Realmente entro en el sitio web...

• Me registro con mi dirección de correo electrónico...

• Hago clic en el enlace de inicio de sesión que recibí por correo...

• Abro la aplicación y añado archivos adjuntos de correo para optimizar y me doy cuenta de que el producto es genial.

Atajos a la aplicación

Con el modo demo podemos reducir drásticamente el camino y ofrecer a los clientes potenciales una experiencia temprana, auténtica y sin complicaciones para probar MaraDocs. MaraDocs es divertido: la interfaz limpia y el mover y combinar páginas para crear nuevos PDFs tiene algo de lúdico.

Al mismo tiempo, el modo demo no nos cuesta nada. Para entender el contexto, hay que saber que la carga de archivos reales y adjuntos de correo genera costos en nuestra infraestructura. Debemos mantener ciertos recursos disponibles para poder procesar las solicitudes de procesamiento de los usuarios de forma rápida y reactiva. Un modo demo que enviara archivos reales a nuestros servidores y que ni siquiera requiriera registro, podría fácilmente llevar a que nuestros servidores se sobrecarguen con una multitud de solicitudes y nuestros clientes reales sufran las consecuencias.

Implementación técnica

En el frontend utilizamos React / NextJs. La aplicación React que se ejecuta en el navegador se comunica en modo normal con nuestros servidores responsables del procesamiento de archivos mediante WebSocket (WebSocket es una conexión bidireccional en la que el servidor también puede enviar resultados al navegador de forma autónoma, es decir, sin consultas del navegador).

Para mí era importante desarrollar el modo demo de manera que siempre refleje el estado actual de desarrollo de MaraDocs y no represente un nuevo sistema adicional que deba desarrollarse de forma independiente.

Redux Middleware

Gran parte de la lógica de flujo interna de la aplicación está controlada por Redux-Middlewares. En última instancia, se puede imaginar la aplicación como una enorme máquina de estados, en la que diferentes eventos desencadenan procesos predefinidos y modifican la representación interna de datos.

Un evento es, por ejemplo, hacer clic en un botón (p. ej., rotar esta página PDF) o también insertar un archivo en la aplicación o incluso un mensaje WebSocket del servidor con los resultados de un PDF optimizado.

Decidí implementar las partes asíncronas de las acciones que siguen a estos eventos, como el envío de datos por WebSocket al servidor, pero también algunos de los extensos procesamientos de PDF que realizamos en el navegador, en lógica de middleware. Estos middleware(s) escuchan y reaccionan ante ciertos eventos y luego ejecutan lógica.

Hot-Swapping de Middlewares

Entonces, en el modo demo se inicia nuestra aplicación normal. Sin embargo, durante el registro de los diferentes middlewares, el que normalmente realiza la comunicación WebSocket se intercambia por un middleware de demostración que, ante los eventos correspondientes, muestra resultados simulados (prefabricados) con un pequeño tiempo de espera.

Por lo tanto, estos archivos no tienen que ser analizados y optimizados por nuestros servidores cada vez, sino solo una única vez. Luego pueden cargarse una y otra vez desde nuestra caché estática y, de esta manera, prácticamente no generan costos.

Reflexiones generales sobre Redux

Redux es una forma particular de gestionar el state en aplicaciones Javascript. Se basa en la idea de que solo las llamadas actions, que deben ejecutarse de una manera específica, pueden modificar los datos de estado presentes en la aplicación. React, por ejemplo, puede asegurarse de esta manera de que las partes visibles de la aplicación reaccionen a los cambios de estado.

La biblioteca Redux, que ha popularizado este modelo de software al menos en el mundo frontend (Redux), se considera en parte como excesivamente compleja y en muchos proyectos más recientes está siendo reemplazada por alternativas más ligeras. Sin embargo, hemos evaluado cuidadosamente su uso para nosotros. En particular, la potente estructura de middleware nos ha permitido llevar una aplicación tan compleja como MaraDocs al navegador.

El modo demo y la fácil gestión de activarlo y desactivarlo mediante el intercambio de un solo "módulo" (el middleware), confirma para mí que hemos apostado por el caballo correcto.

Conclusión

Me alegra especialmente recibir comentarios de colegas del sector legal que comparten conmigo la pasión por la digitalización y el desarrollo de software.

El artículo de hoy ha sido algo más técnico. Pero así es a veces: uno comienza sin compromiso y luego profundiza un poco más en los temas.

Comentarios / feedback / preguntas muy bienvenidos a través de LinkedIn o por correo electrónico a info@maradocs.io.