Skip to content
secovamPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Suni

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.

Usuarios y roles

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

Stack tecnológico

  • 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

Primeros pasos

Primero, instala las dependencias:

pnpm install

Configuración de la base de datos

Este proyecto usa PostgreSQL con Drizzle ORM.

  1. Asegúrate de tener una base de datos PostgreSQL disponible.
  2. Actualiza el archivo apps/server/.env con los datos de conexión de PostgreSQL.
  3. Aplica el esquema a la base de datos:
pnpm run db:push

Levanta 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:up

Los 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.

Almacenamiento de archivos (Garage)

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 dev

Portless 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).

Personalización de la UI

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.json y apps/web/components.json

Agregar más componentes compartidos

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/ui

Importa los componentes compartidos así:

import { Button } from "@suni/ui/components/button";

Agregar bloques específicos de la aplicación

Si quieres agregar bloques propios de la aplicación en lugar de componentes base compartidos, ejecuta el CLI de shadcn desde apps/web.

Configuración del entorno

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.

Despliegue

Docker Compose

  • Destino: web + server
  • Configuración: docker-compose.yml (los Dockerfiles de cada aplicación están en apps/*/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.

Estructura del proyecto

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

Scripts disponibles

  • pnpm run dev: inicia todas las aplicaciones en modo desarrollo
  • pnpm run build: compila todas las aplicaciones
  • pnpm run dev:web: inicia solo la aplicación web
  • pnpm run dev:server: inicia solo el servidor
  • pnpm run check-types: revisa los tipos de TypeScript en todas las aplicaciones
  • pnpm run db:push: aplica los cambios del esquema a la base de datos
  • pnpm run db:generate: genera el cliente y los tipos de la base de datos
  • pnpm run db:migrate: ejecuta las migraciones de la base de datos
  • pnpm run db:studio: abre la interfaz de Drizzle Studio
  • pnpm run services:up: inicia Postgres, Mailpit y Garage de desarrollo local (docker-compose.dev.yml)
  • pnpm run services:down: los detiene
  • pnpm run services:logs: muestra sus logs en tiempo real
  • pnpm run docker:build: construye las imágenes de Docker Compose
  • pnpm run docker:up: construye e inicia el stack de Docker Compose
  • pnpm run docker:logs: muestra en tiempo real los logs del stack de Docker Compose
  • pnpm run docker:down: detiene el stack de Docker Compose

Generación del esquema de Better Auth

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages