@icarusmx/creta 0.9.0 → 0.9.2

package/lessons/lesson6-interface-design.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // LECCIÓN 6: El énfasis al diseñar los objetos debe estar en la definición de sus solicitudes e interfaces
-// Enfoque práctico: Sistema de gestión de tareas con diseño interface-first
+// Enfoque práctico: Sistema bancario con diseño interface-first y encapsulación
 
 import { createInterface } from 'readline'
 
@@ -33,13 +33,13 @@ export class Lesson6InterfaceDesign {
 
   async practicalExercise() {
     console.clear()
-    console.log("🛠️ EJERCICIO PRÁCTICO: Sistema de Gestión de Tareas")
+    console.log("🛠️ EJERCICIO PRÁCTICO: Sistema Bancario")
     console.log("=" .repeat(50))
     console.log("🎯 Objetivo: Diseñar interfaces ANTES de implementar")
-    console.log("\nVamos a crear un sistema donde:")
-    console.log("- TaskManager gestiona una colección de tareas")
-    console.log("- Task representa una tarea individual")
-    console.log("- TaskStorage guarda y recupera tareas")
+    console.log("\nVamos a crear un sistema bancario donde:")
+    console.log("- BankAccount representa una cuenta con balance privado")
+    console.log("- Transaction registra movimientos entre cuentas")
+    console.log("- Bank gestiona múltiples cuentas y validaciones")
 
     await this.waitForEnter("\nPresiona Enter para ver cómo diseñar las interfaces...")
 
@@ -54,21 +54,22 @@ export class Lesson6InterfaceDesign {
     console.log("📋 PASO 1: Definir las Solicitudes")
     console.log("=" .repeat(40))
     console.log("Antes de escribir código, pensemos: ¿Qué solicitudes debe manejar cada objeto?")
-    console.log("\n🎯 TaskManager debe poder:")
-    console.log("  - Crear una nueva tarea")
-    console.log("  - Listar todas las tareas")
-    console.log("  - Marcar tarea como completada")
-    console.log("  - Eliminar una tarea")
-
-    console.log("\n📝 Task debe poder:")
-    console.log("  - Proporcionar su información")
-    console.log("  - Cambiar su estado (pendiente/completada)")
-    console.log("  - Validar si está completada")
-
-    console.log("\n💾 TaskStorage debe poder:")
-    console.log("  - Guardar una tarea")
-    console.log("  - Recuperar todas las tareas")
-    console.log("  - Eliminar una tarea específica")
+    console.log("\n🏦 BankAccount debe poder:")
+    console.log("  - Consultar balance (sin exponer el dato interno)")
+    console.log("  - Recibir dinero (depósito)")
+    console.log("  - Enviar dinero (con validación interna)")
+    console.log("  - Proporcionar información de la cuenta")
+
+    console.log("\n📊 Transaction debe poder:")
+    console.log("  - Registrar origen, destino y monto")
+    console.log("  - Proporcionar detalles del movimiento")
+    console.log("  - Validar si la transacción es válida")
+
+    console.log("\n🏛️ Bank debe poder:")
+    console.log("  - Crear nuevas cuentas")
+    console.log("  - Procesar transferencias entre cuentas")
+    console.log("  - Validar operaciones antes de ejecutarlas")
+    console.log("  - Llevar registro de todas las transacciones")
 
     await this.waitForEnter("\n✅ ¡Excelente! Ya definimos QUÉ debe hacer cada objeto. Presiona Enter para definir las interfaces...")
   }
@@ -79,33 +80,36 @@ export class Lesson6InterfaceDesign {
     console.log("=" .repeat(50))
     console.log("Ahora especifiquemos CÓMO se solicitan estas operaciones:")
 
-    console.log("\n// TaskManager Interface")
-    console.log("class TaskManager {")
-    console.log("  createTask(title, description) → Task")
-    console.log("  getAllTasks() → Array<Task>")
-    console.log("  completeTask(taskId) → boolean")
-    console.log("  deleteTask(taskId) → boolean")
+    console.log("\n// BankAccount Interface")
+    console.log("class BankAccount {")
+    console.log("  constructor(accountNumber, ownerName, initialBalance) → BankAccount")
+    console.log("  getBalance() → number              // ⚠️ ENCAPSULACIÓN: acceso controlado")
+    console.log("  getAccountInfo() → {number, owner, balance}")
+    console.log("  deposit(amount) → boolean")
+    console.log("  send(amount, targetAccount) → boolean  // ⚠️ VALIDACIÓN interna")
     console.log("}")
 
-    console.log("\n// Task Interface")
-    console.log("class Task {")
-    console.log("  constructor(id, title, description) → Task")
-    console.log("  getInfo() → {id, title, description, completed}")
-    console.log("  markCompleted() → void")
-    console.log("  isCompleted() → boolean")
+    console.log("\n// Transaction Interface")
+    console.log("class Transaction {")
+    console.log("  constructor(from, to, amount, timestamp) → Transaction")
+    console.log("  getDetails() → {from, to, amount, timestamp, status}")
+    console.log("  isValid() → boolean")
     console.log("}")
 
-    console.log("\n// TaskStorage Interface")
-    console.log("class TaskStorage {")
-    console.log("  save(task) → void")
-    console.log("  findAll() → Array<Task>")
-    console.log("  remove(taskId) → boolean")
+    console.log("\n// Bank Interface")
+    console.log("class Bank {")
+    console.log("  createAccount(ownerName, initialBalance) → BankAccount")
+    console.log("  transfer(fromAccount, toAccount, amount) → Transaction")
+    console.log("  getAllTransactions() → Array<Transaction>")
+    console.log("  validateOperation(account, amount) → boolean")
     console.log("}")
 
     console.log("\n💡 Observa que cada operación especifica:")
-    console.log("   a) Nombre de la operación (createTask, save, etc.)")
-    console.log("   b) Insumos necesarios (title, description, taskId, etc.)")
-    console.log("   c) Valor que regresa (Task, boolean, Array, etc.)")
+    console.log("   a) Nombre de la operación (getBalance, send, transfer, etc.)")
+    console.log("   b) Insumos necesarios (amount, targetAccount, etc.)")
+    console.log("   c) Valor que regresa (boolean, Transaction, etc.)")
+    console.log("\n🔒 Nota especial: getBalance() encapsula el acceso al estado interno")
+    console.log("🛡️  Nota especial: send() incluirá validación antes de ejecutar")
 
     await this.waitForEnter("\n✅ Interfaces definidas. Presiona Enter para implementar...")
   }
@@ -116,90 +120,126 @@ export class Lesson6InterfaceDesign {
     console.log("=" .repeat(40))
     console.log("Ahora que tenemos las interfaces claras, implementemos:")
 
-    console.log("\n// Implementación de Task")
-    console.log(`class Task {
-  constructor(id, title, description) {
-    this.id = id
-    this.title = title
-    this.description = description
-    this.completed = false
+    console.log("\n// Implementación de BankAccount")
+    console.log(`class BankAccount {
+  constructor(accountNumber, ownerName, initialBalance) {
+    this.accountNumber = accountNumber
+    this.ownerName = ownerName
+    this.#balance = initialBalance  // 🔒 PRIVADO: no se accede directamente
   }
 
-  getInfo() {
+  // 🔑 ENCAPSULACIÓN: método GET para acceder al balance
+  getBalance() {
+    return this.#balance
+  }
+
+  getAccountInfo() {
     return {
-      id: this.id,
-      title: this.title,
-      description: this.description,
-      completed: this.completed
+      number: this.accountNumber,
+      owner: this.ownerName,
+      balance: this.#balance  // Controlamos qué se expone
     }
   }
 
-  markCompleted() {
-    this.completed = true
+  deposit(amount) {
+    if (amount > 0) {
+      this.#balance += amount
+      return true
+    }
+    return false
   }
 
-  isCompleted() {
-    return this.completed
+  // 🛡️ VALIDACIÓN: método SEND con lógica interna
+  send(amount, targetAccount) {
+    // Validación interna ANTES de ejecutar
+    if (amount > 0 && this.#balance >= amount) {
+      this.#balance -= amount
+      targetAccount.deposit(amount)
+      return true
+    }
+    return false  // Fondos insuficientes o monto inválido
   }
 }`)
 
-    await this.waitForEnter("\nPresiona Enter para ver TaskStorage...")
+    await this.waitForEnter("\nPresiona Enter para ver Transaction...")
 
-    console.log("\n// Implementación de TaskStorage")
-    console.log(`class TaskStorage {
-  constructor() {
-    this.tasks = []
+    console.log("\n// Implementación de Transaction")
+    console.log(`class Transaction {
+  constructor(fromAccount, toAccount, amount) {
+    this.fromAccount = fromAccount
+    this.toAccount = toAccount
+    this.amount = amount
+    this.timestamp = new Date()
+    this.status = 'pending'
   }
 
-  save(task) {
-    this.tasks.push(task)
+  getDetails() {
+    return {
+      from: this.fromAccount.accountNumber,
+      to: this.toAccount.accountNumber,
+      amount: this.amount,
+      timestamp: this.timestamp,
+      status: this.status
+    }
   }
 
-  findAll() {
-    return [...this.tasks]
+  isValid() {
+    return this.amount > 0 &&
+           this.fromAccount.getBalance() >= this.amount
   }
 
-  remove(taskId) {
-    const index = this.tasks.findIndex(t => t.id === taskId)
-    if (index !== -1) {
-      this.tasks.splice(index, 1)
-      return true
+  execute() {
+    if (this.isValid()) {
+      const success = this.fromAccount.send(this.amount, this.toAccount)
+      this.status = success ? 'completed' : 'failed'
+      return success
     }
+    this.status = 'failed'
     return false
   }
 }`)
 
-    await this.waitForEnter("\nPresiona Enter para ver TaskManager...")
+    await this.waitForEnter("\nPresiona Enter para ver Bank...")
 
-    console.log("\n// Implementación de TaskManager")
-    console.log(`class TaskManager {
-  constructor(storage) {
-    this.storage = storage
-    this.nextId = 1
+    console.log("\n// Implementación de Bank")
+    console.log(`class Bank {
+  constructor() {
+    this.accounts = []
+    this.transactions = []
+    this.nextAccountNumber = 1000
   }
 
-  createTask(title, description) {
-    const task = new Task(this.nextId++, title, description)
-    this.storage.save(task)
-    return task
+  createAccount(ownerName, initialBalance) {
+    const account = new BankAccount(
+      this.nextAccountNumber++,
+      ownerName,
+      initialBalance
+    )
+    this.accounts.push(account)
+    return account
   }
 
-  getAllTasks() {
-    return this.storage.findAll()
-  }
+  transfer(fromAccount, toAccount, amount) {
+    const transaction = new Transaction(fromAccount, toAccount, amount)
 
-  completeTask(taskId) {
-    const tasks = this.storage.findAll()
-    const task = tasks.find(t => t.id === taskId)
-    if (task) {
-      task.markCompleted()
-      return true
+    // El Bank valida ANTES de ejecutar
+    if (this.validateOperation(fromAccount, amount)) {
+      const success = transaction.execute()
+      this.transactions.push(transaction)
+      return transaction
     }
-    return false
+
+    transaction.status = 'failed'
+    this.transactions.push(transaction)
+    return transaction
+  }
+
+  validateOperation(account, amount) {
+    return amount > 0 && account.getBalance() >= amount
   }
 
-  deleteTask(taskId) {
-    return this.storage.remove(taskId)
+  getAllTransactions() {
+    return [...this.transactions]
   }
 }`)
 
@@ -212,62 +252,102 @@ export class Lesson6InterfaceDesign {
     console.log("=" .repeat(45))
     console.log("Veamos cómo los objetos colaboran usando sus interfaces:")
 
-    console.log("\n// Crear el sistema")
-    console.log("const storage = new TaskStorage()")
-    console.log("const manager = new TaskManager(storage)")
+    console.log("\n// Crear el sistema bancario")
+    console.log("const bank = new Bank()")
+    console.log("const cuenta1 = bank.createAccount('Ana García', 1000)")
+    console.log("const cuenta2 = bank.createAccount('Carlos López', 500)")
     console.log("")
-    console.log("// Los objetos interactúan a través de solicitudes")
-    console.log("const task1 = manager.createTask('Estudiar OOP', 'Completar lección 6')")
-    console.log("const task2 = manager.createTask('Practicar código', 'Implementar sistema de tareas')")
+    console.log("// 🔑 ENCAPSULACIÓN: Solo podemos acceder al balance via getBalance()")
+    console.log("console.log('Balance Ana:', cuenta1.getBalance())  // 1000")
+    console.log("console.log('Balance Carlos:', cuenta2.getBalance())  // 500")
     console.log("")
-    console.log("// Cada solicitud respeta la interfaz definida")
-    console.log("manager.completeTask(task1.id)")
-    console.log("const allTasks = manager.getAllTasks()")
+    console.log("// 🛡️ VALIDACIÓN: send() verifica internamente antes de ejecutar")
+    console.log("const exitoso = cuenta1.send(300, cuenta2)  // ✅ Tiene fondos")
+    console.log("console.log('Transferencia exitosa:', exitoso)  // true")
     console.log("")
-    console.log("allTasks.forEach(task => {")
-    console.log("  const info = task.getInfo() // Solicitud a Task")
-    console.log("  console.log(`${info.title}: ${info.completed ? '✅' : '❌'}`)")
-    console.log("})")
+    console.log("const fallido = cuenta1.send(1500, cuenta2)  // ❌ Fondos insuficientes")
+    console.log("console.log('Transferencia fallida:', fallido)  // false")
+    console.log("")
+    console.log("// El estado interno se mantiene íntegro")
+    console.log("console.log('Balance final Ana:', cuenta1.getBalance())  // 700")
+    console.log("console.log('Balance final Carlos:', cuenta2.getBalance())  // 800")
 
     console.log("\n🎯 Resultado esperado:")
-    console.log("Estudiar OOP: ✅")
-    console.log("Practicar código: ❌")
+    console.log("Balance Ana: 1000")
+    console.log("Balance Carlos: 500")
+    console.log("Transferencia exitosa: true")
+    console.log("Transferencia fallida: false")
+    console.log("Balance final Ana: 700")
+    console.log("Balance final Carlos: 800")
 
     await this.waitForEnter("\nPresiona Enter para ver los beneficios de este enfoque...")
 
     console.clear()
-    console.log("🌟 BENEFICIOS DEL DISEÑO INTERFACE-FIRST")
-    console.log("=" .repeat(45))
-    console.log("1. 🎯 Claridad: Cada objeto tiene responsabilidades bien definidas")
-    console.log("2. 🔗 Colaboración: Los objetos saben exactamente cómo solicitar operaciones")
-    console.log("3. 🔄 Flexibilidad: Podemos cambiar TaskStorage por DatabaseStorage sin afectar TaskManager")
-    console.log("4. 🧪 Testeable: Podemos crear mocks fácilmente para testing")
-    console.log("5. 📚 Mantenible: Las interfaces documentan el contrato de cada objeto")
+    console.log("🌟 BENEFICIOS DEL DISEÑO INTERFACE-FIRST EN SISTEMAS BANCARIOS")
+    console.log("=" .repeat(60))
+    console.log("1. 🔒 Encapsulación: El balance está protegido, solo accesible via getBalance()")
+    console.log("2. 🛡️ Validación: send() incluye lógica de negocio interna")
+    console.log("3. 🎯 Claridad: Cada objeto tiene responsabilidades financieras bien definidas")
+    console.log("4. 🔗 Colaboración: Los objetos saben exactamente cómo solicitar operaciones")
+    console.log("5. 🧪 Testeable: Podemos simular cuentas y transacciones fácilmente")
+    console.log("6. 📚 Mantenible: Las interfaces documentan el contrato bancario")
 
     console.log("\n💡 Ejemplo de extensibilidad:")
-    console.log("// Podemos cambiar el storage sin modificar TaskManager")
-    console.log("class DatabaseStorage {")
-    console.log("  save(task) { /* guardar en BD */ }")
-    console.log("  findAll() { /* consultar BD */ }")
-    console.log("  remove(taskId) { /* eliminar de BD */ }")
+    console.log("// Podemos crear diferentes tipos de cuenta sin cambiar Bank")
+    console.log("class SavingsAccount extends BankAccount {")
+    console.log("  getBalance() {")
+    console.log("    return super.getBalance() + this.calculateInterest()")
+    console.log("  }")
+    console.log("}")
+    console.log("")
+    console.log("class CreditAccount extends BankAccount {")
+    console.log("  send(amount, target) {")
+    console.log("    // Permite sobregiro hasta el límite de crédito")
+    console.log("    if (amount > 0 && (this.getBalance() + this.creditLimit) >= amount) {")
+    console.log("      // ... lógica específica")
+    console.log("    }")
+    console.log("  }")
     console.log("}")
     console.log("")
-    console.log("// TaskManager sigue funcionando igual!")
-    console.log("const dbStorage = new DatabaseStorage()")
-    console.log("const manager = new TaskManager(dbStorage)")
+    console.log("// Las cuentas pueden enviarse dinero directamente!")
+    console.log("const savingsAcc = new SavingsAccount(123, 'María', 1000)")
+    console.log("const creditAcc = new CreditAccount(456, 'Juan', 500, 2000)  // límite crédito")
+    console.log("savingsAcc.send(300, creditAcc)  // ¡Funciona con cualquier tipo de cuenta!")
+    console.log("")
+    console.log("// O podemos usar el Bank para registro completo:")
+    console.log("bank.transfer(savingsAcc, creditAcc, 300)  // Crea Transaction automáticamente")
 
     await this.waitForEnter("\nPresiona Enter para continuar con la conclusión...")
   }
 
   async conclusion() {
     console.clear()
-    console.log("🎓 CONCLUSIÓN: Diseño basado en Interfaces")
-    console.log("=" .repeat(45))
+    console.log("🎓 CONCLUSIÓN: Diseño basado en Interfaces (Sistema Bancario)")
+    console.log("=" .repeat(55))
     console.log("🎯 Hemos demostrado que:")
     console.log("\n1. El ÉNFASIS debe estar en definir QUÉ solicitudes maneja cada objeto")
-    console.log("2. Las INTERFACES especifican cómo hacer estas solicitudes")
-    console.log("3. La IMPLEMENTACIÓN viene después, siguiendo el contrato")
-    console.log("4. Los objetos COLABORAN a través de estas interfaces bien definidas")
+    console.log("2. Las INTERFACES son el CONJUNTO de todas las firmas de operación")
+    console.log("3. Cada FIRMA especifica: nombre, insumos y valor de retorno")
+    console.log("4. La IMPLEMENTACIÓN viene después, siguiendo el contrato")
+    console.log("5. Los objetos COLABORAN a través de estas interfaces bien definidas")
+
+    console.log("\n📋 Firmas de operación en nuestro ejemplo:")
+    console.log("• BankAccount.getBalance() → number")
+    console.log("• BankAccount.send(amount, targetAccount) → boolean")
+    console.log("• Bank.createAccount(ownerName, initialBalance) → BankAccount")
+    console.log("• Bank.transfer(fromAccount, toAccount, amount) → Transaction")
+    console.log("• Transaction.getDetails() → {from, to, amount, timestamp, status}")
+
+    console.log("\n🔑 La interfaz de BankAccount es el CONJUNTO completo:")
+    console.log("  {getBalance, getAccountInfo, deposit, send}")
+    console.log("🔑 La interfaz de Bank es el CONJUNTO completo:")
+    console.log("  {createAccount, transfer, getAllTransactions, validateOperation}")
+
+    console.log("\n💡 Beneficios de este enfoque:")
+    console.log("• ENCAPSULACIÓN: getBalance() protege el acceso al estado interno")
+    console.log("• VALIDACIÓN: send() ejecuta lógica de negocio antes de operar")
+    console.log("• CONTRATO CLARO: Cada firma especifica exactamente qué esperar")
+    console.log("• COLABORACIÓN: Los objetos conocen las firmas de otros objetos")
 
     console.log("\n📚 Conexión con lecciones anteriores:")
     console.log("• Lección 2: Los objetos interactúan a través de solicitudes ✓")
@@ -280,12 +360,20 @@ export class Lesson6InterfaceDesign {
     console.log("Practica este enfoque en tus propios proyectos:")
     console.log("1. Define primero QUÉ debe hacer cada objeto")
     console.log("2. Especifica las interfaces (firmas de operación)")
-    console.log("3. Implementa respetando esos contratos")
-    console.log("4. Haz que los objetos colaboren a través de solicitudes")
+    console.log("3. Incluye validaciones internas en tus métodos")
+    console.log("4. Encapsula el estado, expón solo lo necesario")
+    console.log("5. Haz que los objetos colaboren a través de solicitudes")
 
     console.log("\n💭 Reflexión final:")
-    console.log("¿Cómo cambiaría tu forma de programar si siempre empezaras")
-    console.log("definiendo las interfaces antes de la implementación?")
+    console.log("Antes de implementar cualquier objeto, pregúntate:")
+    console.log("• ¿Cuáles son TODAS las firmas de operación que necesito?")
+    console.log("• ¿Qué nombre, insumos y valor de retorno tendrá cada firma?")
+    console.log("• ¿Cómo van a colaborar los objetos usando estas firmas?")
+    console.log("• ¿El CONJUNTO de firmas forma una interfaz coherente?")
+
+    console.log("\n🏆 ¡Has completado el ejemplo más importante del diseño orientado a objetos!")
+    console.log("Ahora entiendes que el ÉNFASIS debe estar en definir el CONJUNTO")
+    console.log("completo de firmas de operación ANTES de implementar.")
 
     await this.waitForEnter("\n✨ ¡Lección 6 completada! Presiona Enter para salir...")
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icarusmx/creta",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {