114 lines
3.2 KiB
Markdown
114 lines
3.2 KiB
Markdown
# 📚 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
|
|
|
|
```
|
|
|
|
### 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
|