Skip to content

Latest commit

 

History

28 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

🎮 Programa de Operación y Simulación de Máquinas

Una biblioteca de cursos técnicos para pilotar, conducir y navegar cualquier máquina.

Validar documentación Verificar enlaces Código: MIT Contenido: CC BY-NC-SA 4.0 Vehículos Ficción Clases Duración Enfoque


Cada tipo de máquina se documenta como un curso estructurado e interconectado: historia, características funcionales, sistemas y mecánica, mandos, principios físicos, entornos de trabajo, reglamentos (con foco en la ley chilena) y diseño de simulación. La meta no es todavía crear juegos, sino ordenar el conocimiento para que cada vehículo pueda convertirse en una simulación coherente, educativa y segura.

ℹ️ Aquí todavía no hay ningún simulador que puedas ejecutar. Esto es la base documental que cualquiera de ellos necesitaría antes de existir. El proyecto se llamó "Multisimulador" durante su arranque, pero ese nombre prometía software funcionando, así que se renombró mientras el código no exista. La clase 9 de cada curso especifica el simulador; construirlo es el paso siguiente.

🎓 Empieza por el curso de referencia: 🏍️ Motocicletas · o revisa la guía de estilo y estructura de curso.


🗺️ Mapa del repositorio

flowchart TD
    Repo[🎮 Programa] --> Docs[📖 docs/<br/>visión, metodología, marco legal]
    Repo --> Plant[🧩 plantillas/<br/>modelos reutilizables]
    Repo --> Veh[🚙 vehículos/<br/>29 cursos]
    Repo --> Man[📚 manuales/<br/>fuentes públicas]
    Repo --> Fic[🌌 vehiculos-fantasticos/<br/>12 naves de ficción]
    Veh --> Tierra[🛞 Terrestres]
    Veh --> Riel[🚆 Ferroviarios]
    Veh --> Mar[⚓ Marítimos]
    Veh --> Aire[✈️ Aéreos]
    Veh --> Espacio[🚀 Espaciales]
    Tierra --> T1[🏍️ Motos · 🚗 Autos · 🏎️ F1 · 🚌 Buses · 🚛 Camiones]
    Tierra --> T2[🏗️ Grúas · 🚜 Tractores · 🚧 Maquinaria · 🪖 Tanques]
    Tierra --> T3[⚓ Grúa portuaria · 🗼 Grúa torre · 🛗 Ascensores]
    Riel --> R1[🚆 Pasajeros · 🚄 Alta velocidad · 🚂 Carga]
    Mar --> M1[🚢 Mercantes · ⛴️ Cruceros · 🛳️ Portaviones]
    Mar --> M2[🛡️ Acorazados · 🌊 Submarinos]
    Aire --> A1[🛩️ Avionetas · 🛫 Pasajeros · ✈️ Combate]
    Aire --> A2[🚁 Helicópteros · 🕹️ Drones]
    Espacio --> E1[🚀 Naves · 🚀 Cohetes · 🛬 Transbordadores · 🛰️ ISS]
    Fic --> F1[🕰️ DeLorean · 🛸 Caza estelar · 🌌 Exploración · 🐙 Nautilus]
    Fic --> F2[🤖 Transformable · 🦅 Halcón · 🏯 SDF-1 · 🌑 Estrella de la Muerte]
    Fic --> F3[🌀 Teletransportador · ⚡ Thunderbird 1 · 📦 Thunderbird 2 · 🚀 Thunderbird 3]
Loading

📚 Catálogo de cursos

Cada vehículo es un curso con 11 clases, desde historia hasta la evaluación integradora. En total existen 451 clases y 502,25 horas nominales (ver guía de curso).

🛞 Terrestres

Curso Descripción Licencia (Chile)
🏍️ Motocicletas Equilibrio, transmisión y dinámica de dos ruedas. Clase C
🚗 Automóviles Dirección, motor, seguridad y tránsito. Clase B
🏎️ Fórmula 1 Monoplaza de competición: aerodinámica y rendimiento. Reglamento FIA
🚌 Buses Transporte de pasajeros y operación profesional. Clase A-3
🚛 Camiones Transporte de carga, simples y articulados. Clase A-4 / A-5
🪖 Tanques Vehículo militar oruga (marco público e histórico). Ejército (Ley 18.948)
🏗️ Grúas Maquinaria automotriz móvil, izaje y estabilidad. Clase D
🚜 Tractores Maquinaria agrícola, toma de fuerza y aperos. Clase D
🚧 Maquinaria de construcción Excavadoras, cargadores, bulldozers y movimiento de tierra. Clase D
⚓ Grúa portuaria Grúa fija de puerto para contenedores y carga. Operador certificado
🗼 Grúa torre Grúa fija de edificio para construcción en altura. Operador certificado
🛗 Ascensores Transporte vertical en edificios: seguridad y mantención. Ley 20.296

🚆 Ferroviarios

Curso Descripción Marco
🚆 Tren de pasajeros Transporte ferroviario de personas, urbano e interurbano. Ferroviario (Chile)
🚄 Tren de alta velocidad Trenes rápidos, aerodinámica y vía dedicada. Ferroviario
🚂 Tren de carga Transporte pesado de mercancías por ferrocarril. Ferroviario

⚓ Marítimos

Curso Descripción Marco
🚢 Barcos mercantes Propulsión naval, gobierno y navegación. DIRECTEMAR / OMI
⛴️ Cruceros Buque de pasajeros, servicios y seguridad. DIRECTEMAR / SOLAS
🛡️ Acorazados Historia y principios (marco público). Armada / CONVEMAR
🛳️ Portaviones Aviación naval e historia (marco público). Armada / CONVEMAR
🌊 Submarinos Flotabilidad e inmersión (marco público). Armada / CONVEMAR

✈️ Aéreos y 🚀 espaciales

Curso Descripción Marco
🛩️ Aviones pequeños Sustentación, instrumentos y navegación aérea. DGAC / OACI
🛫 Aviones de pasajeros Aviación comercial, sistemas y operación de línea. DGAC / ATP
🚁 Helicópteros Vuelo de ala rotatoria, rotor y maniobra. DGAC / DAN 61
🕹️ Drones Aeronaves pilotadas a distancia (RPAS), multirotor y ala fija. DGAC / DAN 151
✈️ Aviones de combate Física del vuelo e historia (marco público). FACH
🚀 Naves espaciales Órbitas, propulsión y soporte vital. Tratados UNOOSA
🚀 Cohetes Lanzadores actuales: etapas, empuje y ascenso. Estado de lanzamiento
🛬 Transbordadores Vehículo espacial reutilizable con reentrada alada. Estado de lanzamiento
🛰️ Estación espacial (ISS) Laboratorio orbital: módulos, soporte vital y microgravedad. Acuerdo internacional

🌌 Naves de ficción (sección educativa)

Una sección aparte y claramente separada de los vehículos reales para explorar la ingeniería imaginaria de la ciencia ficción: que principios físicos reales evocan, cuales rompen y cómo se simularían. Son obras de ficción de sus respectivos autores; ver el aviso en el catálogo de naves de ficción.

Nave Inspiración Idea central
🕰️ DeLorean temporal "Volver al Futuro" Viaje en el tiempo y energía.
🛸 Caza estelar Estilo "Star Wars" Combate espacial y maniobra.
🌌 Nave de exploración Estilo "Star Trek" Viaje interestelar y ciencia.
🐙 Nautilus Julio Verne (dominio público) Submarino visionario del siglo XIX.
🤖 Caza transformable Estilo "Robotech" Aeronave que se transforma.
🦅 Halcón Milenario Estilo "Star Wars" Carguero rápido: empuje, masa y maniobra.
🏯 SDF-1 Estilo "Robotech" Nave-fortaleza gigante: escala y estructura.
🌑 Estrella de la Muerte Estilo "Star Wars" Estación del tamaño de una luna: gravedad y energía.
🌀 Teletransportador Ciencia ficción Teletransportación: información, energía y límites físicos.
⚡ Thunderbird 1 Estilo "Thunderbirds" Vehículo rápido de respuesta: VTOL y velocidad.
📦 Thunderbird 2 Estilo "Thunderbirds" Transporte pesado modular: capacidad de carga.
🚀 Thunderbird 3 Estilo "Thunderbirds" Cohete de rescate espacial: ascenso a órbita.

🧭 Ruta de aprendizaje sugerida

flowchart LR
    F1[🛞 Fase 1<br/>Tierra] --> F2[⚓ Fase 2<br/>Mar]
    F2 --> F3[✈️ Fase 3<br/>Aire]
    F3 --> F4[🚀 Fase 4<br/>Espacio]
Loading

De lo cotidiano a lo complejo. Detalle en docs/06-plan-vehiculos.md.


📖 Documentación general

Documento Contenido
📌 Índice maestro Mapa de todo el repositorio.
🎯 Visión del proyecto Alcance y filosofía.
🔬 Metodología documental Como investigar y redactar.
🎚️ Niveles de realismo De arcade educativo a simulación técnica.
🦺 Seguridad y límites Reglas de contenido responsable.
📖 Glosario general Vocabulario común.
🗓️ Plan de vehículos Orden recomendado.
⚖️ Marco legal (Chile) Normativa por tipo de vehículo.
🎓 Guía de estilo y curso Clases, madurez y navegación.
⚖️ Carga, pasajeros y manejo Hasta qué punto la carga cambia el manejo, por dominio.
🧑‍🏫 Modelo pedagógico Contrato de clase, duración, evaluación y fuentes.

🦺 Principio de seguridad

Documentación orientada a simulación, formación general e investigación histórica. No sustituye entrenamiento certificado, licencias ni manuales oficiales vigentes. Para máquinas militares o de alto riesgo, el repositorio se limita a información pública, principios generales, historia e interfaz de simulación. Ver el SAFETY_DISCLAIMER.md y docs/04-seguridad-y-limites.md.


⚖️ Matriz de licencias

El repositorio sigue siendo público, pero no todo su contenido tiene la misma licencia:

Material Licencia o condición
Código, scripts, workflows y configuración técnica propia MIT
Currículo, clases, instrucciones, ejercicios y metodología propia CC BY-NC-SA 4.0
Manuales, normas, fichas y material de fabricantes o terceros Copyright o licencia original; no se relicencia
Recursos independientes presentes o futuros Registro en ASSET_LICENSES.md

La atribución del material original corresponde a Vladimir Acuña (vladimiracunadev-create). La licencia MIT histórica se conserva y los permisos ya concedidos sobre revisiones anteriores no se revocan. Consulte el historial de licencias, los avisos de terceros y la auditoría.


✅ Validación y calidad

Cada cambio se valida en CI (estructura, enlaces internos, estilo Markdown y seguridad de los workflows). Para validar en local:

# Estructura del repositorio y enlaces internos
python scripts/validar_estructura.py

# Estilo de Markdown (requiere Node)
npx markdownlint-cli2 "**/*.md"

🤝 Cómo contribuir

Lee la guía de contribución y el código de conducta. El historial está en CHANGELOG.md; la seguridad, en SECURITY.md. Las contribuciones técnicas se distribuyen bajo MIT y las educativas bajo CC BY-NC-SA 4.0, con las excepciones descritas en la matriz de licencias.

📊 Estado del proyecto

  • ✅ Base documental, marco legal y CI en verde.
  • Los 41 cursos están estructurados pedagógicamente: 451 clases con explicación técnica propia, pregunta guía, caso resuelto, comprobación, evidencia, criterio de aprobación, fuentes y navegación. Los metadatos administrativos permanecen ocultos y no se presentan como contenido lectivo.
  • 🧑‍🔧 La revisión experta continúa: “estructurado” no significa acreditado ni validado por un fabricante, una autoridad o un centro de formación.
  • 🎓 🏍️ Motos sigue siendo el curso de referencia: es el modelo a imitar al abrir uno nuevo.
  • 📚 Cada carpeta manuales/ tiene un registro propio de fuentes públicas; el registro general mantiene las referencias transversales.

About

🕹️ machine-operator-program · 41 módulos formativos, uno por máquina · 451 clases · 502 h 15 min de aprendizaje · Sistemas, mandos, física, seguridad y simulación con fuentes por clase · Markdown + Python 📚

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages