@icarusmx/creta 0.9.1 → 0.10.0

package/bin/creta.js

@@ -6,6 +6,7 @@ import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
 import { CretaCodeSession } from '../lib/session.js'
+import { Lesson1SystemDecomposition } from '../lessons/lesson1-system-decomposition.js'
 import { Lesson6InterfaceDesign } from '../lessons/lesson6-interface-design.js'
 
 const ENUNCIADOS = [
@@ -812,7 +813,21 @@ async function startEnunciadosSelectorInteractive() {
         console.log(`📚 Nivel: ${enunciadoSeleccionado.nivel}`)
 
         // Check if we have a lesson implementation for this enunciado
-        if (enunciadoSeleccionado.id === 6) {
+        if (enunciadoSeleccionado.id === 1) {
+          console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+          await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+          try {
+            const lesson1 = new Lesson1SystemDecomposition()
+            await lesson1.start()
+          } catch (error) {
+            console.error("\n❌ Error al ejecutar la lección:", error.message)
+            console.log("\n🚀 Próximamente:")
+            console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+            console.log("- Ejercicios prácticos que ilustren el concepto")
+            console.log("- Proyectos específicos para internalizar la idea")
+          }
+        } else if (enunciadoSeleccionado.id === 6) {
           console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
           await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
 
@@ -895,7 +910,23 @@ async function startEnunciadosSelectorFallback() {
       console.log(`📚 Nivel: ${enunciadoSeleccionado.nivel}`)
 
       // Check if we have a lesson implementation for this enunciado
-      if (enunciadoSeleccionado.id === 6) {
+      if (enunciadoSeleccionado.id === 1) {
+        console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
+        rl.close()
+        await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause
+
+        try {
+          const lesson1 = new Lesson1SystemDecomposition()
+          await lesson1.start()
+        } catch (error) {
+          console.error("\n❌ Error al ejecutar la lección:", error.message)
+          console.log("\n🚀 Próximamente:")
+          console.log("- Sesiones de estudio dirigidas basadas en este enunciado")
+          console.log("- Ejercicios prácticos que ilustren el concepto")
+          console.log("- Proyectos específicos para internalizar la idea")
+        }
+        return
+      } else if (enunciadoSeleccionado.id === 6) {
         console.log("\n🚀 ¡Lección disponible! Iniciando sesión de estudio dirigida...")
         rl.close()
         await new Promise(resolve => setTimeout(resolve, 1500)) // Brief pause

package/lessons/lesson1-system-decomposition.js

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+// LECCIÓN 1: La parte difícil del diseño orientado a objetos es descomponer un sistema como un conjunto de objetos que interactúan entre sí
+// Enfoque práctico: Dos definiciones de sistema y su descomposición en objetos
+
+import { createInterface } from 'readline'
+
+export class Lesson1SystemDecomposition {
+  constructor() {
+    this.rl = createInterface({
+      input: process.stdin,
+      output: process.stdout
+    })
+  }
+
+  async start() {
+    console.log("🎯 LECCIÓN 1: Descomposición de Sistemas")
+    console.log("=" .repeat(50))
+    console.log("📚 Concepto: La parte difícil del diseño orientado a objetos es descomponer un sistema como un conjunto de objetos que interactúan entre sí.")
+    console.log("\n💡 ¿Por qué es la parte difícil?")
+    console.log("- Pasar de una idea abstracta a objetos concretos")
+    console.log("- Decidir dónde están los límites entre objetos")
+    console.log("- Definir cómo estos objetos van a interactuar")
+    console.log("- Balancear teoría y práctica en el diseño")
+
+    await this.waitForEnter("\nPresiona Enter para comenzar con las definiciones de sistema...")
+
+    await this.practicalExercise()
+    await this.conclusion()
+
+    this.rl.close()
+  }
+
+  async practicalExercise() {
+    console.clear()
+    console.log("🛠️ EJERCICIO PRÁCTICO: Biblioteca Digital")
+    console.log("=" .repeat(50))
+    console.log("🎯 Objetivo: Entender dos definiciones de sistema y su descomposición")
+    console.log("\nComenzaremos con dos definiciones de sistema y posteriormente")
+    console.log("ejemplificaremos la descomposición en objetos.")
+
+    await this.waitForEnter("\nPresiona Enter para ver las definiciones...")
+
+    await this.step1_SystemDefinitions()
+    await this.step2_ApplyDefinitions()
+    await this.step3_DecompositionChallenge()
+    await this.step4_ObjectIdentification()
+  }
+
+  async step1_SystemDefinitions() {
+    console.clear()
+    console.log("📖 PASO 1: Dos Definiciones de Sistema")
+    console.log("=" .repeat(45))
+    console.log("Antes de descomponer, debemos entender qué ES un sistema:")
+
+    console.log("\n🔬 DEFINICIÓN 1 (Teórica):")
+    console.log("\"El sistema es una totalidad deductiva de discurso\"")
+    console.log("")
+    console.log("• Enfoque: Estructura lógica y coherencia conceptual")
+    console.log("• Pregunta clave: ¿Qué reglas gobiernan este dominio?")
+    console.log("• Ejemplo: Las leyes matemáticas que definen la geometría")
+
+    console.log("\n🎯 DEFINICIÓN 2 (Práctica):")
+    console.log("\"El sistema es un conjunto de cosas que relacionadas")
+    console.log("entre sí ordenadamente contribuyen a un determinado propósito\"")
+    console.log("")
+    console.log("• Enfoque: Componentes colaborando hacia un objetivo")
+    console.log("• Pregunta clave: ¿Qué partes trabajan juntas para qué fin?")
+    console.log("• Ejemplo: Motor, ruedas, frenos trabajando para transportar")
+
+    await this.waitForEnter("\n💭 ¿Ves cómo ambas son válidas pero muy diferentes? Presiona Enter para aplicarlas...")
+  }
+
+  async step2_ApplyDefinitions() {
+    console.clear()
+    console.log("📚 PASO 2: Aplicando las Definiciones")
+    console.log("=" .repeat(45))
+    console.log("Vamos a analizar una \"Biblioteca Digital\" desde ambos enfoques:")
+
+    console.log("\n🔬 BIBLIOTECA como TOTALIDAD DEDUCTIVA:")
+    console.log("Las reglas lógicas que gobiernan el dominio:")
+    console.log("")
+    console.log("• Un libro puede estar disponible o prestado")
+    console.log("• Un usuario puede tener máximo N libros prestados")
+    console.log("• Un préstamo tiene fecha de inicio y vencimiento")
+    console.log("• Solo usuarios registrados pueden solicitar préstamos")
+    console.log("• Un libro prestado no puede prestarse a otro usuario")
+    console.log("• Los préstamos vencidos generan multas")
+
+    await this.waitForEnter("\nPresiona Enter para ver la definición práctica...")
+
+    console.log("\n🎯 BIBLIOTECA como CONJUNTO ORDENADO:")
+    console.log("Componentes que colaboran hacia el propósito de 'gestionar conocimiento':")
+    console.log("")
+    console.log("• Catálogo de libros disponibles")
+    console.log("• Sistema de usuarios registrados")
+    console.log("• Proceso de préstamos y devoluciones")
+    console.log("• Control de fechas y multas")
+    console.log("• Búsqueda y recomendaciones")
+    console.log("• Reportes de uso y estadísticas")
+
+    await this.waitForEnter("\n🤔 Ambas describen lo mismo, pero ¿cómo las convertimos en objetos? Presiona Enter...")
+  }
+
+  async step3_DecompositionChallenge() {
+    console.clear()
+    console.log("⚡ PASO 3: El Desafío de la Descomposición")
+    console.log("=" .repeat(50))
+    console.log("Aquí viene LA PARTE DIFÍCIL: ¿Qué objetos creamos?")
+
+    console.log("\n🤯 Preguntas que generan 'ruido':")
+    console.log("• ¿Book es un objeto o solo datos?")
+    console.log("• ¿User y Member son el mismo objeto?")
+    console.log("• ¿Loan es un objeto o un método en Library?")
+    console.log("• ¿Catalog es separado de Library?")
+    console.log("• ¿Fine es un objeto o una propiedad de Loan?")
+    console.log("• ¿Search es un objeto o funcionalidad de Catalog?")
+
+    console.log("\n💡 La dificultad surge de:")
+    console.log("1. Las reglas lógicas (def. 1) no nos dicen directamente qué objetos crear")
+    console.log("2. Los componentes (def. 2) pueden agruparse de múltiples formas")
+    console.log("3. No hay una 'respuesta correcta' única")
+    console.log("4. Debemos balancear teoría (coherencia) y práctica (propósito)")
+
+    await this.waitForEnter("\nPresiona Enter para ver cómo abordar esta descomposición...")
+  }
+
+  async step4_ObjectIdentification() {
+    console.clear()
+    console.log("🎯 PASO 4: Estrategia de Identificación de Objetos")
+    console.log("=" .repeat(55))
+    console.log("Combinemos ambas definiciones para guiar nuestra descomposición:")
+
+    console.log("\n📋 PASO 4A: Identificar Entidades Centrales")
+    console.log("(De la definición práctica - cosas que colaboran)")
+    console.log("")
+    console.log("• Book - Representa el conocimiento a gestionar")
+    console.log("• User - Quien interactúa con el sistema")
+    console.log("• Loan - La relación temporal entre User y Book")
+    console.log("• Library - El coordinador general del sistema")
+
+    await this.waitForEnter("\nPresiona Enter para ver las reglas...")
+
+    console.log("\n📋 PASO 4B: Validar con Reglas Lógicas")
+    console.log("(De la definición teórica - coherencia del discurso)")
+    console.log("")
+    console.log("• ¿Book puede validar si está disponible? ✓")
+    console.log("• ¿User puede verificar su límite de préstamos? ✓")
+    console.log("• ¿Loan puede calcular si está vencido? ✓")
+    console.log("• ¿Library puede aplicar las reglas de negocio? ✓")
+
+    await this.waitForEnter("\nPresiona Enter para ver el resultado...")
+
+    console.log("\n🏗️ PASO 4C: Descomposición Resultante")
+    console.log("")
+    console.log("class Book {")
+    console.log("  // Encapsula: título, autor, ISBN, estado")
+    console.log("  isAvailable() → boolean")
+    console.log("  markAsLoaned() → void")
+    console.log("}")
+    console.log("")
+    console.log("class User {")
+    console.log("  // Encapsula: nombre, email, límites, historial")
+    console.log("  canBorrow() → boolean")
+    console.log("  getCurrentLoans() → Array<Loan>")
+    console.log("}")
+    console.log("")
+    console.log("class Loan {")
+    console.log("  // Encapsula: fechas, estado, multas")
+    console.log("  isOverdue() → boolean")
+    console.log("  calculateFine() → number")
+    console.log("}")
+    console.log("")
+    console.log("class Library {")
+    console.log("  // Coordina las interacciones, aplica reglas de negocio")
+    console.log("  lendBook(user, book) → Loan")
+    console.log("  returnBook(loan) → boolean")
+    console.log("}")
+
+    await this.waitForEnter("\nPresiona Enter para ver por qué esta descomposición funciona...")
+
+    console.clear()
+    console.log("✅ POR QUÉ ESTA DESCOMPOSICIÓN FUNCIONA")
+    console.log("=" .repeat(45))
+    console.log("🔬 Satisface la definición TEÓRICA:")
+    console.log("• Cada objeto encapsula reglas coherentes de su dominio")
+    console.log("• Book 'sabe' sobre disponibilidad")
+    console.log("• User 'sabe' sobre sus límites")
+    console.log("• Loan 'sabe' sobre fechas y multas")
+    console.log("• Library 'conoce' las reglas de interacción")
+
+    console.log("\n🎯 Satisface la definición PRÁCTICA:")
+    console.log("• Los objetos colaboran hacia 'gestionar conocimiento'")
+    console.log("• Cada uno tiene responsabilidad clara en el propósito")
+    console.log("• Juntos forman un sistema ordenado y funcional")
+    console.log("• Sus interacciones cumplen el objetivo del sistema")
+
+    console.log("\n💡 La 'parte difícil' se resuelve:")
+    console.log("1. Usando ambas definiciones como guía")
+    console.log("2. Identificando entidades que tengan tanto coherencia lógica")
+    console.log("   como propósito práctico")
+    console.log("3. Validando que los objetos puedan 'interactuar entre sí'")
+    console.log("4. Asegurando que cada objeto contribuya al sistema completo")
+
+    await this.waitForEnter("\nPresiona Enter para continuar con la conclusión...")
+  }
+
+  async conclusion() {
+    console.clear()
+    console.log("🎓 CONCLUSIÓN: La Descomposición de Sistemas")
+    console.log("=" .repeat(50))
+    console.log("🎯 Hemos demostrado que:")
+    console.log("\n1. Un SISTEMA puede entenderse desde dos perspectivas complementarias")
+    console.log("2. La descomposición es difícil porque debemos satisfacer AMBAS")
+    console.log("3. Los objetos deben tener COHERENCIA LÓGICA (def. teórica)")
+    console.log("4. Los objetos deben COLABORAR HACIA UN PROPÓSITO (def. práctica)")
+    console.log("5. La interacción entre objetos es lo que mantiene al sistema unificado")
+
+    console.log("\n🔑 Estrategia para futuras descomposiciones:")
+    console.log("• PASO 1: Define las reglas lógicas del dominio")
+    console.log("• PASO 2: Identifica el propósito y componentes colaboradores")
+    console.log("• PASO 3: Busca entidades que satisfagan ambos aspectos")
+    console.log("• PASO 4: Valida que puedan interactuar coherentemente")
+
+    console.log("\n📚 Conexión con lecciones siguientes:")
+    console.log("• Lección 2: Cómo estos objetos INTERACTÚAN (solicitudes)")
+    console.log("• Lección 3: Qué mecanismo usan para colaborar")
+    console.log("• Lección 4-6: Cómo definir esas interacciones (interfaces)")
+
+    console.log("\n💭 Reflexión final:")
+    console.log("Antes de escribir código, pregúntate:")
+    console.log("• ¿Qué reglas lógicas gobiernan este dominio?")
+    console.log("• ¿Qué propósito debe cumplir este sistema?")
+    console.log("• ¿Qué objetos pueden satisfacer ambos aspectos?")
+    console.log("• ¿Cómo van a interactuar para mantener la coherencia del sistema?")
+
+    console.log("\n🏆 ¡Has comprendido por qué la descomposición es la parte difícil!")
+    console.log("Ahora entiendes que no es solo dividir código en clases,")
+    console.log("sino encontrar la estructura que honre tanto la lógica como el propósito.")
+
+    await this.waitForEnter("\n✨ ¡Lección 1 completada! Presiona Enter para salir...")
+  }
+
+  async waitForEnter(message) {
+    return new Promise((resolve) => {
+      this.rl.question(message, () => {
+        resolve()
+      })
+    })
+  }
+}
+
+// Para usar la lección independientemente
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const lesson = new Lesson1SystemDecomposition()
+  await lesson.start()
+}

package/lessons/lesson6-interface-design.js

@@ -309,10 +309,13 @@ export class Lesson6InterfaceDesign {
     console.log("  }")
     console.log("}")
     console.log("")
-    console.log("// Bank sigue funcionando igual con cualquier tipo de cuenta!")
+    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("bank.transfer(savingsAcc, creditAcc, 300)  // ¡Funciona!")
+    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...")
   }
@@ -323,15 +326,28 @@ export class Lesson6InterfaceDesign {
     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("\n🔑 Lecciones específicas del ejemplo bancario:")
+    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("• RESPONSABILIDAD: Cada objeto maneja su propia integridad")
-    console.log("• COLABORACIÓN: Bank, BankAccount y Transaction trabajan juntos")
+    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 ✓")
@@ -349,12 +365,15 @@ export class Lesson6InterfaceDesign {
     console.log("5. Haz que los objetos colaboren a través de solicitudes")
 
     console.log("\n💭 Reflexión final:")
-    console.log("En el mundo real, ¿cómo te asegurarías de que tu cuenta bancaria")
-    console.log("esté protegida y que solo se ejecuten operaciones válidas?")
-    console.log("¡Exactamente como lo hicimos aquí: interfaces bien definidas!")
+    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 por qué el ÉNFASIS debe estar en las interfaces.")
+    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.1",
+  "version": "0.10.0",
   "description": "Salgamos de este laberinto.",
   "type": "module",
   "bin": {