initial commit

data/README.md

@@ -0,0 +1,113 @@
+# 📚 Datos del Balotario
+
+Este directorio contiene los archivos de datos principales de la aplicación Balotario Licencia A-I.
+
+## 📄 Archivos de Contenido
+
+### `balotario_clase_a_cat_I.md`
+**Archivo principal con las preguntas del balotario**
+
+#### Características:
+- ✅ **200 preguntas oficiales** del MTC Perú
+- ✅ **Formato markdown** estructurado
+- ✅ **Respuestas correctas** marcadas con ✅
+- ✅ **Imágenes incluidas** de señales de tránsito
+- ✅ **Numeración secuencial** del 1 al 200
+
+#### Estructura de cada pregunta:
+```markdown
+### [NÚMERO]
+
+[TEXTO DE LA PREGUNTA]
+
+a) [OPCIÓN A]
+b) [OPCIÓN B]
+✅ c) [OPCIÓN CORRECTA]
+d) [OPCIÓN D]
+
+---
+```
+
+#### Categorías de preguntas:
+- 🚦 **Señales de tránsito** (reglamentarias, preventivas, informativas)
+- 🚗 **Normas de circulación** y preferencia de paso
+- 📋 **Documentos obligatorios** y licencias
+- ⚡ **Límites de velocidad** por tipo de vía
+- ⚖️ **Infracciones y sanciones**
+- 🛡️ **Seguridad vial** y primeros auxilios
+- 🔧 **Mantenimiento vehicular** e inspecciones
+
+## 🔄 Actualización de Contenido
+
+### Fuente Oficial
+- **Origen**: Ministerio de Transportes y Comunicaciones (MTC) del Perú
+- **Tipo**: Balotario oficial para Licencia Clase A - Categoría I
+- **Vigencia**: Actualizado según normativa vigente
+
+### Formato de Imágenes
+Las imágenes de señales se referencian con:
+```markdown
+![](https://sierdgtt.mtc.gob.pe/Content/img-data/img[NÚMERO].jpg)
+```
+
+### Validación de Contenido
+Para verificar la integridad del archivo:
+```bash
+# Contar preguntas
+grep -c "^### [0-9]" data/balotario_clase_a_cat_I.md
+
+# Contar respuestas correctas
+grep -c "✅" data/balotario_clase_a_cat_I.md
+
+# Verificar numeración secuencial
+python test/test_parser.py
+```
+
+## 📊 Estadísticas del Contenido
+
+- **Total preguntas**: 200
+- **Con imágenes**: ~50 preguntas
+- **Categorías principales**: 7
+- **Formato**: Markdown estándar
+- **Encoding**: UTF-8
+- **Tamaño aproximado**: ~150KB
+
+## 🔧 Uso en la Aplicación
+
+El archivo es parseado por `app.py` usando:
+```python
+def parse_markdown_questions():
+    with open(app.config['MARKDOWN_FILE'], 'r', encoding='utf-8') as file:
+        content = file.read()
+    # ... procesamiento
+```
+
+## 🛡️ Respaldo y Versionado
+
+### Recomendaciones:
+- ✅ **Mantener en control de versiones** (Git)
+- ✅ **Crear respaldos** antes de modificaciones
+- ✅ **Validar formato** después de cambios
+- ✅ **Probar parser** con contenido actualizado
+
+### Estructura de respaldo:
+```
+data/
+├── balotario_clase_a_cat_I.md          # Actual
+├── backup/
+│   ├── balotario_2024_10_26.md         # Respaldo por fecha
+│   └── balotario_original.md           # Versión original
+└── README.md                           # Esta documentación
+```
+
+## ⚠️ Notas Importantes
+
+- **No modificar** la estructura de numeración (### 1, ### 2, etc.)
+- **Mantener formato** de opciones (a), b), c), d))
+- **Preservar** el emoji ✅ para respuestas correctas
+- **Validar** URLs de imágenes si se actualizan
+- **Probar** la aplicación después de cambios
+
+---
+
+**Fuente**: Contenido oficial del MTC Perú para examen de Licencia de Conducir Clase A - Categoría I