Refer ☕✨ — Showcase & Builds

Repo público de demostración. Sin código fuente. Aquí hay todo lo necesario para probar Refer sin compilar nada: APK Android, panel admin, docs y guías.

Refer es una plataforma premium de pedidos de café artesanal: app móvil (Flutter), backend (Go + Supabase), panel admin (Angular) y landing. Este repo es la puerta de entrada para probarla.

---

📸 Screenshots

---

🚀 Probar en 5 minutos

1. App Android (recomendado — experiencia completa)

La app usa en producción https://refer-api.cobyzero.com, así que no necesitas levantar ningún backend.

1. Descarga el APK desde builds/android/ o desde Releases.
2. Instálalo en tu Android (permite "instalar apps desconocidas").
3. Abre Refer App y crea una cuenta, o usa el flujo de invitado.

Ver detalles, hash SHA y notas de versión en builds/android/README.md.

¿Por qué APK y no web? La app usa flutter_stripe (PaymentSheet) y flutter_secure_storage, que son mobile-only y no tienen paridad en web. No existe carpeta web/ en el proyecto fuente. Una build web compilaría, pero el pago y la sesión segura quedarían degradados. Por eso el showcase oficial es APK nativo. La demo web queda como roadmap (ver CHANGELOG.md).

2. Panel Admin (web)

El dashboard de administración (productos, órdenes, puntos/stars, usuarios) está en Angular.

• Guía rápida: web-admin/README.md
• Incluye cómo correr el dist/ compilado y credenciales del seed admin.

3. Backend API

No necesitas correrlo para probar la app (usa prod). Si quieres entorno local con Docker:

• Guía: api/README.md

---

📦 Contenido del repo

refer/
├── README.md               # este archivo
├── CHANGELOG.md            # versiones y notas de release
├── LICENSE                 # MIT
├── screenshots/            # 6 capturas (01-home … 06-orders)
├── builds/
│   └── android/            # APK + README con SHA y changelog
├── web-admin/              # guía + dist compilado (vía Release zip)
├── api/                    # guía Docker + contrato /api
└── docs/
    ├── Refer-App.md        # ficha técnica cliente Flutter
    ├── Refer-API.md        # ficha backend Go + Supabase
    ├── Refer-Web.md        # ficha panel Angular
    └── TESTING.md          # guion de pruebas paso a paso

Nota de tamaño: el APK (~142 MB en debug) y los zips del admin se distribuyen vía GitHub Releases, no en git (límite 100 MB por archivo).

---

🧭 Arquitectura (resumen)

Flutter (app) ──HTTPS──▶ Go API :3000 ─┬──▶ Kong :8000 ─┬──▶ Auth :9999 ──┐
                                       │                └──▶ REST :3000 ──┤
                                       └──────────────────────────────────┴──▶ PostgreSQL :5432
              ├── REST /api/* (JWT Bearer)
              ├── Socket.IO /cart , /orders (tracking en vivo)
              └── Stripe PaymentSheet (PaymentIntent del backend)

• App: Clean Architecture por feature + BLoC + GetIt/Injectable + GoRouter + Dio.
• API: Go/Fiber + Supabase Auth + Postgres. Contrato intacto /api/*.
• Admin: Angular 21 + Bun + Socket.IO + RxJS.
• i18n: Español / Inglés.

Docs completos en docs/.

---

🔑 Credenciales demo

Rol	Email	Password	Dónde
Admin (seed)	admin@admin.com	admin123@	Panel admin + API
Cliente	créalo en la app	—	App Android

El seed admin se crea al arrancar el backend (ADMIN_EMAIL / ADMIN_PASSWORD). En prod usa el admin ya provisionado.

Flujo sugerido: ver docs/TESTING.md.

---

🔗 Repos fuente (privados)

Este showcase no incluye código. Los repos de desarrollo son:

• refer_app — cliente Flutter
• refer_api — backend Go + Supabase
• refer_web — dashboard Angular admin
• refer-landing — landing Astro

---

📄 Licencia

MIT — ver LICENSE.