🍰 DG Bakery Cake - Sistema de Gestión de Costos de Recetas

Sistema web para calcular y gestionar costos de recetas de repostería y pastelería, incluyendo materiales, insumos y mano de obra.

🚀 Stack Tecnológico

Frontend: Next.js + Vite
Estilos: TailwindCSS + shadcn/ui
Lenguaje: TypeScript
Desarrollo Local: Docker
Repositorio: GitHub (privado)
Despliegue: Vercel
Iconos: Lucide React

📋 Plan de Desarrollo

Fase 1: Configuración Inicial

Fase 2: Fundamentos y Modelo de Datos

Fase 3: Gestión de Productos/Insumos

3.1 Implementar sistema de gestión de productos
- Crear componente ProductoForm
- Crear componente ProductoList
- Implementar CRUD de productos
- Validaciones de formulario
- Búsqueda y filtrado de productos
- Soporte para múltiples unidades de medida
- Cálculo automático de precio por unidad

Fase 4: Sistema de Mano de Obra

4.1 Implementar sistema de costo de mano de obra configurable
- Crear componente ConfiguracionForm
- Configuración global de costo por hora
- Configuración de moneda
- Persistencia de configuración
- Componente CostoManoObraInput para recetas

Fase 5: Gestión de Recetas

Fase 6: UI/UX

Fase 7: Persistencia de Datos

7.1 Implementar almacenamiento de datos
- Implementar localStorage para productos
- Implementar localStorage para recetas
- Implementar localStorage para configuración
- Hooks personalizados (useProductos, useRecetas)
- Manejo de errores y validaciones
- Sistema de backup/export (opcional)

Fase 8: Despliegue

8.1 Configurar despliegue en Vercel
- Configurar proyecto en Vercel
- Configurar variables de entorno
- Documentación de despliegue
- CI/CD automático con Vercel
- Configurar dominio personalizado (opcional)
- Testing en producción

Fase 9: Testing y Ajustes

📊 Modelo de Datos

Producto/Insumo

{
  id: string
  nombre: string
  precioTotal: number
  cantidadTotal: number
  unidadMedida: 'gramos' | 'litros' | 'onzas' | 'unidad' | 'mililitros' | 'kilogramos'
  precioPorUnidad: number // calculado
  categoria?: string
  proveedor?: string
  fechaActualizacion: Date
}

Receta

{
  id: string
  nombre: string
  descripcion: string
  materiales: MaterialReceta[]
  
  // Mano de Obra
  tiempoPreparacion: number // minutos
  costoPorHora: number
  costoManoObra: number // calculado
  
  // Costos
  costoMateriales: number // calculado
  costoTotal: number // calculado
  
  // Opcional
  margenGanancia?: number
  precioVentaSugerido?: number
  rendimiento?: number
  unidadRendimiento?: string
  
  fechaCreacion: Date
  fechaActualizacion: Date
}

Material de Receta

{
  id: string
  productoId: string
  nombreProducto: string
  cantidadUtilizada: number
  unidadMedida: string
  costoUnitario: number
  costoMaterial: number // calculado
}

🧮 Fórmulas de Cálculo

Costo de Material

costoMaterial = (precioProducto / cantidadTotalProducto) * cantidadUtilizada

Costo Total de Materiales

costoMateriales = Σ(costoMaterial)

Costo de Mano de Obra

costoManoObra = (tiempoPreparacion / 60) * costoPorHora

Costo Total de Receta

costoTotal = costoMateriales + costoManoObra

Precio de Venta Sugerido

precioVentaSugerido = costoTotal * (1 + margenGanancia / 100)

🏗️ Estructura del Proyecto

dgbakerycake-costo-app/
├── .docker/
│   ├── Dockerfile
│   └── docker-compose.yml
├── src/
│   ├── app/
│   │   ├── layout.tsx
│   │   ├── page.tsx
│   │   ├── productos/
│   │   │   └── page.tsx
│   │   ├── recetas/
│   │   │   ├── page.tsx
│   │   │   └── [id]/
│   │   │       └── page.tsx
│   │   └── configuracion/
│   │       └── page.tsx
│   ├── components/
│   │   ├── ui/ (shadcn/ui)
│   │   ├── productos/
│   │   │   ├── ProductoForm.tsx
│   │   │   └── ProductoList.tsx
│   │   ├── recetas/
│   │   │   ├── RecetaForm.tsx
│   │   │   ├── RecetaList.tsx
│   │   │   ├── MaterialSelector.tsx
│   │   │   ├── CostoManoObraInput.tsx
│   │   │   └── DesgloseCostos.tsx
│   │   └── configuracion/
│   │       └── ConfiguracionForm.tsx
│   ├── lib/
│   │   ├── utils.ts
│   │   ├── storage.ts
│   │   └── calculations.ts
│   ├── types/
│   │   └── index.ts
│   └── hooks/
│       ├── useProductos.ts
│       └── useRecetas.ts
├── public/
├── .gitignore
├── package.json
├── tailwind.config.ts
├── tsconfig.json
├── next.config.js
├── vite.config.ts
└── README.md

