Black Trigram Documentation - Korean Traditional Martial Arts Game Guide and Manual

📖 Game Overview

Black Trigram is a realistic 2D precision combat game inspired by Korean martial arts philosophy and the I-Ching. The game teaches authentic Korean martial arts through precise anatomical targeting, featuring 70 vital points and 5 unique combat archetypes built with modern web technologies.

🎮 Gameplay Guide

⌨️ Basic Controls

🏃 Movement: WASD or Arrow Keys - Tactical positioning and footwork
⚔️ Techniques: 1–8 (Bagua-based combat techniques)
🛡️ Guard: Spacebar - Defensive stance and blocking
🎯 Vital Strikes: Mouse - Target vital point attacks
🔄 Archetype Switch: Tab - Change between 5 combat types

🩸 Combat Feedback

💥 Impact Effects: Bone contact sounds and visual trauma
🩸 Injury System: Realistic bleeding and damage progression
😵 Incapacitation: Visual indicators of combat effectiveness
⚖️ Balance: Physical stance and vulnerability windows

📚 Architecture & Documentation

Explore Black Trigram's complete architecture and technical documentation:

🔗 Architecture & Design

📐 ARCHITECTURE.md - High-level C4 model, container/component views
📈 FUTURE_ARCHITECTURE.md - Future improvement vision
API Documentation - Detailed API reference

🔗 Combat & Mechanics

🥋 COMBAT_ARCHITECTURE.md - In-depth battleflow, trigram integration, vital-point targeting, and damage pipeline
🗺️ game-design.md - Overall game mechanics, archetype breakdowns, and design decisions
📊 game-status.md - Current progress, feature roadmap, and milestone tracking

🔗 Assets & Media

🖼️ ART_ASSETS.md - Guidelines for sprite sheets, particle textures, color palettes, and UI icons
🎵 AUDIO_ASSETS.md - List of traditional Korean instrument loops, impact SFX, and mixing notes
🎬 VIDEO_ASSETS.md - Black Trigram: The Path of Shadows video content

🔒 CI/CD & Security

🔒 development.md - Comprehensive security measures and development practices
🕷️ ZAP Security Scanning - OWASP ZAP dynamic application security testing
⚡ Lighthouse Performance - Automated performance and accessibility audits
⚡ Lighthouse Performance - Automated performance and accessibility audits
📄 SBOM Generation - Software Bill of Materials for transparency

🔐 Security Architecture

🔐 SECURITY_ARCHITECTURE.md - Security design and implementation patterns
🔐 FUTURE_SECURITY_ARCHITECTURE.md - Advanced security architecture with AI enhancements
🔒 development.md - Security measures and development practices

🔗 Conceptual & Strategic

🧠 MINDMAP.md - Current system component relationships and conceptual architecture
🧠 FUTURE_MINDMAP.md - Evolution roadmap with enhanced capabilities
💼 SWOT.md - Strategic assessment of strengths, weaknesses, opportunities, and threats
💼 FUTURE_SWOT.md - Strategic analysis of future positioning and opportunities

🔗 Data & Processes

📊 DATA_MODEL.md - Current data structures, relationships, and entity frameworks
📊 FUTURE_DATA_MODEL.md - Enhanced data architecture for future iterations
🔄 FLOWCHART.md - Current data processing workflows and business processes
🔄 FUTURE_FLOWCHART.md - Enhanced workflows for future development

🔗 Behavioral Systems

🔄 STATEDIAGRAM.md - Current system state transitions and behavioral models
🔄 FUTURE_STATEDIAGRAM.md - Enhanced adaptive state transitions for future implementation
🔧 WORKFLOWS.md - Current automation processes and CI/CD pipelines
🔧 FUTURE_WORKFLOWS.md - Enhanced CI/CD with advanced capabilities

🔗 Testing & Quality Assurance

🧪 Unit Test Results - Visual representation of unit test results and coverage
📊 Test Coverage - Test coverage reports showing codebase coverage
🔍 E2E Test Reports - End-to-end test reports showing full system validation
🎓 UnitTestPlan.md - Comprehensive unit testing strategy
🎮 E2ETestPlan.md - End-to-end testing strategy

🔗 Performance & Operations

⚡ performance-testing.md - Benchmarks and performance analysis under various conditions
🔄 BCPPlan.md - Comprehensive business continuity planning and recovery strategies
📅 End-of-Life-Strategy.md - Maintenance and end-of-life planning for technology components
📘 API Documentation - Detailed API reference for all components, types, and functions

🎯 Combat Philosophy

"In darkness, seek the perfect strike"
어둠 속에서 완벽한 일격을 찾아라

Each technique's focus:

Precise Targeting - Accurate anatomical vulnerabilities
Maximum Effectiveness - One-strike incapacitation
Combat Psychology - Mental preparation for combat
Traditional Knowledge - Authentic Korean martial arts
Archetype Specialization - Unique approaches per combat type

🎮 Enter the Dojang

🏷️ Project Classification According to Hack23 Framework

Following the Hack23 Classification & Business Continuity Framework guidelines for comprehensive project assessment:

🎯 Project Classification

🔒 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 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.