Clase 02 · Módulo 08
Catálogo: productos, precios y stock
Catálogo: productos, precios y stock
Qué logras en esta clase
Dejas definido qué datos tiene cada producto y dónde se guardan.
- Modelas un producto con los campos justos.
- Eliges entre archivos de contenido y una tabla en Supabase.
- Decides cuánto control de stock necesitas de verdad.
02
Primero los datos
Un catálogo es una tabla antes que una vitrina.
03
Los campos de un producto
| Campo | Para qué |
|---|---|
| Identificador | Reconocer el producto sin ambigüedad |
| Nombre y descripción | Lo que lee el comprador |
| Precio | El monto que se cobra |
| Imágenes | Mostrar el producto |
| Estado | Activo u oculto |
| Stock | Saber si se puede vender |
Agrega un campo solo cuando alguna página o algún proceso lo vaya a usar.
04
Un identificador que no cambia
Cada producto necesita un identificador fijo. El nombre no sirve: lo vas a corregir algún día.
- El identificador interno lo usan el carrito, los pedidos y el cobro.
- El
sluges la parte legible de la dirección de la página, por ejemplocafe-en-grano-250g.
Si cambias el slug, se rompen los enlaces que otros ya compartieron. Elígelo con calma.
05
El precio es un número entero
En pesos chilenos no hay decimales. Guarda el precio como un número entero: 12990.
El signo, el punto de miles y la palabra «CLP» son formato. Se agregan al mostrar el precio, no al guardarlo.
06
Un solo lugar para el precio
El precio vive en un único lugar. Las páginas y el cobro lo leen de ahí.
07
Variantes: talla, color, formato
Una polera en tres tallas puede modelarse de dos formas.
| Forma | Cuándo conviene |
|---|---|
| Un producto con una lista de opciones | Todas las opciones cuestan lo mismo y no controlas stock por opción |
| Cada variante como fila propia, ligada al producto | Cambia el precio o llevas stock por variante |
Si no vendes variantes, no las modeles «por si acaso».
08
Dónde puede vivir el catálogo
| Lugar | Conviene cuando |
|---|---|
| Archivos de contenido en el proyecto | Pocos productos y cambian poco |
| Tabla en Supabase | Muchos productos, o stock y precios que cambian seguido |
| Plataforma de tienda | El catálogo es grande y lo opera un equipo |
Las dos primeras son las del curso. La pregunta que decide: quién cambia los datos y cada cuánto.
09
Catálogo en archivos de contenido
Es la colección de contenido que viste en el módulo 5, clase 6: un archivo por producto, con sus datos validados por un esquema.
- Cambiar un precio es editar un archivo, hacer commit y publicar.
- El historial de Git registra cada cambio.
- No hay base de datos que mantener ni que proteger.
Su límite: no sirve para stock que baja con cada venta.
10
Catálogo en una tabla de Supabase
Los productos son filas de una tabla. Los cambias desde el panel de Supabase y el efecto es inmediato para quien lee la tabla.
La tabla lleva RLS (seguridad a nivel de fila, visto en el módulo 7):
- Los visitantes pueden leer solo los productos activos.
- Nadie puede escribir desde el navegador.
- Los cambios se hacen desde el panel o desde una función con la clave secreta.
11
Quién lee el catálogo
Hay dos lectores. Las páginas lo usan para mostrar. La función de cobro lo usa para saber cuánto cobrar.
Los dos deben leer la misma fuente. Si la página muestra un precio y el servidor cobra otro, tienes un reclamo.
12
El precio congelado al construir
Un sitio estático lee los datos cuando se construye. Si tu catálogo está en Supabase y cambias un precio, las páginas ya publicadas siguen mostrando el anterior.
13
Tres niveles de control de stock
| Nivel | Qué guardas | Conviene para |
|---|---|---|
| Sin control | Nada | Servicios, productos digitales, fabricación a pedido |
| Disponible o agotado | Un sí o no | Pocas unidades, tú lo cambias a mano |
| Cantidad | Un número que baja | Varias ventas al día del mismo producto |
Cada nivel exige más código y más cuidado. Parte por el más bajo que te sirva.
14
Cuándo se descuenta el stock
Lo simple: descontar cuando el pago queda confirmado. Lo verás en la clase 5.
El riesgo es la sobreventa: dos personas pagan la última unidad casi al mismo tiempo. Con pocas ventas al día pasa rara vez y se resuelve devolviendo el dinero.
Reservar unidades mientras alguien paga lo evita, pero suma tiempos de vencimiento y más casos que probar.
15
El stock decide dónde vive el catálogo
Si el stock baja solo con cada venta, el catálogo va en una tabla.
16
La página de producto
- Nombre claro y una descripción que responde las dudas de compra.
- Precio final visible, sin obligar a escribir para preguntarlo.
- Fotos reales, con texto alternativo, como viste en el módulo 3.
- Disponibilidad y plazo de entrega.
- Un solo botón principal: comprar o agregar al carrito.
17
Desactivar en vez de borrar
Para eso sirve el campo de estado: el producto se oculta de la tienda y sigue existiendo para el historial.
Por la misma razón, cada pedido guarda el nombre y el precio pagado, no solo el identificador.
18
Cómo pedirle el catálogo a Claude
Trabaja en modo plan y entrega tus decisiones, no una orden abierta.
Revisa en el plan que el precio sea numérico, que exista el campo de estado y que no invente campos.
19
Límites del plan gratis de Supabase
Si tu catálogo vive en Supabase Free, ten presentes dos límites vistos en el módulo 7:
- El proyecto se pausa tras 7 días sin actividad. Una tienda pausada no muestra productos ni cobra.
- No incluye respaldos automáticos: exporta la tabla de productos cada cierto tiempo.
20
Lo que te llevas
- Un producto necesita identificador fijo, precio entero y estado.
- El precio vive en un lugar; páginas y cobro leen de ahí.
- Pocos productos estables van en archivos; stock que cambia va en una tabla.
- El control de stock tiene niveles: usa el más bajo que te sirva.
- Los productos con pedidos se desactivan, no se borran.
21
Hazlo ahora
En 15 minutos:
- Haz una tabla con tus productos y los campos de esta clase.
- Marca cuáles campos cambian cada semana y cuáles casi nunca.
- Elige el nivel de stock y anota por qué.
- Decide: archivos de contenido o tabla en Supabase.
- Pídele a Claude, en modo plan, el esquema del catálogo y revísalo contra tu tabla.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026