🐳 Comandos Docker

# Construir imagen
docker-compose build

# Iniciar contenedor
docker-compose up

# Iniciar en segundo plano
docker-compose up -d

# Detener contenedor
docker-compose down

# Ver logs
docker-compose logs -f

🔧 Desarrollo Local

# Instalar dependencias
npm install

# Modo desarrollo
npm run dev

# Build producción
npm run build

# Iniciar producción
npm start

� Despliegue en Vercel

Opción 1: Desde la Web de Vercel

Ve a vercel.com e inicia sesión
Click en "Add New Project"
Importa el repositorio: dgbakerycake-recetario-app
Vercel detectará automáticamente Next.js
Click en "Deploy"

Opción 2: Usando Vercel CLI

# Instalar Vercel CLI
npm install -g vercel

# Desplegar
vercel

📖 Guía completa: Ver DEPLOYMENT.md

�📝 Notas de Desarrollo

Unidades de Medida Soportadas

Peso: gramos (g), kilogramos (kg), onzas (oz)
Volumen: mililitros (ml), litros (l)
Cantidad: unidad (u)

Conversiones Automáticas

1 kg = 1000 g
1 l = 1000 ml
1 oz = 28.35 g

🎯 Funcionalidades Futuras (Post-MVP)

📄 Licencia

👤 Autor

DG Bakery Cake Team

Última actualización: 28 de Febrero, 2026

Name		Name	Last commit message	Last commit date
.agent/skills		.agent/skills
.agents/skills		.agents/skills
.atl		.atl
.claude		.claude
.codegraph		.codegraph
.codex		.codex
.commandcode/skills		.commandcode/skills
.gemini		.gemini
.github		.github
.vscode		.vscode
.windsurf/skills		.windsurf/skills
__tests__/unit		__tests__/unit
app		app
components		components
contexts		contexts
docs		docs
e2e		e2e
email-templates		email-templates
hooks		hooks
issues		issues
lib		lib
public		public
scripts		scripts
supabase		supabase
types		types
utils/supabase		utils/supabase
.dockerignore		.dockerignore
.env.example		.env.example
.env.local.example		.env.local.example
.gitignore		.gitignore
.mcp.json		.mcp.json
.shadcn-migration-complete.md		.shadcn-migration-complete.md
.shadcn-migration.md		.shadcn-migration.md
.visual-unification.md		.visual-unification.md
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
DEPLOYMENT.md		DEPLOYMENT.md
DESIGN.md		DESIGN.md
DOCKER-README.md		DOCKER-README.md
Dockerfile		Dockerfile
LOGO-SETUP.md		LOGO-SETUP.md
MOBILE-APP-README.md		MOBILE-APP-README.md
PERFORMANCE.md		PERFORMANCE.md
PROGRESO.md		PROGRESO.md
PROYECTO_COMPLETO.md		PROYECTO_COMPLETO.md
README.md		README.md
SECURITY.md		SECURITY.md
SISTEMA-MONEDAS.md		SISTEMA-MONEDAS.md
SISTEMA-PRESENTACIONES.md		SISTEMA-PRESENTACIONES.md
SUPABASE_SETUP.md		SUPABASE_SETUP.md
components.json		components.json
docker-compose.yml		docker-compose.yml
docker-init.sh		docker-init.sh
eslint.config.mjs		eslint.config.mjs
jest.config.ts		jest.config.ts
jest.setup.ts		jest.setup.ts
middleware.ts		middleware.ts
next.config.js		next.config.js
opencode.json		opencode.json
package-lock.json		package-lock.json
package.json		package.json
playwright.config.ts		playwright.config.ts
postcss.config.js		postcss.config.js
skills-lock.json		skills-lock.json
tailwind.config.ts		tailwind.config.ts
temp.ts		temp.ts
test-update-receta.ts		test-update-receta.ts
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Latest commit

History

Folders and files

Repository files navigation