@icarusmx/creta 0.10.0 → 0.10.2

package/bin/creta.js

@@ -817,6 +817,20 @@ async function startEnunciadosSelectorInteractive() {
           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 === 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()
@@ -915,6 +929,22 @@ async function startEnunciadosSelectorFallback() {
         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 === 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()

package/lessons/lesson1-system-decomposition.js

@@ -14,16 +14,11 @@ export class Lesson1SystemDecomposition {
   }
 
   async start() {
-    console.log("🎯 LECCIÓN 1: Descomposición de Sistemas")
+    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")
+    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í.")
 
-    await this.waitForEnter("\nPresiona Enter para comenzar con las definiciones de sistema...")
+    await this.waitForEnter("\nPresiona Enter para comenzar...")
 
     await this.practicalExercise()
     await this.conclusion()
@@ -33,176 +28,203 @@ export class Lesson1SystemDecomposition {
 
   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("Comenzaremos 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.waitForEnter("\nPresiona Enter para continuar...")
 
     await this.step1_SystemDefinitions()
     await this.step2_ApplyDefinitions()
-    await this.step3_DecompositionChallenge()
-    await this.step4_ObjectIdentification()
+    await this.step3_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("DEFINICIÓN 1:")
+    console.log("El sistema es una totalidad deductiva de discurso")
 
-    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("\nDEFINICIÓN 2:")
+    console.log("El sistema es un conjunto de cosas que relacionadas")
+    console.log("entre sí ordenadamente contribuyen a un determinado propósito")
 
-    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...")
+    await this.waitForEnter("\nPresiona Enter para ver la biblioteca digital...")
   }
 
   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("🏛️ EJEMPLO: Biblioteca Digital")
+    console.log("=" .repeat(40))
 
-    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")
+    console.log("\n📚 DEFINICIÓN 1 - Totalidad deductiva de discurso:")
+    console.log("Partiendo de 'Biblioteca Digital', ¿qué se deduce naturalmente?")
+    await this.waitForEnter("\nPresiona Enter para ver la primera deducción...")
 
-    await this.waitForEnter("\nPresiona Enter para ver la definición práctica...")
+    console.log("\n🔍 Primera deducción:")
+    console.log("• De 'Biblioteca' → contiene LIBROS")
+    console.log("• De 'Digital' → acceso remoto por USUARIOS")
 
-    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...")
-  }
+    await this.waitForEnter("\nPresiona Enter para ver la deducción clave...")
+
+    console.log("\n⚡ Deducción clave:")
+    console.log("• LIBROS + USUARIOS → deben INTERACTUAR")
+    console.log("• ¿Cómo? → préstamos, búsquedas, devoluciones")
+    console.log("\n💡 Conclusión: De 'biblioteca digital' se deduce naturalmente")
+    console.log("   un conjunto de libros y usuarios interactuando")
+
+    await this.waitForEnter("\nPresiona Enter para la segunda definición...")
 
-  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...")
+    console.log("🎯 DEFINICIÓN 2 - Conjunto de cosas con propósito:")
+    console.log("¿Qué elementos relacionados contribuyen al propósito?")
+
+    console.log("\n📖 Elementos del sistema:")
+    console.log("• LIBROS - recursos que se prestan")
+    console.log("• USUARIOS - quienes solicitan préstamos")
+    console.log("• PRÉSTAMOS - relación temporal entre libro y usuario")
+    console.log("• BIBLIOTECA - coordina todo el proceso")
+
+    console.log("\n🎯 Propósito determinado:")
+    console.log("Facilitar el acceso organizado a recursos bibliográficos")
+
+    console.log("\n🔗 Relaciones ordenadas:")
+    console.log("• Usuario solicita → Biblioteca evalúa → Préstamo se crea")
+    console.log("• Libro cambia estado → Usuario recibe acceso → Plazo se establece")
+    console.log("• Vencimiento llega → Usuario devuelve → Libro se libera")
+
+    await this.waitForEnter("\nPresiona Enter para ver la descomposición en objetos...")
   }
 
-  async step4_ObjectIdentification() {
+  async step3_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("Descomposición en objetos:")
+
+    console.log("\nclass Book {")
+    console.log("  constructor(title, author, isbn) {")
+    console.log("    this.title = title")
+    console.log("    this.author = author")
+    console.log("    this.isbn = isbn")
+    console.log("    this.isLoaned = false")
+    console.log("  }")
     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")
+    console.log("  isAvailable() {")
+    console.log("    return !this.isLoaned")
+    console.log("  }")
+    console.log("")
+    console.log("  markAsLoaned() {")
+    console.log("    this.isLoaned = true")
+    console.log("  }")
+    console.log("")
+    console.log("  markAsReturned() {")
+    console.log("    this.isLoaned = false")
+    console.log("  }")
+    console.log("}")
 
-    await this.waitForEnter("\nPresiona Enter para ver las reglas...")
+    await this.waitForEnter("\nPresiona Enter para ver User...")
 
-    console.log("\n📋 PASO 4B: Validar con Reglas Lógicas")
-    console.log("(De la definición teórica - coherencia del discurso)")
+    console.log("\nclass User {")
+    console.log("  constructor(name, email, maxLoans = 3) {")
+    console.log("    this.name = name")
+    console.log("    this.email = email")
+    console.log("    this.maxLoans = maxLoans")
+    console.log("    this.currentLoans = []")
+    console.log("  }")
+    console.log("")
+    console.log("  canBorrow() {")
+    console.log("    return this.currentLoans.length < this.maxLoans")
+    console.log("  }")
     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? ✓")
+    console.log("  addLoan(loan) {")
+    console.log("    this.currentLoans.push(loan)")
+    console.log("  }")
+    console.log("")
+    console.log("  removeLoan(loan) {")
+    console.log("    const index = this.currentLoans.indexOf(loan)")
+    console.log("    if (index > -1) this.currentLoans.splice(index, 1)")
+    console.log("  }")
+    console.log("}")
 
-    await this.waitForEnter("\nPresiona Enter para ver el resultado...")
+    await this.waitForEnter("\nPresiona Enter para ver Loan...")
 
-    console.log("\n🏗️ PASO 4C: Descomposición Resultante")
+    console.log("\nclass Loan {")
+    console.log("  constructor(user, book, durationDays = 14) {")
+    console.log("    this.user = user")
+    console.log("    this.book = book")
+    console.log("    this.startDate = new Date()")
+    console.log("    this.dueDate = new Date(Date.now() + durationDays * 24 * 60 * 60 * 1000)")
+    console.log("    this.returned = false")
+    console.log("  }")
     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("  isOverdue() {")
+    console.log("    return !this.returned && new Date() > this.dueDate")
+    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("  calculateFine() {")
+    console.log("    if (!this.isOverdue()) return 0")
+    console.log("    const daysLate = Math.ceil((new Date() - this.dueDate) / (24 * 60 * 60 * 1000))")
+    console.log("    return daysLate * 5 // $5 por día")
+    console.log("  }")
     console.log("")
-    console.log("class Loan {")
-    console.log("  // Encapsula: fechas, estado, multas")
-    console.log("  isOverdue() → boolean")
-    console.log("  calculateFine() → number")
+    console.log("  returnBook() {")
+    console.log("    this.returned = true")
+    console.log("    this.book.markAsReturned()")
+    console.log("    this.user.removeLoan(this)")
+    console.log("  }")
     console.log("}")
+
+    await this.waitForEnter("\nPresiona Enter para ver Library...")
+
+    console.log("\nclass Library {")
+    console.log("  constructor() {")
+    console.log("    this.books = []")
+    console.log("    this.users = []")
+    console.log("    this.loans = []")
+    console.log("  }")
+    console.log("")
+    console.log("  lendBook(user, book) {")
+    console.log("    if (!user.canBorrow()) return null")
+    console.log("    if (!book.isAvailable()) return null")
+    console.log("")
+    console.log("    const loan = new Loan(user, book)")
+    console.log("    book.markAsLoaned()")
+    console.log("    user.addLoan(loan)")
+    console.log("    this.loans.push(loan)")
+    console.log("    return loan")
+    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("  returnBook(loan) {")
+    console.log("    loan.returnBook()")
+    console.log("    return loan.calculateFine()")
+    console.log("  }")
+    console.log("")
+    console.log("  getOverdueLoans() {")
+    console.log("    return this.loans.filter(loan => loan.isOverdue())")
+    console.log("  }")
     console.log("}")
 
-    await this.waitForEnter("\nPresiona Enter para ver por qué esta descomposición funciona...")
+    await this.waitForEnter("\nPresiona Enter para ver la interacción...")
 
     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...")
+    console.log("Ejemplo de uso:")
+    console.log("")
+    console.log("const library = new Library()")
+    console.log("const book = new Book('1984', 'George Orwell', '978-0451524935')")
+    console.log("const user = new User('Ana García', 'ana@email.com')")
+    console.log("")
+    console.log("// Los objetos interactúan entre sí")
+    console.log("const loan = library.lendBook(user, book)")
+    console.log("console.log(book.isAvailable())  // false")
+    console.log("console.log(user.canBorrow())    // true (2 préstamos disponibles)")
+    console.log("")
+    console.log("// Simular libro vencido")
+    console.log("loan.dueDate = new Date(Date.now() - 24 * 60 * 60 * 1000)")
+    console.log("console.log(loan.isOverdue())    // true")
+    console.log("console.log(loan.calculateFine()) // 5")
+    console.log("")
+    console.log("// Devolver libro")
+    console.log("const fine = library.returnBook(loan)")
+    console.log("console.log(book.isAvailable())  // true")
+
+    await this.waitForEnter("\nPresiona Enter para la conclusión...")
   }
 
   async conclusion() {
@@ -210,33 +232,34 @@ export class Lesson1SystemDecomposition {
     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("\n1️⃣ SISTEMA como totalidad deductiva:")
+    console.log("   • De 'biblioteca digital' se deduce naturalmente: libros + usuarios")
+    console.log("   • Esta deducción revela la interacción fundamental del sistema")
+
+    console.log("\n2️⃣ SISTEMA como conjunto con propósito:")
+    console.log("   • Elementos identificados: Book, User, Loan, Library")
+    console.log("   • Relaciones ordenadas: solicitud → evaluación → préstamo → devolución")
+    console.log("   • Propósito determinado: acceso organizado a recursos")
+
+    console.log("\n⚡ LA PARTE DIFÍCIL:")
+    console.log("¿Cómo decidimos que necesitábamos exactamente estos 4 objetos?")
+    console.log("¿Por qué no 3? ¿Por qué no 10? ¿Cuál es el criterio?")
+
+    console.log("\n🔍 Criterio de descomposición:")
+    console.log("• Book - responsabilidad de estado propio")
+    console.log("• User - responsabilidad de sus límites")
+    console.log("• Loan - responsabilidad de la relación temporal")
+    console.log("• Library - responsabilidad de coordinación")
 
     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.")
+    console.log("• Lección 2: Los objetos interactúan a través de solicitudes")
+    console.log("• Lección 3: Las solicitudes son la única forma de ejecutar operaciones")
+    console.log("• Lección 4-6: Cómo definir esas interacciones correctamente")
+
+    console.log("\n💭 Reflexión:")
+    console.log("La descomposición en objetos es difícil porque requiere identificar")
+    console.log("las responsabilidades naturales que se deducen del sistema.")
 
     await this.waitForEnter("\n✨ ¡Lección 1 completada! Presiona Enter para salir...")
   }

package/package.json

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