๐ 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
๐ก๏ธ Evidence-Based Threat Model
Comprehensive STRIDE threat analysis with gaming-specific security considerations, cultural heritage protection focus, and specialized analysis for educational gaming platforms.
๐๏ธ CRA Assessment Implementation
Complete Cyber Resilience Act (CRA) compliance assessment for educational Korean martial arts gaming platform, demonstrating regulatory alignment for cultural preservation software.
๐ฏ 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
๐ท๏ธ Project Classification According to Hack23 Framework
Following the Hack23 Classification & Business Continuity Framework guidelines for comprehensive project assessment:
๐ฏ Project Classification
๐ Security Classification
โฑ๏ธ Business Continuity
-lightgreen?style=for-the-badge&logo=clock&logoColor=white){kind=icon}
-lightblue?style=for-the-badge&logo=database&logoColor=white){kind=icon}
๐ก๏ธ 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.