🛒 Sistema de Tienda - TypeScript

Un proyecto educativo que implementa un carrito de compras con manejo de productos físicos y digitales usando TypeScript. Demuestra conceptos clave de la programación orientada a objetos como herencia, interfaces y polimorfismo.

---

📋 Descripción

Este programa simula una tienda en línea donde puedes:

• ✅ Crear productos físicos (con peso y costo de envío)
• ✅ Crear productos digitales (con descuentos)
• ✅ Agregar productos al carrito
• ✅ Eliminar productos del carrito
• ✅ Calcular el precio total dinámicamente
• ✅ Ver detalles de cada producto en el carrito

Tecnologías utilizadas:

• TypeScript
• Programación Orientada a Objetos (POO)
• Interfaces y clases abstractas

---

🏗️ Estructura del Proyecto

tienda.ts
├── Types
│   └── ID (string | number)
├── Interfaces
│   ├── Producto
│   ├── IProductoFisico
│   └── IProductoDigital
├── Clases
│   ├── ProductoBase
│   ├── ProductoFisico
│   ├── ProductoDigital
│   └── Carrito
└── Funciones utilitarias
    └── procesarInventario()

---

🎯 Conceptos de TypeScript Utilizados

Concepto	Descripción	Ubicación
Types	Definición de tipos personalizados	type ID = string | number
Interfaces	Contratos para clases	Producto, IProductoFisico, IProductoDigital
Herencia	Clases que extienden otras	ProductoFisico extends ProductoBase
Polimorfismo	Métodos sobrescrito	obtenerPrecioFinal() en cada clase
Modificadores	private, readonly	Control de acceso a propiedades
instanceof	Verificar tipo en tiempo de ejecución	En mostrarDetalle()

---

📦 Clases Principales

📌 ProductoBase

Clase base que implementa la interfaz Producto. Define propiedades comunes y método base para calcular precio.

const libro = new ProductoBase("1", "Libro TypeScript", 300);
console.log(libro.obtenerPrecioFinal()); // 300

📦 ProductoFisico

Extiende ProductoBase e implementa IProductoFisico. Calcula costo de envío según peso.

const laptop = new ProductoFisico("2", "Laptop", 1200, 3); // peso: 3kg
console.log(laptop.obtenerPrecioFinal()); // 1200 + (3 * 10) = 1230

💾 ProductoDigital

Extiende ProductoBase e implementa IProductoDigital. Aplica descuento del 10%.

const curso = new ProductoDigital("3", "Curso TS", 500, "https://descarga.com");
console.log(curso.obtenerPrecioFinal()); // 500 * 0.9 = 450

🛒 Carrito

Gestiona una colección de productos con métodos para manipular el inventario.

const carrito = new Carrito();
carrito.agregarProducto(libro);
carrito.agregarProducto(curso);
console.log(carrito.calcularTotal()); // Total de todos los productos
carrito.mostrarDetalle(); // Muestra detalles de cada producto

---

🚀 Cómo Usar

Instalación

# Clona el repositorio
git clone <tu-repo>

# Instala TypeScript (si no lo tienes)
npm install -g typescript

Compilar

tsc tienda.ts

Ejecutar

node tienda.js

---

📊 Ejemplo de Uso Completo

// Crear un carrito
const carrito = new Carrito();

// Crear productos
const libro = new ProductoFisico("1", "Libro TypeScript", 300, 2);
const curso = new ProductoDigital("2", "Curso TS", 500, "www.descarga.com");

// Agregar al carrito
carrito.agregarProducto(libro);
carrito.agregarProducto(curso);

// Ver detalles
carrito.mostrarDetalle();
// Salida:
// Producto físico: Libro TypeScript - Peso: 2kg
// Precio final: $320
// --------------
// Producto digital: Curso TS - Descarga: www.descarga.com
// Precio final: $450
// --------------

// Calcular total
console.log("Total:", carrito.calcularTotal()); // Total: 770

---

💡 Aprendizajes Clave

✨ Herencia: ProductoFisico y ProductoDigital heredan de ProductoBase reutilizando código.

✨ Polimorfismo: Cada producto calcula su precio final de forma diferente.

✨ Encapsulamiento: La propiedad productos es private, solo se accede mediante métodos.

✨ Interfaces: Definen contratos que garantizan que todas las clases tengan los métodos necesarios.

✨ Type Safety: TypeScript detecta errores en tiempo de compilación, no en ejecución.

---

📝 Notas Para Principiantes

Este proyecto es ideal para aprender:

• Cómo estructurar un programa con clases e interfaces
• La diferencia entre herencia e interfaces
• Por qué usar private y readonly
• Cómo aplicar patrones reales de programación

---

🔧 Mejoras Futuras

• Agregar sistema de cupones y descuentos
• Persistencia de datos (bases de datos)
• Sistema de pagos
• Autenticación de usuarios
• API REST para consultar productos

---

👨‍💻 Autor

Ana Laura Doroteo Barrientos: Proyecto de práctica en TypeScript | Portafolio de GitHub

---