Desarrollo Completo de Webapp de Asistencia con Next.js, Firebase e Ia

Se requiere el desarrollo completo de una webapp de asistencia con una arquitectura robusta y escalable. La aplicación debe soportar tres perfiles de usuario distintos: usuario final, asesor y administrador, cada uno con sus respectivas funcionalidades y permisos.

El proyecto ya cuenta con una estructura definida y un punto de partida basado en Firebase, con la intención de desarrollar el frontend utilizando Flutter. Sin embargo, la descripción detalla un frontend con Next.js, por lo que se asume que la base de Flutter es para una posible aplicación móvil complementaria o que la dirección del frontend ha cambiado a Next.js para la webapp.

Requisitos específicos:

Frontend:
- Desarrollo con Next.js (App Router), utilizando TypeScript y componentes React (Server/Client).
- Implementación de estilos con TailwindCSS y componentes de shadcn/ui.
- Gestión de formularios robusta con react-hook-form y validación de esquemas con Zod.
- Manejo del estado de la aplicación en el cliente con React Query o Zustand (o una solución equivalente).

Backend y Base de Datos (Firebase):
- Configuración y gestión de autenticación con Firebase Auth, incluyendo soporte para email, teléfono y OAuth.
- Implementación de roles de usuario (admin, asesor, cliente) mediante Custom Claims de Firebase.
- Diseño y optimización de colecciones en Firestore, con definición de reglas de seguridad (rules) y creación de índices compuestos para consultas eficientes.
- Desarrollo de APIs seguras utilizando Cloud Functions (Gen2), incluyendo la integración de webhooks para pagos (Stripe) y funcionalidades de resumen con IA.
- Gestión de almacenamiento de archivos (PDFs, imágenes) en Firebase Storage, con reglas de seguridad basadas en roles y casos de uso.
- Despliegue y configuración de la aplicación en Firebase Hosting, utilizando apphosting.yaml para la gestión de entornos (dev, staging, prod).
- Implementación de notificaciones push web a través de Firebase Cloud Messaging (FCM).

Pagos:
- Integración completa con Stripe para la gestión de pagos, incluyendo Checkout y Payment Links.
- Configuración de webhooks seguros para procesar transacciones y eventos de pago.
- Implementación de un sistema de facturación por cliente y control de horas de servicio.

Inteligencia Artificial / RAG (Diferencial Xley):
- Desarrollo de un pipeline de embeddings y retrieval para la funcionalidad de "AI Summary", utilizando proveedores como OpenAI u otros.
- Capacidad para extraer texto de documentos PDF (utilizando pdf.js o una Cloud Function) y sanitizar información personal identificable (PII).

Calidad y DevOps:
- Adherencia a prácticas de desarrollo colaborativo con Git/GitHub, incluyendo Pull Requests y revisiones de código.
- Mantenimiento de la calidad del código mediante ESLint y Prettier.
- Implementación de testing básico con Vitest o Jest.
- Gestión segura de variables de entorno por ambientes (desarrollo, staging, producción) para evitar la exposición de secretos.
- Optimización para SEO técnico, incluyendo la generación de sitemap.xml, robots.txt y metadatos en Next.js, así como la mejora de Web Vitals.

Me gustaría agregar: este proyecto es inicial, se busca alguien que también discuta las ideas y nos haga ver si lo que tenemos ahorita está mal para hacer algo mucho mejor. Deseamos crear una plataforma moderna, concisa y rápida.