Suni fabrica productos de limpieza y sanitización para mantener limpios hogares y empresas.
Este repositorio contiene el sistema interno de operaciones de Suni, que controla el inventario, los pedidos, la producción y el resto de las operaciones diarias de la empresa. Más adelante también incluirá la landing page pública de la empresa.
El sistema da servicio a cuatro áreas de la empresa. El acceso por roles permite que cada área vea solo la parte que le corresponde:
- Administración
- Producción (planta)
- Almacén
- Ventas
- TypeScript: tipado seguro y mejor experiencia de desarrollo
- TanStack Router: enrutamiento basado en archivos con tipado completo
- TailwindCSS: CSS utilitario para desarrollar interfaces con rapidez
- Paquete de UI compartido: los componentes base de shadcn/ui viven en
packages/ui - Hono: framework de servidor ligero y eficiente
- oRPC: APIs con tipado de extremo a extremo e integración con OpenAPI
- Bun: entorno de ejecución
- Drizzle: ORM pensado para TypeScript
- PostgreSQL: motor de base de datos
- Autenticación: Better Auth
- Turborepo: sistema de build optimizado para monorepos
Primero, instala las dependencias:
pnpm installEste proyecto usa PostgreSQL con Drizzle ORM.
- Asegúrate de tener una base de datos PostgreSQL disponible.
- Actualiza el archivo
apps/server/.envcon los datos de conexión de PostgreSQL. - Aplica el esquema a la base de datos:
pnpm run db:pushLevanta los contenedores de desarrollo local (Postgres, Mailpit y Garage, definidos en docker-compose.dev.yml y separados del stack de despliegue) con:
pnpm run services:upLos correos salientes se pueden revisar en http://localhost:8025. Configura el SMTP en localhost:1025 (sin autenticación ni TLS). Para detenerlos, usa pnpm run services:down.
pnpm run services:up también levanta Garage, un servicio compatible con S3 que sustituye a Cloudflare R2 en local, y su visualizador web. Un contenedor garage-init crea una sola vez el layout, el bucket suni-files, la llave de acceso y el hosting web; es idempotente.
| Qué | URL |
|---|---|
| API S3 | http://localhost:3900 |
| Lectura pública anónima | http://suni-files.web.garage.localhost:3902/<archivo> |
| Visualizador (garage-ui, como la consola de MinIO) | http://localhost:3909 (usuario admin, contraseña admin) |
| API de administración | http://localhost:3903 |
Las credenciales y el bucket locales son los valores por defecto de STORAGE_* en .env.schema: access key GKa5d1a3c0e4b27f6d8c1b9e02, región garage y bucket suni-files. Son públicas a propósito y solo sirven en local. Los puertos de Garage solo se publican en 127.0.0.1.
Pasar a R2 es cambiar solo variables, sin tocar código:
| Variable | Garage (local) | R2 (producción) |
|---|---|---|
STORAGE_ENDPOINT |
http://localhost:3900 |
https://<account-id>.r2.cloudflarestorage.com |
STORAGE_REGION |
garage |
auto |
STORAGE_FORCE_PATH_STYLE |
true (host/bucket/key) |
false (bucket.host/key) |
STORAGE_PUBLIC_URL |
http://suni-files.web.garage.localhost:3902 |
https://pub-xxxx.r2.dev o tu dominio |
STORAGE_PUBLIC_URL no incluye el bucket en ningún caso: en Garage el bucket va en el subdominio y en R2 lo define el dominio público. Garage no ofrece mc anonymous set download; la lectura pública sale por el puerto 3902 (hosting web), no por el de la API S3. Además, el local usa HTTP y R2 usa HTTPS. Todavía ningún módulo lee estas variables. Los datos viven en los volúmenes suni_dev_garage_meta y suni_dev_garage_data.
Después, inicia el servidor de desarrollo:
pnpm run devPortless asigna URLs estables: la aplicación web corre en https://suni.localhost y la API en https://api.suni.localhost. En desarrollo, esas URLs son los valores por defecto de .env.schema (VITE_SERVER_URL, BETTER_AUTH_URL, CORS_ORIGIN); en producción debes definirlos. Si los defines en .env, ese valor tiene prioridad, así que elimina cualquier localhost:3000 o localhost:3001 anterior. La primera vez, portless pide sudo para el puerto 443 y para confiar en su CA local. Para saltarte portless, usa PORTLESS=0 pnpm run dev (web en :3001, API en :3000).
Las aplicaciones web con React de este stack comparten los componentes base de shadcn/ui a través de packages/ui.
- Cambia los design tokens y los estilos globales en
packages/ui/src/styles/globals.css - Actualiza los componentes base compartidos en
packages/ui/src/components/* - Ajusta los alias o la configuración de estilos de shadcn en
packages/ui/components.jsonyapps/web/components.json
Ejecuta esto desde la raíz del proyecto para agregar más componentes base al paquete de UI compartido:
npx shadcn@latest add accordion dialog popover sheet table -c packages/uiImporta los componentes compartidos así:
import { Button } from "@suni/ui/components/button";Si quieres agregar bloques propios de la aplicación en lugar de componentes base compartidos, ejecuta el CLI de shadcn desde apps/web.
Cada aplicación define su esquema de entorno en .env.schema. Varlock genera src/env.ts durante la instalación; ejecuta pnpm run env:generate después de cambiar un esquema. Haz commit de los esquemas y guarda los secretos en archivos env ignorados por git o en tu plataforma de despliegue.
En el código de la aplicación, importa el accesor ENV generado. Los paquetes compartidos de base de datos y autenticación reciben la configuración o los clientes ya inicializados desde la aplicación. Consulta la guía de monorepos de Varlock.
La carga automática de variables de entorno de Bun está desactivada en bunfig.toml; Varlock se carga desde la integración del framework o desde el arranque del servidor. Los despliegues con Node deben incluir Varlock y sus dependencias junto con el esquema de la aplicación.
Ejecuta las herramientas independientes de Node o Bun que usan Varlock desde el directorio de la aplicación correspondiente, para que carguen su esquema y sus archivos env. env:generate solo genera archivos de TypeScript; no inicializa las variables de entorno para comandos posteriores.
- Destino: web + server
- Configuración:
docker-compose.yml(los Dockerfiles de cada aplicación están enapps/*/Dockerfile) - Construir imágenes:
pnpm run docker:build - Iniciar:
pnpm run docker:up - Logs:
pnpm run docker:logs - Detener:
pnpm run docker:down
Las variables de entorno se leen del archivo .env de cada aplicación (las variables públicas quedan incluidas en el build de web) y se sobrescriben en docker-compose.yml para la red de contenedores.
Para más detalles, consulta la guía Deploying with Docker Compose.
suni/
├── apps/
│ ├── web/ # Aplicación frontend (React + TanStack Router)
│ └── server/ # API backend (Hono, oRPC)
├── packages/
│ ├── ui/ # Componentes y estilos compartidos de shadcn/ui
│ ├── api/ # Capa de API / lógica de negocio
│ ├── auth/ # Configuración y lógica de autenticación
│ └── db/ # Esquema y consultas de la base de datos
pnpm run dev: inicia todas las aplicaciones en modo desarrollopnpm run build: compila todas las aplicacionespnpm run dev:web: inicia solo la aplicación webpnpm run dev:server: inicia solo el servidorpnpm run check-types: revisa los tipos de TypeScript en todas las aplicacionespnpm run db:push: aplica los cambios del esquema a la base de datospnpm run db:generate: genera el cliente y los tipos de la base de datospnpm run db:migrate: ejecuta las migraciones de la base de datospnpm run db:studio: abre la interfaz de Drizzle Studiopnpm run services:up: inicia Postgres, Mailpit y Garage de desarrollo local (docker-compose.dev.yml)pnpm run services:down: los detienepnpm run services:logs: muestra sus logs en tiempo realpnpm run docker:build: construye las imágenes de Docker Composepnpm run docker:up: construye e inicia el stack de Docker Composepnpm run docker:logs: muestra en tiempo real los logs del stack de Docker Composepnpm run docker:down: detiene el stack de Docker Compose
Después de cambiar los plugins o las opciones de esquema de autenticación, ejecuta pnpm run auth:generate desde la raíz del proyecto. El script ejecuta el CLI de Better Auth mediante varlock run desde el directorio de la aplicación correspondiente y carga la instancia de autenticación desde src/services.ts. Revisa los cambios del esquema y luego aplícalos con el flujo de migraciones de tu ORM.