Files
driving-academy/data/README.md
2025-10-26 23:39:49 -05:00

3.2 KiB

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

### [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:

![](https://sierdgtt.mtc.gob.pe/Content/img-data/img[NÚMERO].jpg)

Validación de Contenido

Para verificar la integridad del archivo:

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

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