# 📚 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