feat: initial commit - Moraworld Imports project

2026-06-01 08:06:40 -05:00
commit 094ea9cf81
47 changed files with 12844 additions and 0 deletions
@@ -0,0 +1,96 @@
+# Moraworld Imports — Software
+
+Casillero internacional (EE.UU. → Ecuador). Monorepo con **Next.js**, **NestJS**, **PostgreSQL** y **Redis**.
+
+## Requisitos
+
+- Node.js 20+
+- pnpm 9+ (ver instalación abajo si sale `command not found`)
+- **Postgres + Redis** — en Coolify (recomendado) **o** Docker local
+
+### Instalar pnpm (si no lo tienes)
+
+```bash
+npm install -g pnpm@9.15.0
+```
+
+Cierra y abre la terminal, luego:
+
+```bash
+pnpm -v   # debe mostrar 9.15.x
+```
+
+**Alternativa sin instalar global** (usa npx):
+
+```bash
+npx pnpm@9.15.0 install
+npx pnpm@9.15.0 dev
+```
+
+## Desarrollo local (paso a paso)
+
+### 1. Variables de entorno
+
+```bash
+cp .env.example .env
+```
+
+Pega `DATABASE_URL` y `REDIS_URL` de Coolify. Guía: **[docs/VARIABLES-COOLIFY.md](./docs/VARIABLES-COOLIFY.md)**
+
+### 2. Infraestructura (solo si NO usas Coolify para BD)
+
+```bash
+pnpm docker:up
+```
+
+Levanta **PostgreSQL** (`localhost:5432`) y **Redis** (`localhost:6379`).  
+Si Postgres/Redis ya están en Coolify, **omite este paso**.
+
+### 3. Instalar dependencias
+
+```bash
+pnpm install
+```
+
+### 4. Base de datos
+
+```bash
+pnpm db:generate
+pnpm db:migrate
+```
+
+Nombre sugerido para la primera migración: `init`.
+
+### 5. Arrancar apps
+
+```bash
+pnpm dev
+```
+
+| Servicio | URL |
+|----------|-----|
+| Web (Next.js) | http://localhost:3000 |
+| API (NestJS) | http://localhost:3001/api/health |
+| Estado | http://localhost:3000/status |
+
+## Estructura
+
+```
+apps/
+  api/          # NestJS REST API
+  web/          # Next.js (landing + futuro portal)
+packages/
+  database/     # Prisma + PostgreSQL
+```
+
+## Coolify
+
+Ver **[docs/COOLIFY.md](./docs/COOLIFY.md)** para desplegar API y Web en Coolify (Postgres/Redis como servicios del panel o externos).
+
+## Roadmap
+
+Ver **[ROADMAP.md](./ROADMAP.md)** — Fase 0 en curso.
+
+## Prototipos HTML (legacy)
+
+Los archivos `index.html`, `portal-cliente.html`, etc. en la raíz del repo son maquetas de referencia hasta completar la migración a Next.js (Fase 1).