Skip to content
ApoloArgonautPublic

About

Plataforma de acuerdos para freelancers — caso de estudio UX/UI/CX con prototipo funcional en React + TypeScript. SUS 87.8, 95.8% de éxito en tareas.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🛡️ PACTIO — Smart Agreements & Legal Shield for Digital Creators

Plataforma LegalTech de contratos inteligentes, preservación criptográfica NOM-151 y mediación de alcance para creadores de software, diseñadores y profesionales independientes en México y Latinoamérica.

Smart legal-tech platform featuring plain-language contract compilation, NOM-151 cryptographic preservation, and scope mediation for freelancers & agencies in LATAM.

React 19 TypeScript Docker Ready Tests Passing Legal Shield WCAG AAA

🇪🇸 Versión en Español • 🇺🇸 English Version • 📚 Documentación / Docs • 🐳 Docker


🇪🇸 Versión en Español

💡 ¿Qué es Pactio?

El 68% de los diseñadores, desarrolladores y creadores independientes en LATAM sufren impagos de finiquitos, clientes que exigen cambios infinitos (scope creep) o disputas por acuerdos informales en WhatsApp.

Pactio elimina la fricción entre creador y cliente mediante contratos digitales interactivos que cualquier persona puede entender sin tecnicismos legales, pero con validez jurídica plena ante tribunales y el SAT.

🌟 Pilares Principales de la Experiencia

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  1. ASISTENTE   │ ──> │  2. COMPILADOR  │ ──> │  3. SIMULADOR   │ ──> │   4. TIMBRADO   │
│   PARÁMETRICO   │     │    DUAL-PANE    │     │   NEGOCIACIÓN   │     │     NOM-151     │
│ Entregables en  │     │  Vista Humana   │     │ Cliente sugiere │     │  Sello legal    │
│ 5 minutos       │     │   vs. Jurídica  │     │ cambios sin lío │     │  admisible SAT  │
└─────────────────┘     └─────────────────┘     └─────────────────┘     └─────────────────┘
  1. Compilador Dual (Humano / Jurídico): Lectura en español claro ("con peras y manzanas") para el cliente y redacción jurídica vinculante para el contrato formal.
  2. Blindaje de Insumos & Reserva de Dominio (LFDA Art. 83): Los derechos del código y diseño se transfieren únicamente cuando se liquida el 100% del pago. Los plazos de entrega no corren hasta que el cliente entregue todos sus insumos.
  3. Simulador de Negociación Bilateral: Tu cliente puede solicitar ajustes en anticipos o rondas de revisión desde un enlace interactivo sin llamadas incómodas.
  4. Firma Multimodal & Timbrado Oficial: Firma con trazo táctil, tipografía script o e.firma SAT (procesada 100% en tu dispositivo, sin enviar tus claves a internet).
  5. Ergonomía Visual & Accesibilidad: 3 temas visuales (Midnight Dark, Warm Paper, High Contrast) con contraste WCAG 2.1 AAA.

📊 Resultados de las pruebas de usabilidad

Estudio con 8 participantes en dos cohortes, tareas moderadas y medición estandarizada:

Métrica Resultado Referencia
System Usability Scale (SUS) 87.8 / 100 Grado A+, percentil 96
Tasa de éxito en tareas 95.8% (23 de 24) Objetivo > 85%
Tiempo medio para crear un acuerdo 3 min 42 s Objetivo < 5 min
Hallazgos de auditoría implementados 12+ en 48 horas Ciclo de una semana

Dato de decisión: convertir la firma en un acto de dos pasos con «Solicitar ajuste» visible redujo el abandono del flujo. Antes, cada objeción del cliente reiniciaba la conversación desde cero.


🇺🇸 English Version

💡 What is Pactio?

Over 68% of digital freelancers and boutique agencies in Latin America face unpaid project balances, endless unpaid revisions (scope creep), or informal WhatsApp agreements with zero legal enforceability.

Pactio solves this by bridging human clarity and ironclad legal protection through interactive, parameter-driven contracts with full evidentiary validity in Mexican courts and tax authorities (SAT).

