Documentación de Black Trigram Español

Guía completa del simulador de combate de precisión de artes marciales tradicionales coreanas

GitHub Release License OpenSSF Scorecard CII Best Practices SLSA 3 Scorecard supply-chain security Test & Report Lines of Code Quality Gate Status Security Rating Maintainability Rating Reliability Rating FOSSA Status

📖 Descripción del Juego

Black Trigram es un juego de combate de precisión 3D realista inspirado en la filosofía de las artes marciales coreanas y el I-Ching. El juego enseña artes marciales coreanas auténticas mediante la focalización anatómica precisa, con 70 puntos vitales y 5 arquetipos de combate únicos construidos con tecnologías web modernas.

🎮 Guía de Juego

⌨️ Controles Básicos

  • 🏃 Movimiento: WASD o teclas de dirección - Posicionamiento táctico y juego de pies
  • ⚔️ Técnicas: 1–8 (técnicas de combate basadas en Bagua)
  • 🛡️ Guardia: Barra espaciadora - Postura defensiva y bloqueo
  • 🎯 Golpes vitales: Ratón - Ataques a puntos vitales
  • 🔄 Cambio de arquetipo: Tab - Cambiar entre 5 tipos de combate

🩸 Retroalimentación de Combate

  • 💥 Efectos de impacto: Sonidos de contacto óseo y trauma visual
  • 🩸 Sistema de lesiones: Sangrado realista y progresión de daño
  • 😵 Incapacitación: Indicadores visuales de eficacia en combate
  • ⚖️ Equilibrio: Postura física y ventanas de vulnerabilidad

📚 Arquitectura y Documentación

Explore la arquitectura completa y la documentación técnica de Black Trigram:

🔗 Arquitectura y Diseño

🔗 Combate y Mecánicas

🔗 Recursos y Medios

  • 🖼️ ART_ASSETS.md - Directrices para hojas de sprites, texturas de partículas, paletas de colores e iconos de UI
  • 🎵 AUDIO_ASSETS.md - Lista de bucles de instrumentos tradicionales coreanos, efectos de sonido de impacto y notas de mezcla
  • 🎬 VIDEO_ASSETS.md - Contenido de vídeo de Black Trigram: El Camino de las Sombras

🔒 CI/CD y Seguridad

  • 🔒 development.md - Medidas de seguridad integrales y prácticas de desarrollo
  • 🕷️ Escaneo de Seguridad ZAP - Pruebas dinámicas de seguridad de aplicaciones OWASP ZAP
  • ⚡ Rendimiento Lighthouse - Auditorías automatizadas de rendimiento y accesibilidad
  • 📄 Generación de SBOM - Lista de materiales de software para transparencia

🔐 Arquitectura de Seguridad

🔗 Conceptual y Estratégico

  • 🧠 MINDMAP.md - Relaciones actuales de componentes del sistema y arquitectura conceptual
  • 🧠 FUTURE_MINDMAP.md - Hoja de ruta de evolución con capacidades mejoradas
  • 💼 SWOT.md - Evaluación estratégica de fortalezas, debilidades, oportunidades y amenazas
  • 💼 FUTURE_SWOT.md - Análisis estratégico de posicionamiento y oportunidades futuras

🔗 Datos y Procesos

🔗 Sistemas de Comportamiento

🔗 Pruebas y Aseguramiento de Calidad

🔗 Rendimiento y Operaciones

🛡️ Modelo de Amenazas Basado en Evidencias

Análisis integral de amenazas STRIDE con consideraciones de seguridad específicas para juegos, enfoque en la protección del patrimonio cultural y análisis especializado para plataformas de juegos educativos.

Modelo de Amenazas: Documentación Pública Seguridad de Juegos: Análisis Especializado Patrimonio Cultural: Enfoque de Protección

🏛️ Implementación de Evaluación CRA

Evaluación completa de cumplimiento de la Ley de Ciber Resiliencia (CRA) para plataforma educativa de juegos de artes marciales coreanas, demostrando alineación regulatoria para software de preservación cultural.

Evaluación CRA: Completa Clasificación: OSS Estándar Gestión de Vulnerabilidades: Implementada

🎯 Filosofía de Combate

"En la oscuridad, busca el golpe perfecto"

어둠 속에서 완벽한 일격을 찾아라

El enfoque de cada técnica:

🏷️ Clasificación del Proyecto Según el Marco de Hack23

Siguiendo las directrices del Marco de Clasificación y Continuidad del Negocio de Hack23 para una evaluación integral del proyecto:

🎯 Clasificación del Proyecto

🔒 Security Classification

⏱️ Business Continuity

🛡️ Security Investment Returns

🎯 Competitive Differentiation

📈 Porter's Five Forces Strategic Impact

💰 Business Impact Analysis Matrix

Comprehensive assessment of potential business impacts across the CIA triad (Confidentiality, Integrity, Availability):

Impact CategoryFinancialOperationalReputationalRegulatory
🔒 ConfidentialityFinancial: NegligibleOperational: NegligibleReputational: LowRegulatory: Negligible
✅ IntegrityFinancial: NegligibleOperational: ModerateReputational: ModerateRegulatory: Negligible
⏱️ AvailabilityFinancial: NegligibleOperational: LowReputational: LowRegulatory: Negligible

This classification demonstrates Black Trigram's strategic positioning as a competitive educational gaming platform with moderate integrity requirements and standard operational expectations. The assessment guides development priorities and resource allocation for optimal game experience delivery.