mercadodevida/work/artifacts/TICKET-LOGO/02-design.md

TICKET-LOGO — Design

Feature

ID: TICKET-LOGO Title: TPV ticket header: allow custom text or logo upload

---

Solución Propuesta

Opción A: URL manual (simpler, menor riesgo)

1. Agregar campo logo_url a pos_stores (nullable, max 500 chars)
2. Actualizar admin para permitir editar logo URL
3. ReceiptModal muestra receipt.logoUrl ?? '/images/logo-main.png'

Opción B: Upload de imagen (más complejo)

1. Crear tabla pos_store_assets o similar
2. Endpoint de upload con storage (S3/local)
3. Admin con file picker
4. ReceiptModal con URL dinámica

---

Recomendación: Opción A

Rationale:

• Risk: low
• Complejidad: mínima
• Funcionalidad: equivalente para el usuario
• Permite logo custom sin infraestructura de upload

Cambios Requeridos

Componente	Archivo	Cambio
Migration	project/migrations/XXX_pos_store_logo.js	Agregar columna logo_url
Route	src/modules/pos/api/pos.routes.ts	Agregar al schema de store
Build receipt	src/modules/pos/application/build-pos-receipt.ts	Incluir logoUrl en receipt
Types	PosReceipt type	Agregar logoUrl optional
Admin	apps/admin/src/app/(dashboard)/pos/page.tsx	Campo URL para logo
Receipt UI	apps/pos/src/components/ReceiptModal.tsx	Mostrar logo custom

Migration (pseudo-code)

ALTER TABLE pos_stores ADD COLUMN logo_url TEXT NULL;
COMMENT ON COLUMN pos_stores.logo_url IS 'URL del logo custom para tickets (nullable, fallback a /images/logo-main.png)';

ReceiptModal Change

<img
  src={receipt.logoUrl ?? '/images/logo-main.png'}
  alt="Logo"
  className="h-16 object-contain"
/>

---

Testing

1. Crear store sin logo → usa default
2. Guardar logo URL en store → aparece en receipt
3. Receipt con logo custom imprime correctamente

Gates

• reviewer: PENDING
• security: PENDING
• qa: PENDING