🌟 Key Product Pillars

  1. Dual-Pane Real-Time Compiler: Seamless toggle between plain human language and formal legal text.
  2. Copyright Reservation (Mexican Copyright Act Art. 83): Intellectual property transfer is strictly conditional upon 100% payment completion. Delivery clocks only start once all client assets are delivered.
  3. Client Negotiation Simulator: Enables clients to review milestones, request reasonable adjustments, and approve terms with zero friction.
  4. Zero-Knowledge Digital Signature & NOM-151: Sign via touch canvas, cursive typography, or official Mexican e.firma SAT (computed in-browser via WebCrypto; private keys never leave your machine).
  5. WCAG 2.1 AAA Ergonomics: Tailored themes (Midnight Dark, Warm Paper, High Contrast) ensuring accessible contrast and smooth reading.

📊 Usability testing results

Study with 8 participants across two cohorts, moderated tasks, standardised scoring:

Metric Result Benchmark
System Usability Scale (SUS) 87.8 / 100 Grade A+, 96th percentile
Task success rate 95.8% (23 of 24) Target > 85%
Median time to create an agreement 3 min 42 s Target < 5 min
Audit findings shipped 12+ within 48 hours One-week cycle

Key design decision: turning signature into a two-step act with a visible Request changes button cut flow abandonment. Before it, every client objection restarted the conversation from scratch.


🐳 Despliegue con Docker / Docker Deployment

Pactio incluye configuración para correr en cualquier computadora (Mac, Windows o Linux) con un solo comando, sin necesidad de instalar Node.js ni dependencias locales:

# 1. Clonar el repositorio / Clone repository
git clone https://github.com/ApoloArgonaut/Pactio.git
cd Pactio

# 2. Iniciar con Docker Compose / Run with Docker
docker compose up -d

🌐 Abre tu navegador en / Open in browser: http://localhost:3001


💻 Instalación Local Alternativa / Local Development

Si prefieres ejecutarlo con Node.js en tu máquina:

# Instalar dependencias / Install dependencies
npm install

# Iniciar servidor de desarrollo / Start dev server (Port 3001)
npm run dev

# Ejecutar las 159 pruebas automatizadas / Run test suite
npm test

📚 Documentación Ejecutiva / Complete Documentation Suite

Para conocer el análisis a fondo, especificaciones de arquitectura, diseño UX y dictámenes legales, consulta los documentos especializados en la carpeta docs/:

Documento / Asset Descripción / Description Markdown Word (.docx) PDF (.pdf)
01. Caso de Estudio Ejecutivo Resumen directivo para reclutadores, ROI y portafolio. Ver .md Descargar Descargar
02. Dossier Maestro & PRD User Personas, flujos completos y máquina de estados FSM. Ver .md Descargar Descargar
03. Reporte de Ciberseguridad Modelo STRIDE, OWASP ASVS v4.0 y criptografía Zero-Knowledge. Ver .md Descargar Descargar
04. Especificación de Ingeniería Arquitectura del compilador dual, estado Zustand y REST APIs. Ver .md Descargar Descargar
05. Especificación UX/UI/CX Heurísticas de Nielsen, tokens de diseño y contraste WCAG AAA. Ver .md Descargar Descargar
06. Wireframes & Flujos Visuales Pantallas de interfaz, breakpoints y recorrido paso a paso. Ver .md Descargar Descargar
07. Auditoría de Factibilidad Viabilidad técnica y regulatoria ante PSC y el SAT. Ver .md Descargar Descargar
08. Deep Dive Research & Testing Benchmarking competitivo y pruebas de usabilidad exploratoria. Ver .md Descargar Descargar
09–13. Auditorías Especializadas Dictamen legal LATAM, auditoría de código y actas multidisciplinarias. Ver Carpeta Ver .docx Ver .pdf

👤 Autor & Contacto / Author & Contact

About

Plataforma de acuerdos para freelancers — caso de estudio UX/UI/CX con prototipo funcional en React + TypeScript. SUS 87.8, 95.8% de éxito en tareas.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages