AgendaUN

Arquitectura y Stack Tecnológico

Arquitectura Central

• Framework: Next.js 16 con App Router y React Server Components
• Backend: Appwrite v2.0 como BaaS (Base de Datos, Autenticación, Almacenamiento)
• Validación: Zod con TypeScript para seguridad de tipos
• UI: Tailwind CSS 4.1 + Shadcn/ui + primitivas de Radix UI

Arquitectura en Capas

Funcionalidades Clave

Sistema de Gestión Dual

• Vistas: Mes, Semana, Día, Agenda
• Soporte de arrastrar y soltar (drag & drop)
• Etiquetas codificadas por color

• Categorías: Académico, Deportes, Cultura, Bienestar
• Grilla semanal fija
• Gestión basada en categorías

Jerarquía Organizacional

• Nacional → Sede → Facultad → Programa
• Permisos basados en roles de Teams de Appwrite
• Contenido personalizado según el perfil del usuario

Sistema de Autenticación

• Inicio de sesión sin contraseña mediante enlaces mágicos de Appwrite
• Perfiles de usuario vinculados a la jerarquía institucional
• Configuración inicial obligatoria para personalizar la experiencia

Aspectos Técnicos Destacados

Arquitectura Server-First

• React Server Components para el renderizado inicial
• Server Actions como único punto de mutación de datos
• Validación con Zod como frontera de seguridad
• JavaScript mínimo en el cliente

Sistema de Permisos

• Nivel de aplicación: Funciones helper (canEditCalendarEvent(), canAdminSchedule())
• Nivel de base de datos: Permisos de Appwrite con seguridad a nivel de fila (row-level security)

UI/UX Moderna

• Modo claro/oscuro con next-themes
• Animaciones con Tailwind y propiedades CSS personalizadas
• Componentes accesibles con Radix UI
• Diseño responsivo con barra lateral colapsable

Estructura del Proyecto

app/
├── layout.tsx          # Layout raíz con providers
├── page.tsx           # Introducción del dashboard
├── calendars/[slug]/  # Sistema de calendarios
└── schedules/         # Sistema de horarios

components/
├── calendar/          # Componentes de calendario
├── schedule/          # Componentes de horarios
└── ui/               # Primitivas de UI

lib/
├── actions/          # Server Actions
├── data/             # Esquemas y tipos
└── utils/            # Utilidades

Impacto y Escalabilidad

• Analíticas: Integración con Vercel Analytics y Speed Insights
• Código Abierto: Código disponible en GitHub con sistema de issues
• Beta Activa: Insignia de beta en la interfaz indicando desarrollo continuo
• Modular: La arquitectura permite una fácil extensión a nuevas instituciones

Notas

• Visión General (astrxnomo/agendaun.com)

• Patrones de Componentes de UI (astrxnomo/agendaun.com)