El Reino de los Mortales

Midgard es donde viven las aplicaciones terminadas — herramientas estables y puestas a prueba forjadas en el fuego de Muspelheim y templadas para el uso diario. Tres aplicaciones CLI con estética de fantasía oscura, todas impulsadas por SQLite y Rich.

El Reino de los Humanos

En la cosmología nórdica, Midgard es el reino de los mortales — el mundo donde la gente vive, trabaja y construye. En Yggdrasil, cumple el mismo propósito: aquí es donde residen las aplicaciones personales. Cada app aquí es estable, probada y mantenida. Sin experimentos. Sin prototipos. Solo herramientas que se han ganado su lugar.

᛭ Reglas de Midgard

• Los proyectos llegan a Midgard solo después de sobrevivir a Muspelheim (desarrollo activo) o madurar desde Alfheim (prototipo UI) o Vanaheim (agente IA).
• Todas las apps de Midgard son CLI-first, respaldadas por SQLite, y usan Rich para una estética de terminal de fantasía oscura.
• Cada app es independiente — sin dependencias de Asgard (core) más allá de la API pública. Instalar, ejecutar, listo.
• Si una app muere, es enterrada en Helheim junto con sus lecciones.

Arsenal de Midgard

Tres herramientas. Tres propósitos. Todas forjadas con la misma filosofía: local-first, cero configuración, estética de fantasía oscura.

ᚠ Finanzas — Rastreador de Finanzas Personales

Rastrea ingresos, gastos y presupuestos con salida CLI estilo rúnico. Persistencia respaldada por SQLite, informes mensuales, categorización con colores mnemotécnicos y exportación CSV/JSON. Cada moneda cuenta en el reino de los mortales.

• Añadir gastos e ingresos con categorías
• Informes de balance mensual (tabla o CSV)
• Rastreo de presupuesto con advertencias visuales
• Categorías predefinidas con colores mnemotécnicos
• Exportación a JSON y CSV
• Persistencia SQLite — cero configuración

$ python3 midgard_finanzas.py add 150 comida --desc "Almuerzo"
$ python3 midgard_finanzas.py balance --mes 2025-05
$ python3 midgard_finanzas.py report --mes 2025-05 --format table

Etiquetas: Activo · SQLite · Rich · CLI

---

ᚲ Hábitos — Rastreador de Hábitos

Construye disciplina con runas de fuego. Rastrea hábitos diarios y semanales, visualiza rachas con símbolos rúnicos y archiva lo que ya no te sirve (enviándolo a Helheim). Cada registro es una runa forjada en el fuego del compromiso.

• Frecuencias diarias, semanales y N/semana
• Rastreo de rachas con visualización rúnica (ᚠ)
• Estadísticas semanales y mensuales
• Archivar hábitos a Helheim
• Progreso de 7 días con símbolos rúnicos
• Persistencia SQLite — cero configuración

$ python3 midgard_habits.py add "Meditar" --freq diario --icon 🧘
$ python3 midgard_habits.py check Meditar
$ python3 midgard_habits.py streak Meditar
$ python3 midgard_habits.py stats --semana

Etiquetas: Activo · SQLite · Rich · CLI

---

ᚺ Recetas — Gestor de Recetas (Grimorio)

Un grimorio para tus recetas. Almacena, busca y organiza recetas con salida en formato pergamino. Planifica comidas semanales, genera listas de compras automáticamente y exporta recetas como markdown estilo pergamino o JSON.

• Añadir recetas con ingredientes, pasos, etiquetas
• Dificultad calificada con runas nórdicas (ᚱ a ᛏᛏᛏ)
• Planificación semanal de comidas
• Listas de compras generadas automáticamente
• Búsqueda de texto completo en nombres e ingredientes
• Persistencia SQLite — cero configuración

$ python3 midgard_recipes.py add "Estofado de Dragón" --time 60 --difficulty dificil
$ python3 midgard_recipes.py list
$ python3 midgard_recipes.py plan --days 7

Etiquetas: Activo · SQLite · Rich · CLI

Forjadas en el Mismo Fuego

Cada app de Midgard comparte el mismo ADN. Local-first, CLI nativo y hermoso en la terminal.

Característica	Descripción
ᛒ Persistencia SQLite	Sin bases de datos externas. Sin servidores. Cada app crea su propio archivo .db en la primera ejecución. Cero configuración requerida.
ᛗ UI de Terminal Rich	Paneles estilizados, tablas y encabezados rúnicos vía la librería Rich. Cada app se siente como un grimorio de fantasía oscura — no como una hoja de cálculo aburrida.
ᚦ CLI Argparse	Interfaces completas de subcomandos con --help en todo. Banderas, argumentos posicionales y valores predeterminados sensatos. Componible y programable.
ᛏ Probado (>20 cada uno)	Cada app se envía con >20 casos de prueba de pytest que cubren CRUD, casos límite y análisis de argumentos CLI. Ejecuta pytest tests/ -v y verifica.
ᛉ Cero Dependencias Externas	Solo rich y la biblioteca estándar de Python. Sin ORM, sin framework web, sin SDK en la nube. Instala pip install rich y estarás funcionando.
ᛃ Nativo de Yggdrasil	Construido para vivir dentro de los Nueve Reinos. Nombres de fantasía oscura, estética rúnica y patrones arquitectónicos que coinciden con la mitología del ecosistema.

Inicio Rápido

Clona el repositorio, instala Rich y comienza a rastrear tu vida. Cada app está contenida en su propio directorio.

$ git clone https://github.com/BrierAinz/Yggdrasil.git
$ cd Yggdrasil/Midgard
$ pip install rich

# Finanzas — rastrea tu oro
$ cd finanzas && python3 midgard_finanzas.py balance

# Hábitos — forja tu disciplina
$ cd habits && python3 midgard_habits.py stats --semana

# Recetas — gestiona tu grimorio
$ cd recipes && python3 midgard_recipes.py list

ᛏ Bases de Datos Autónomas

Las tres apps usan bases de datos SQLite que se crean automáticamente en la primera ejecución. Sin comandos de migración, sin scripts de configuración.

Las pruebas viven en el directorio tests/ de cada app. Ejecuta python3 -m pytest tests/ -v desde dentro de la carpeta de cualquier app.

Salud de Midgard

Las tres aplicaciones son estables y se mantienen activamente.

Aplicación	Tipo	Estado	Pruebas
finanzas	Rastreador de Finanzas	ᛏ Activo	>20 casos
habits	Rastreador de Hábitos	ᛏ Activo	>20 casos
recipes	Gestor de Recetas	ᛏ Activo	>20 casos