# Proyecto Gamilit - Knowledge Base

**Categoria:** Projects
**Proyecto:** gamilit
**Estado:** En desarrollo (65%)
**Fecha:** 2025-12-27

---

## Descripcion

Plataforma educativa gamificada con sistema de progreso, logros y elementos sociales.

## Arquitectura

```
gamilit/
├── backend/           # NestJS API
├── frontend/          # React SPA
├── database/          # PostgreSQL schemas
└── orchestration/     # Sistema NEXUS
```

## Tecnologias

| Componente | Tecnologia |
|------------|------------|
| Backend | NestJS + TypeORM |
| Frontend | React + Zustand |
| Database | PostgreSQL 15 |
| Auth | JWT + Sessions |
| Real-time | Socket.io |

## Patrones Reutilizables

Los siguientes patrones fueron extraidos de gamilit al catalogo:

| Patron | Ubicacion Catalogo |
|--------|-------------------|
| Auth + Sessions | `core/catalog/auth/` |
| Multi-tenancy | `core/catalog/multi-tenancy/` |
| Notifications | `core/catalog/notifications/` |
| Rate Limiting | `core/catalog/rate-limiting/` |
| Feature Flags | `core/catalog/feature-flags/` |

## Lecciones Aprendidas

1. **Gamificacion**: Sistema de puntos y logros requiere transacciones atomicas
2. **Progress Tracking**: Calcular progreso en tiempo real es costoso, usar cache
3. **Social Features**: Implementar feeds con paginacion cursor-based
4. **Multi-tenant**: RLS es esencial para aislamiento de instituciones

## Referencias

- Proyecto: `projects/gamilit/`
- Legacy: `shared/knowledge-base/reference/erp-inmobiliaria-legacy/gamilit/`
- Catalogo: `core/catalog/` (modulos extraidos)

---

*Knowledge Base - Workspace v1*