ed8d280995
- Add package.json for the root with workspace configuration and scripts - Create @gruperly/config package with TypeScript configuration - Establish shared package @gruperly/shared with Zod schemas for validation - Implement group, student, and payment schemas using Zod - Set up TypeScript configuration for shared package - Document stack architecture and technical specifications in stack.md - Configure Turborepo with build, dev, lint, and typecheck tasks
94 lines
4.1 KiB
Markdown
94 lines
4.1 KiB
Markdown
# Stack Architecture & Technical Specifications — Gruperly
|
|
|
|
Este documento define la arquitectura, convenciones y especificaciones del stack tecnológico para el desarrollo del monorepo de **Gruperly**. Debe ser utilizado como contexto principal por los agentes e instruccionales de IA para la generación de código y configuración del proyecto.
|
|
|
|
---
|
|
|
|
## 1. Stack Tecnológico Principal
|
|
|
|
### Runtime & Monorepo Manager
|
|
* **Runtime / Package Manager:** [Bun](https://bun.sh/) (última versión estable)
|
|
* **Monorepo Tooling:** Bun Workspaces (opcionalmente orquestado con Turborepo)
|
|
|
|
### Backend (`apps/api`)
|
|
* **Framework:** [Hono](https://hono.dev/) (para Bun)
|
|
* **ORM:** [Prisma](https://www.prisma.io/)
|
|
* **Base de Datos:** PostgreSQL
|
|
* **Autenticación:** [Better Auth](https://www.better-auth.com/)
|
|
* **Validación de Entradas:** `@hono/zod-validator`
|
|
|
|
### Frontend (`apps/web`)
|
|
* **Framework / Library:** React 19+ con TypeScript
|
|
* **Routing:** [TanStack Router](https://tanstack.com/router) (File-based routing)
|
|
* **Data Fetching & State:** [TanStack Query](https://tanstack.com/query) (v5)
|
|
* **UI Components:** [Shadcn UI](https://ui.shadcn.com/)
|
|
* **Styling:** Tailwind CSS (v4)
|
|
* **Form Management:** `react-hook-form` con `@hookform/resolvers/zod`
|
|
|
|
### Shared Package (`packages/shared`)
|
|
* **Validación de Esquemas:** [Zod](https://zod.dev/)
|
|
* **Tipos Compartidos:** Tipos inferidos de Zod (`z.infer<typeof schema>`) y tipos globales exportados de Prisma.
|
|
|
|
---
|
|
|
|
## 2. Estructura del Monorepo
|
|
|
|
```text
|
|
gruperly/
|
|
├── apps/
|
|
│ ├── api/ # Servicio Backend (Bun + Hono)
|
|
│ │ ├── src/
|
|
│ │ │ ├── db/ # Cliente e inicialización de Prisma
|
|
│ │ │ ├── lib/ # Instancia de Better Auth y helpers
|
|
│ │ │ ├── routes/ # Endpoints modularizados de Hono
|
|
│ │ │ │ ├── auth.ts
|
|
│ │ │ │ ├── groups.ts
|
|
│ │ │ │ ├── students.ts
|
|
│ │ │ │ ├── payments.ts
|
|
│ │ │ │ └── waitlist.ts
|
|
│ │ │ └── index.ts # Entry point de la API
|
|
│ │ ├── prisma/
|
|
│ │ │ └── schema.prisma # Definición del modelo de datos
|
|
│ │ ├── tsconfig.json
|
|
│ │ └── package.json
|
|
│ │
|
|
│ └── web/ # Aplicación Frontend (React PWA)
|
|
│ ├── src/
|
|
│ │ ├── components/ # Componentes de Shadcn UI y UI propia
|
|
│ │ ├── routes/ # Rutas jerárquicas de TanStack Router
|
|
│ │ ├── lib/ # Cliente de API, TanStack Query client, etc.
|
|
│ │ ├── main.tsx
|
|
│ │ └── index.css # Tailwind CSS
|
|
│ ├── tsconfig.json
|
|
│ └── package.json
|
|
│
|
|
├── packages/
|
|
│ ├── shared/ # Código y esquemas compartidos
|
|
│ │ ├── src/
|
|
│ │ │ ├── schemas/ # Validaciones Zod compartidas
|
|
│ │ │ │ ├── group.schema.ts
|
|
│ │ │ │ ├── student.schema.ts
|
|
│ │ │ │ └── payment.schema.ts
|
|
│ │ │ └── index.ts
|
|
│ │ ├── tsconfig.json
|
|
│ │ └── package.json
|
|
│ │
|
|
│ └── config/ # Configuraciones compartidas de TS/ESLint
|
|
│ ├── tsconfig.base.json
|
|
│ └── package.json
|
|
│
|
|
├── package.json # Workspaces de Bun
|
|
├── turbo.json # Configuración de pipeline de Turborepo
|
|
└── README.md
|
|
|
|
---
|
|
|
|
## 3. Sistema de Diseño Visual (UI System Tokens)
|
|
|
|
* **Background:** `#F8FAFC` (Light Mode principal)
|
|
* **Primary Color (Nav, Headings, Textos oscuros):** `#0A2540` (Azul Marino del Isologo)
|
|
* **Accent Color (Botones de acción, enlaces activos, CTAs):** `#1E90FF` (Azul Celeste de la 'y')
|
|
* **Border Radius:** `0.75rem` (`rounded-xl` en tarjetas de Shadcn)
|
|
* **Status Badges:**
|
|
* **Paid / Al Día:** Fondo `#DCFCE7`, Texto `#10B981`
|
|
* **Pending / Lista Espera:** Fondo `#FEF3C7`, Texto `#F59E0B` |