BrailleConverter

Aplicación nativa para macOS que convierte documentos de texto a formato braille (.bra) compatible con impresoras braille estándar.

📖 Descripción

BrailleConverter es una herramienta profesional diseñada para facilitar la conversión de documentos digitales al sistema braille, haciendo la información accesible para personas con discapacidad visual. La aplicación genera archivos .bra con el formato exacto requerido por las impresoras braille estándar.

🎯 Objetivos Principales

• ✅ Soporte para múltiples formatos de documento (TXT, Markdown, Word, PDF)
• ✅ Traducción braille bilingüe (Español e Inglés)
• ✅ Generación de archivos .bra con formato 40×25 (caracteres × líneas)
• ✅ División automática en tomos para documentos largos
• ✅ 100% accesible con VoiceOver
• ✅ Uso de Liblouis como motor de traducción braille oficial

🔧 Requisitos Técnicos

• macOS: 14.0 (Sonoma) o superior
• Xcode: 15.0 o superior
• Swift: 5.9+
• Liblouis: Motor de traducción braille

🛠 Stack Tecnológico

• Swift 5.9+ - Lenguaje de programación
• SwiftUI 4.0+ - Framework de interfaz declarativa
• Combine - Programación reactiva
• AppKit - Funcionalidades específicas de macOS
• Liblouis - Motor de traducción braille (estándar de la industria)

📐 Arquitectura

El proyecto sigue los principios de Clean Architecture combinado con MVVM para garantizar:

• Separación clara de responsabilidades
• Código testeable y mantenible
• Independencia de frameworks
• Escalabilidad

Estructura de Capas

BrailleConverter/
├── App/                    # Punto de entrada de la aplicación
├── Presentation/           # UI (Views, ViewModels, UIModels)
├── Domain/                 # Lógica de negocio (UseCases, Entities, Protocols)
├── Data/                   # Implementaciones (Parsers, BrailleEngine, Writers)
├── Core/                   # Utilidades compartidas (Extensions, Constants, Errors)
└── Resources/              # Recursos (Tablas Braille, Localizaciones)

📋 Especificaciones Braille

Formato de Salida (.bra)

• 40 caracteres por línea braille (máximo estricto)
• 25 líneas por página braille
• 100-150 páginas por tomo (recomendado)

Tablas Braille Soportadas

• Español: es-g1.ctb (Grado 1)
• Inglés: en-ueb-g1.ctb (UEB Grado 1)

🚀 Características Planificadas

• Estructura del proyecto con Clean Architecture
• Integración con Liblouis
• Parser de documentos TXT y Markdown
• Parser de documentos Word y PDF
• Motor de conversión braille
• Sistema de formato 40×25
• Gestión de volúmenes/tomos
• Interfaz de usuario con drag & drop
• Detección automática de idioma
• Numeración de páginas braille
• Exportación de archivos .bra
• Soporte completo de VoiceOver

📝 Estado Actual

Versión: 1.0.0 (En desarrollo) Ticket Actual: #001 - Configuración inicial del proyecto ✅

🤝 Contribución

Este es un proyecto en desarrollo activo. La estructura actual permite:

• Añadir nuevos parsers de documentos fácilmente
• Extender tablas braille soportadas
• Implementar nuevas características de forma modular

📄 Licencia

[Por definir]

👥 Autor

Alberto Martinez

---

Nota: Este proyecto utiliza Liblouis, el estándar de la industria para traducción braille, usado por sistemas validados como odt2braille.