Recibir y firmar tu entrega

# Recibir y firmar tu entrega La entrega es el último eslabón del flujo. Es también el momento donde se cierra el círculo de trazabilidad: cada gramo entregado queda firmado digitalmente y sellado criptográficamente. Esta guía explica los estados por los que pasa tu dispensación y cómo funciona la firma digital de entrega. ## Los cuatro estados de una dispensación Toda dispensación atraviesa una máquina de estados estricta: ``` pending_contribution → pending_dispatch → dispatched → delivered ``` Cada estado tiene un significado operativo claro: 1. **pending_contribution**: solicitud creada, esperando que pagues el aporte. Tiene un TTL de veinticuatro horas. Si no pagas en ese tiempo, el sistema cancela automáticamente la solicitud y restaura el stock. 2. **pending_dispatch**: aporte verificado, en preparación. El equipo del Club está armando el pedido en sucursal. 3. **dispatched**: el pedido salió de sucursal y está en camino (o listo para retiro). Recibes notificación por correo. 4. **delivered**: entregado y firmado. Estado terminal. La dispensación queda cerrada con comprobante criptográfico. Hay dos estados adicionales terminales: `rejected` (rechazado antes del match con aporte) y `cancelled` (cancelado en cualquier punto). Importante: una vez que la dispensación pasa a `pending_dispatch`, ya no puede ser rechazada. Es una decisión estructural para proteger tu derecho a recibir lo que ya pagaste. ## Notificación de despacho Cuando tu dispensación pasa a `dispatched`, recibes un correo con fecha y hora estimada de entrega, método de entrega, mensaje del despachador con instrucciones específicas (`dispatch_message`) y link a tu cuenta para firmar al recibir. ## La firma digital al recibir Hay dos modalidades: ### Modalidad 1: tú firmas desde tu dispositivo Abres `/aporte` desde tu celular o computadora. El sistema muestra un canvas de firma vacío. Firmas con el dedo (móvil) o con el mouse (escritorio). Click en "Confirmar entrega". ### Modalidad 2: administrador firma desde tablet presencial Si retiras en sucursal, el administrador del Club abre `/admin/dispensaciones/[id]` en una tablet, te pasa el dispositivo y tú firmas. El sistema detecta automáticamente el rol del usuario que firma. En ambos casos, la firma se captura como data URL del canvas. El sistema invoca el RPC `sign_and_deliver_dispensation` que valida estado, guarda la firma, registra `signed_at`, `signed_by_role` y `signed_by_user_id`, promueve a `delivered` y genera el Comprobante de Dispensación en PDF. Todo en una sola transacción atómica. ## El comprobante de dispensación Al firmar, el sistema genera automáticamente un PDF con tu nombre, RUT y firma, detalle de los productos entregados (lote, gramos, cepa, concentraciones), fecha y hora de entrega, razón social del Club y firma del despachador, sello criptográfico Ed25519, y ancla OpenTimestamps a Bitcoin. El comprobante criptográfico no se puede borrar. Esa es la garantía. Cualquier modificación posterior queda detectable en la cadena de auditoría. El PDF se almacena en R2 y queda accesible desde `/dashboard/ordenes/[id]` o desde la sección "Mis documentos" en tu perfil. ## Verificación pública del sello Toda persona con el share token puede verificar la autenticidad del documento sin necesidad de acceso al sistema. El endpoint público `/api/public/verify/contribution/[id]` retorna hash SHA-256 del documento sellado, firma Ed25519 con clave pública del Club, y recibo OpenTimestamps verificable contra la blockchain de Bitcoin. Esto significa que tu comprobante es verificable de forma independiente, incluso si el Club desapareciera mañana. ## ¿Y si no llega el producto? Si el estado quedó en `dispatched` pero no recibiste el producto, contacta al Club por el formulario en `/asistencia` o desde `/dashboard/perfil/tickets`. El sistema genera un ticket de soporte ligado a tu dispensación y un administrador lo revisa. No firmes la entrega si no recibiste el producto. ## Próximos pasos Revisa tus dispensaciones en `/dashboard/ordenes`. Si tienes alguna en estado `dispatched`, prepárate para firmarla en cuanto recibas el producto. ## Preguntas frecuentes **¿Puedo firmar antes de recibir el producto?** No es recomendable. La firma es prueba legal de recepción y desencadena el cierre del flujo. **¿Qué pasa si pierdo el comprobante PDF?** Se puede descargar las veces que quieras desde `/dashboard/ordenes/[id]`. El PDF está sellado y es idéntico cada vez (byte por byte). **¿La firma digital tiene validez legal en Chile?** La firma capturada en el canvas, combinada con el sello criptográfico Ed25519 y el ancla OpenTimestamps, constituye evidencia técnica fuerte de recepción y momento. **¿Puedo rechazar la entrega si el producto no corresponde?** Sí. No firmes y contacta inmediatamente al administrador o por `/asistencia`. El producto vuelve a sucursal y se reabre el flujo. **¿El comprobante incluye la trazabilidad del lote?** Sí. Cada lote tiene un identificador único `LOT-YYYYMMDD-XXXXXXXXXXXX` que aparece en el comprobante.