📖 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
- 📐 ARCHITECTURE.md - Modelo C4 de alto nivel, vistas de contenedores/componentes
- 📈 FUTURE_ARCHITECTURE.md - Visión de mejoras futuras
- Documentación de la API - Referencia detallada de la API
🔗 Combate y Mecánicas
- 🥋 COMBAT_ARCHITECTURE.md - Flujo de batalla detallado, integración de trigramas, focalización de puntos vitales y canalización de daño
- 🗺️ game-design.md - Mecánicas generales del juego, desglose de arquetipos y decisiones de diseño
- 📊 game-status.md - Progreso actual, hoja de ruta de características y seguimiento de hitos
🔗 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
- 🔐 SECURITY_ARCHITECTURE.md - Diseño de seguridad y patrones de implementación
- 🔐 FUTURE_SECURITY_ARCHITECTURE.md - Arquitectura de seguridad avanzada con mejoras de IA
- 🔒 development.md - Medidas de seguridad y prácticas de desarrollo
🔗 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
- 📊 DATA_MODEL.md - Estructuras de datos actuales, relaciones y marcos de entidades
- 📊 FUTURE_DATA_MODEL.md - Arquitectura de datos mejorada para futuras iteraciones
- 🔄 FLOWCHART.md - Flujos de trabajo de procesamiento de datos y procesos de negocio actuales
- 🔄 FUTURE_FLOWCHART.md - Flujos de trabajo mejorados para el desarrollo futuro
🔗 Sistemas de Comportamiento
- 🔄 STATEDIAGRAM.md - Transiciones de estado actuales del sistema y modelos de comportamiento
- 🔄 FUTURE_STATEDIAGRAM.md - Transiciones de estado adaptativas mejoradas para implementación futura
- 🔧 WORKFLOWS.md - Procesos de automatización actuales y pipelines CI/CD
- 🔧 FUTURE_WORKFLOWS.md - CI/CD mejorado con capacidades avanzadas
🔗 Pruebas y Aseguramiento de Calidad
- 🧪 Resultados de Pruebas Unitarias - Representación visual de resultados y cobertura de pruebas unitarias
- 📊 Cobertura de Pruebas - Informes de cobertura de pruebas del código fuente
- 🔍 Informes de Pruebas E2E - Informes de pruebas de extremo a extremo con validación completa del sistema
- 🎓 UnitTestPlan.md - Estrategia integral de pruebas unitarias
- 🎮 E2ETestPlan.md - Estrategia de pruebas de extremo a extremo
🔗 Rendimiento y Operaciones
- ⚡ performance-testing.md - Pruebas de referencia y análisis de rendimiento bajo diversas condiciones
- 🔄 BCPPlan.md - Plan integral de continuidad del negocio y estrategias de recuperación
- 📅 End-of-Life-Strategy.md - Planificación de mantenimiento y fin de vida de componentes tecnológicos
- 📘 Documentación de la API - Referencia detallada de la API para todos los componentes, tipos y funciones
🎯 Filosofía de Combate
"En la oscuridad, busca el golpe perfecto"
어둠 속에서 완벽한 일격을 찾아라
El enfoque de cada técnica:
- Puntería Precisa - Vulnerabilidades anatómicas precisas
- Máxima Efectividad - Incapacitación de un solo golpe
- Psicología de Combate - Preparación mental para el combate
- Conocimiento Tradicional - Artes marciales coreanas auténticas
- Especialización por Arquetipo - Enfoques únicos por tipo de combate
🏷️ 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:
💰 Business Impact Analysis Matrix
Comprehensive assessment of potential business impacts across the CIA triad (Confidentiality, Integrity, Availability):
| Impact Category | Financial | Operational | Reputational | Regulatory |
|---|---|---|---|---|
| 🔒 Confidentiality | ||||
| ✅ Integrity | ||||
| ⏱️ Availability |
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.
