Jobly: Mercado de Contratos con Resolución de Disputas Basada en IA y Votación Comunitaria

Jobly es un mercado de contratos donde los compradores publican contratos de trabajo y los proveedores envían propuestas. La plataforma utiliza un stack técnico de Next.js 14 App Router, TypeScript, Supabase (Postgres + Storage) y está desplegada en Vercel.

Flujo de Depósito en Garantía

Cuando un proveedor envía una propuesta, se bloquea el 10% del precio propuesto como fianza de su saldo. Cuando el comprador acepta, el precio acordado completo más una tarifa de plataforma del 2.5% se bloquea del comprador. Después de que el proveedor marca el trabajo como completado, el comprador tiene una ventana de revisión configurable (1–90 días) para liberar los fondos o disputar. Si el comprador no toma ninguna acción, los fondos se liberan automáticamente al proveedor después de que expire la ventana.

Proceso de Resolución de Disputas

El proceso de disputa sigue una secuencia específica:

• Veredicto de IA primero (estados: ai_pending → ai_decided) – Claude evalúa el estándar del contrato contra la prueba de trabajo presentada, devolviendo provider_wins, buyer_wins o inconclusive con razonamiento.
• Ventana de apelación – Cualquiera de las partes puede apelar la decisión de la IA gastando JOOBs (moneda de la plataforma sin valor monetario real en el entorno de pruebas).
• Votación comunitaria (estado: voting) – Usuarios terceros pueden apostar JOOBs a un lado. Durante la votación activa, los totales por lado están ocultos (solo se muestra el total) para prevenir efectos de arrastre. Después del plazo de votación, los ganadores comparten proporcionalmente el fondo perdedor.
• Resolución – El lado ganador recupera sus apuestas más la parte del fondo perdedor, y la plataforma resuelve el depósito en garantía en consecuencia.

Esquema del Estándar de Contrato

Cada contrato incluye un campo contract_standard con un esquema estructurado que contiene: scopeSummary, deliverables[], acceptanceCriteria[], outOfScope[], deadline, reviewWindowDays, deliveryMethod, acceptedFileTypes, etc. Esta especificación legible por máquina busca hacer la evaluación de disputas por IA más determinista.

Diseño de API

La plataforma ofrece una API REST programática completa accesible mediante tokens Bearer con claves con prefijo jbly_. La API está diseñada para ser invocable por LLM, con documentación escrita como referencia orientada a LLM (/skills.md) en lugar de una especificación OpenAPI tradicional. Los endpoints cubren operaciones CRUD en contratos, propuestas, perfiles, mensajes, reseñas, entregables, disputas (levantar/apelar/votar) y webhooks. La limitación de tasa se implementa mediante ventana deslizante en memoria en todos los endpoints de escritura.

Preguntas de Arquitectura

El desarrollador está buscando retroalimentación sobre varias decisiones de diseño:

• Mecánica de fianza: 10% de fianza al enviar la propuesta – ¿es esto demasiado punitivo para mercados iniciales con saldos bajos de proveedores, o la fricción es deseable?
• Totales de votación ocultos: ¿Prevenir la votación por arrastre justifica hacer que los votantes sientan que votan a ciegas?
• Disputa con IA primero: ¿Comenzar con IA añade legitimidad, o es solo latencia extra antes de que la comunidad decida?
• Estándar de contrato como campo obligatorio: Obliga a una definición estructurada del alcance pero añade fricción – ¿vale la pena para disputas resolubles?