TenPlanner
Plan your goals, track your progress.
Tech Stack
- Framework: Next.js 16 (App Router)
- Language: TypeScript 5
- UI: React 19, Tailwind CSS 4, shadcn/ui
- Linting: ESLint 9, Prettier
- Package Manager: pnpm
Folder Structure
tenplanner/
├── app/ # Next.js App Router (pages, layouts, routes)
│ ├── (legal)/ # Public legal pages (privacy, cookies, etc.)
│ └── api/
│ ├── account/delete # RGPD supresión (art. 17)
│ ├── export # RGPD portabilidad (art. 20)
│ └── cron/cleanup # Retención automática
├── components/ # Shared React components
│ └── ui/ # shadcn/ui primitives
├── lib/ # Utility functions and shared logic
├── db/ # Database schema, migrations, queries
├── docs/
│ └── legal/ # Documentación RGPD interna (RAT, DPA, brechas…)
├── public/ # Static assets
└── .github/
└── workflows/ # CI pipeline (lint + type-check on PRs)
Getting Started
pnpm install
pnpm dev
Open http://localhost:3000.
Scripts
| Command | Description |
|---|
pnpm dev | Start dev server |
pnpm build | Production build |
pnpm lint | Run ESLint |
pnpm format | Format code with Prettier |
pnpm format:check | Check formatting |
pnpm typecheck | Run TypeScript type checking |
pnpm db:generate | Generate Drizzle migration |
pnpm db:migrate | Apply pending migrations |
Environment variables
Copy .env.example to .env.local and fill in:
| Variable | Required | Purpose |
|---|
NEXT_PUBLIC_SUPABASE_URL | ✅ | Supabase project URL. |
NEXT_PUBLIC_SUPABASE_ANON_KEY | ✅ | Supabase anon (client-safe) key. |
SUPABASE_SERVICE_ROLE_KEY | ✅ (producción) | Service-role key. Solo servidor. Necesaria para el endpoint de borrado de cuenta (/api/account/delete). |
DATABASE_URL | ✅ | Postgres connection string para Drizzle. |
NEXT_ANTHROPIC_API_KEY | ✅ | Clave API de Anthropic (Dr. Planner). |
CRON_SECRET | ✅ (producción) | Bearer token para autenticar /api/cron/cleanup. Vercel lo pasa automáticamente si está configurado. |
NEXT_DEV_ALLOWED_ORIGINS | opcional | Lista de orígenes permitidos en dev. |
CI
Every PR runs lint, Prettier check, and type-check via GitHub Actions.
RGPD — checklist pre-producción
Esta aplicación trata datos personales de terceros (alumnos) por cuenta del entrenador. Antes de desplegar en producción debe completarse la capa legal.
Recursos internos
