AJDUT
Sistema de gestión de comunidades de negocio. Cero transacciones, máxima trazabilidad.
AJDUT no procesa pagos ni custodia fondos. Es la herramienta de gestión, comunicación y certificación que respalda proyectos reales — startups, inmobiliarios y de mercancía — para sus socios.
Stack
- Next.js 15 (App Router, TypeScript estricto, React 19 RC)
- Prisma 5 + PostgreSQL (sugerido Neon para dev y prod)
- Auth.js v5 (email + password)
- Tailwind CSS 3 con tokens de diseño AJDUT (paleta Sello de Unión)
- Decimal.js para todas las cifras monetarias
- Zod para validación de entrada
- bcryptjs para hashing de contraseñas
Puesta en marcha
Pre-requisitos
- Node.js ≥ 20
- pnpm ≥ 9
- PostgreSQL accesible (local, Neon, Supabase, Railway, etc.)
Pasos
# 1. Instalar dependencias
pnpm install
# 2. Copiar plantilla de variables de entorno
cp .env.example .env
# Editar .env con tu DATABASE_URL y AUTH_SECRET (generar con: openssl rand -base64 32)
# 3. Generar el cliente Prisma y aplicar schema
pnpm db:generate
pnpm db:push
# 4. Cargar datos de demostración
pnpm db:seed
# 5. Arrancar dev server
pnpm dev
Abre http://localhost:3000.
Credenciales de demo (tras el seed)
Estructura del repo
app/
├── (public)/ Landing pública y aviso legal (force-static)
├── (auth)/ /acceder y /aplicar
├── (app)/ Rutas protegidas
│ ├── founder/ Dashboard del founder
│ ├── partner/ Dashboard del socio
│ └── admin/ Consola Admin
├── api/auth/[...nextauth]/ Handlers Auth.js
└── redirect-by-role/ Router de roles tras login
components/
├── landing/ BrandMark, PublicNav, PublicFooter
├── ui/ Section, etc.
└── (founder|partner|admin)/ Vistas específicas por rol
lib/
├── auth/ Auth.js v5 config, session helpers
├── crypto/ Cadena de hashes de OwnershipHistory
├── constants/ Constantes (usuario PLATFORM, LEAD_EXPIRATION_DAYS, …)
├── db/ Cliente Prisma singleton
└── utils/ Formateo de cifras, cn() para Tailwind
prisma/
├── schema.prisma Schema completo
└── seed.ts Datos de demo
Filosofía de diseño
Cero Transacciones
El sistema NO procesa pagos, NO custodia fondos y NO es un exchange. Es herramienta de gestión, comunicación y certificación. Las distribuciones de dividendos se declaran, se comunican y se confirman; nunca se mueven dentro de la plataforma.
Trazabilidad de Legado
Cada cambio de propiedad genera un registro inmutable en OwnershipHistory con cadena de hashes SHA-256. No se borran datos; se crean nuevos estados de propiedad.
Gatekeeping Estricto
No existe registro abierto. El acceso requiere completar /aplicar y ser aprobado manualmente por un Admin.
Sin stake institucional por defecto
AJDUT NO retiene equity automáticamente en los proyectos. El flujo de aprobación crea el pool con la totalidad de las participaciones disponibles; el founder decide cuántas pone a la venta. Si históricamente un proyecto se seedeó con Participation isPlatformStake = true (rol PLATFORM), esos registros se mantienen como legacy — los nuevos proyectos no generan ninguno.
Doble Firma (legacy)
Las participaciones institucionales que existan (legacy) siguen requiriendo authorizedById + coAuthorizedById (dos Admins distintos) para transferirse. Validado a nivel de servicio.
Identidad visual
| Token | Valor | Uso |
|---|
paper | #F5F3EE | Fondo principal |
navy | #1A1A2E | Headers y énfasis |
gold | #C8A96E | Solo para datos de valor (KPIs, base "U" del logo) |
line | #E8E3D9 | Retículas de 0.5pt |
font-sans (Inter) | — | Cuerpo de texto |
font-mono (DM Mono) | — | Cifras, métricas y eyebrows |
Próximos pasos pendientes (TODO)
Funcionalidad
Infraestructura
Compliance pendiente (no-código)
Diferido a v1.1
Decisiones de producto registradas
- A1 Los socios NO ven a otros socios del proyecto.
- A2 Las reventas se publican sin precio sugerido; solo intención.
- A3 Cualquier usuario aprobado de AJDUT puede comprar en reventa (no necesita ser socio del proyecto).
- A4 Las métricas que ve un socio están limitadas a
visibility = PUBLIC_TO_HOLDERS.
- B1 2-3 admins operativos: la doble firma para transferencia de stake institucional legacy es invariante dura.
- B3 KYC manual en v1.
- Voz "Manifestar interés" en lugar de "Comprar"; "Declarar distribución" en lugar de "Pagar dividendos"; "Confirmar recepción" en lugar de "Cobrar".
Scripts
pnpm dev # Dev server
pnpm build # Build de producción
pnpm start # Start producción
pnpm lint # ESLint
pnpm typecheck # tsc --noEmit
pnpm db:generate # prisma generate
pnpm db:push # Sync schema sin migración (dev)
pnpm db:migrate # Crea y aplica migración
pnpm db:seed # Carga datos de demo
pnpm db:studio # Prisma Studio
pnpm db:reset # Reset + seed
