# 🧠 Black Trigram (흑괘) Concept Map

**Last Updated:** 2026-04-21  
**Product Version:** 0.7.32  
**Status:** Production-Ready

**🔐 ISMS Alignment:** This document follows [Hack23 Secure Development Policy](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Secure_Development_Policy.md) architecture documentation requirements.

## 📚 Related Documentation

<div class="documentation-map">

| Document                            | Focus       | Description                        |
| ----------------------------------- | ----------- | ---------------------------------- |
| **[Architecture](ARCHITECTURE.md)** | 🏗️ C4 Model | C4 model showing system structure  |
| **[Game Design](game-design.md)**   | 🎮 Design   | Korean martial arts game mechanics |
| **[README](README.md)**             | 📖 Overview | Project overview and setup guide   |

</div>

## Korean Martial Arts Core Concepts

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((흑괘 Black Trigram<br/>Korean Combat System))
    🎯 70 Vital Points
      Regional Distribution
        머리 Head 12
          백회혈 Baihui
          인영 Renying
          태양혈 Taiyang
          경동맥 Carotid LETHAL
        몸통 Torso 24
          명문 Mingmen LETHAL
          심장혈 Heart Point
          중완 Zhongwan
          간유 Liver Strike
        팔 Arms 17
          대추 Dazhui
          곡지 Elbow
          합곡 Hegu
        다리 Legs 17
          슬관절 Knee
          족삼리 Zusanli
          태충 Taichong
      Severity Levels 5
        Lethal 4 points
        Critical 18 points
        Major 28 points
        Moderate 16 points
        Minor 4 points
      Categories 7
        Neurological 22
        Skeletal 15
        Joint 12
        Organ 9
        Muscular 7
        Vascular 3
        Respiratory 2
    ☯️ 8 Trigram Stances
      건 Heaven
        Direct Force
        Plus 20 Attack Power
        Taekwondo Ap Seogi
      태 Lake
        Fluid Adaptation
        Plus 15 Speed
        Yusul Flowing
      리 Fire
        Precision Strike
        Plus 25 Crit Chance
        Hapkido Targeting
      진 Thunder
        Explosive Power
        Plus 30 Stun Duration
        Taekwondo Power
      손 Wind
        Continuous Pressure
        Plus 20 Combo Damage
        Taekyon Flow
      감 Water
        Adaptive Counter
        Plus 25 Counter Damage
        Counter Arts
      간 Mountain
        Immovable Defense
        Plus 30 Defense
        Defensive Stance
      곤 Earth
        Grounded Control
        Plus 20 Grapple
        Submission Arts
    👤 5 Archetypes
      무사 Warrior
        Honor Code
        Balanced Stats
        Joint Control
      암살자 Assassin
        Silent Methods
        High Precision
        Nerve Strike
      해커 Hacker
        Tech Enhanced
        VP Knowledge
        Bio Analysis
      정보요원 Agent
        Psychological
        Adaptability
        Pain Compliance
      조직폭력배 Crime
        Survival
        Brutal Force
        Environmental
    🎬 28 Bone Skeleton
      Root PELVIS
        SPINE 3 Bones
          NECK plus HEAD
          SHOULDER L plus R
            ARM L plus R 6 Bones Each
              HAND 7 Poses
        HIP L plus R
          LEG L plus R 5 Bones Each
            FOOT plus TOES
      Hand Poses 7
        FIST 주먹
        KNIFE_HAND 수도
        SPEAR_HAND 관수
        PALM_HEEL 장력
        GRAPPLING 잡기
        OPEN 펴기
        RELAXED 휴식
      Muscle Tension
        Range 0.0 to 1.0
        Visual Bone Glow
        Combat State Based
```

## Player Archetypes & Combat Styles

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Fighter Archetypes))
    무사 Musa
      Traditional Warrior
        Military Background
        Honor Code
        Direct Confrontation
      Preferred Trigrams
        건 Heaven
        진 Thunder
      Techniques
        관절기법 Joint Control
        급소타격 Vital Strikes
        제압술 Submission
    암살자 Amsalja
      Shadow Assassin
        Covert Operations
        Silent Methods
        One Perfect Strike
      Preferred Trigrams
        손 Wind
        감 Water
      Techniques
        무성제압 Silent Takedown
        신경파괴 Nerve Strike
        호흡차단 Respiratory Attack
    해커 Hacker
      Cyber Warrior
        Tech Enhancement
        Data Analysis
        Environmental Control
      Preferred Trigrams
        리 Fire
        태 Lake
      Techniques
        해부학적분석 Anatomical Analysis
        생체역학파괴 Biomech Destruction
        체계적제압 Systematic Control
    정보요원 Intelligence
      Government Agent
        Psychological Warfare
        Strategic Thinking
        Information Control
      Preferred Trigrams
        간 Mountain
        곤 Earth
      Techniques
        고통순응 Pain Compliance
        심리적압박 Psychological Pressure
        정보추출 Information Extraction
    조직폭력배 Crime
      Underground Fighter
        Street Smart
        Brutal Methods
        Survival Instinct
      Preferred Trigrams
        진 Thunder
        감 Water
      Techniques
        환경활용 Environmental Usage
        더러운기법 Dirty Fighting
        생존격투 Survival Combat
```

## Eight Trigram Combat System

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Trigram Combat))
    Heaven 건 ☰
      Direct Force
        Bone Striking
        Structural Damage
        Overwhelming Power
      Combat Effects
        Fractures
        Concussions
        Immediate Trauma
      Audio Design
        Deep Impact
        Crushing Contact
        Bone Resonance
    Lake 태 ☱
      Flowing Techniques
        Joint Manipulation
        Redirection
        Fluid Movement
      Combat Effects
        Dislocations
        Torn Ligaments
        Mobility Loss
      Audio Design
        Joint Popping
        Ligament Stress
        Flow Sounds
    Fire 리 ☲
      Precision Strikes
        Exact Targeting
        Vital Point Focus
        Needle Accuracy
      Combat Effects
        Nerve Damage
        Temporary Paralysis
        Precise Trauma
      Audio Design
        Sharp Impact
        Breath Disruption
        Precision Contact
    Thunder 진 ☳
      Shocking Techniques
        Nerve Disruption
        Electric-like Impact
        Stunning Force
      Combat Effects
        Paralysis
        Muscle Spasms
        Disorientation
      Audio Design
        Sharp Crack
        Neural Impact
        Thunder Resonance
    Wind 손 ☴
      Persistent Pressure
        Continuous Attack
        Gradual Effect
        Sustained Force
      Combat Effects
        Cumulative Pain
        Progressive Damage
        Gradual Incapacitation
      Audio Design
        Sustained Pressure
        Grinding Contact
        Wind Whistle
    Water 감 ☵
      Adaptive Flow
        Counter Techniques
        Escape Methods
        Flow Reversal
      Combat Effects
        Joint Strain
        Ligament Damage
        Position Control
      Audio Design
        Sliding Contact
        Friction Escape
        Water Flow
    Mountain 간 ☶
      Defensive Stance
        Immovable Defense
        Impact Absorption
        Solid Blocking
      Combat Effects
        Bruising
        Deflection
        Protective Control
      Audio Design
        Solid Blocks
        Deflection Impact
        Mountain Echo
    Earth 곤 ☷
      Grounding Techniques
        Takedowns
        Ground Control
        Wrestling Methods
      Combat Effects
        Impact Trauma
        Positional Control
        Ground Dominance
      Audio Design
        Body Impact
        Ground Contact
        Earth Rumble
```

## Realistic Combat Mechanics

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Combat Realism))
    Health System
      Combat Readiness
        100% Full Capability
        80% Light Damage
        60% Moderate Impairment
        40% Heavy Limitation
        20% Critical State
        0% Incapacitated
      Pain Response
        충격통 Shock Pain
        누적외상 Cumulative Trauma
        통증과부하 Pain Overload
        무력화한계 Incapacitation
      Balance States
        준비완료 Ready
        동요상태 Shaken
        취약상태 Vulnerable
        무력상태 Helpless
      Consciousness
        전투각성 Combat Alert
        혼란상태 Disoriented
        기절직전 Stunned
        무의식 Unconscious
    Vital Point System
      70 Target Points
        Anatomical Accuracy
        Traditional Knowledge
        Combat Application
      Point Categories
        Nerve Centers
        Blood Vessels
        Joint Vulnerabilities
        Pressure Points
      Effects
        Temporary Paralysis
        Blood Flow Disruption
        Joint Incapacitation
        Consciousness Loss
    Visual Feedback
      Blood System
        경상출혈 Minor Bleeding
        중등외상 Moderate Trauma
        중상출혈 Severe Bleeding
        점진적손상 Progressive Damage
      Body Response
        통증반응 Pain Reactions
        균형상실 Balance Loss
        무의식상태 Unconsciousness
        손상적응 Injury Adaptation
      Combat Effects
        Realistic Bruising
        Impact Visualization
        Trauma Accumulation
        Recovery Animation
```

## Technical Architecture Mapping

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Technical Stack<br/>Three.js + React 19))
    Frontend Framework
      React 19
        Component Architecture
        Korean UI Components
        Bilingual Support Korean English
        State Management Zustand
      Three.js + @react-three/fiber
        WebGL Acceleration
        60fps Physics
        3D Combat Rendering
        Skeletal Animation
      TypeScript Strict Mode
        Type Safety
        Combat Calculations
        Korean Interfaces
        Error Prevention
    Game Engine Systems
      Combat System
        CombatSystemController
        Damage Calculations
        Vital Point Logic 70
        Physics Simulation
        Polygon Hit Detection
      Trigram System
        StanceManager 8 Stances
        TrigramCalculator
        TransitionCalculator
        KoreanCulture
        KoreanTechniques
      Vital Point System
        VitalPointSystem 70 Targets
        KoreanAnatomy
        AnatomicalRegions 7 Categories
        Severity Classification 5 Levels
        HitDetection Polygon Based
      Animation System
        Skeletal System 28 Bones
        Hand Pose Manager 7 Poses
        Muscle Tension Visualization
        Technique Animation Keyframes
        Breathing Animation
      Player System
        Archetype Management 5 Types
        Resource Tracking Ki Stamina
        Body Part Health 8 Parts
        Pain Response
        Consciousness Levels
      AI System
        Combat Behaviors
        Archetype Specific AI
        Difficulty Scaling
        Pattern Recognition
    Audio Engine
      Web Audio API
        Spatial Audio 3D
        Damage Based Feedback
        Korean Traditional Instruments
        Cyberpunk SFX
      Audio Categories
        Combat Impact Sounds
        Bone Crack Effects
        Vital Point Strikes
        Stance Transitions
        Breathing Sounds
        Ambient Dojang
      Howler.js Integration
        Sound Pool Management
        Volume Controls
        Cached Playback
        Format Support .mp3 .ogg .webm .aac auto-detection
    3D Rendering
      Three.js Scene
        Camera Setup
        Lighting System
        Environment Dojang
        Post Processing
      Character Rendering
        Skeletal Mesh 28 Bones
        Material Shaders
        Muscle Visualization
        Damage Visualization
      Visual Effects
        Particle Systems
        Hit Effects
        VP Strike Glow
        Motion Blur
        Screen Shake
    Performance Optimization
      60fps Target
        Frame Budget 16.67ms
        Draw Call Optimization
        Instancing
        LOD System
      Memory Management
        Asset Pooling
        Texture Atlasing
        Geometry Sharing
        Garbage Collection
      Loading Strategy
        Progressive Loading
        Asset Caching IndexedDB
        Lazy Loading
        Code Splitting
```

## Game Modes & Learning Path

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Game Modes))
    해부학 연구 Anatomical Study
      Vital Point Learning
        70 Point System
        Location Training
        Effect Understanding
      Precision Training
        Targeting Practice
        Accuracy Development
        Timing Mastery
      Advanced Techniques
        Professional Methods
        Combat Applications
        Realistic Scenarios
    무술 기법 Martial Techniques
      Basic Fundamentals
        Stance Training
        Strike Practice
        Movement Patterns
      Trigram Arts
        8 Traditional Styles
        Philosophy Integration
        Combat Application
      Combination Training
        Technique Chains
        Flow Development
        Advanced Sequences
    실전 훈련 Combat Training
      One-on-One Combat
        Single Opponent
        Realistic Physics
        Full Contact Simulation
      Environmental Combat
        Tactical Positioning
        Surroundings Usage
        Adaptive Strategy
      Multiple Opponents
        Multi-Attacker Scenarios
        Survival Techniques
        Endurance Training
    정신 수양 Mental Cultivation
      Pain Tolerance
        Resistance Building
        Endurance Training
        Mental Fortitude
      Combat Focus
        Concentration Practice
        Pressure Handling
        Awareness Training
      Traditional Philosophy
        I Ching Principles
        Korean Heritage
        Martial Arts Ethics
```

## Cultural Authenticity Framework

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Cultural Authenticity))
    Korean Language
      Noto Sans KR
        Traditional Typography
        Proper Rendering
        Cultural Accuracy
      Terminology
        Authentic Names
        Traditional Terms
        Combat Language
      Dual Language
        Korean Primary
        English Translation
        Cultural Context
    Visual Design
      Traditional Colors
        Korean Red
        Gold Accents
        Black Backgrounds
        Cyan Highlights
      Dojang Environment
        Training Hall
        Traditional Elements
        Cultural Symbols
        Authentic Atmosphere
      Trigram Symbols
        I Ching Characters
        Traditional Unicode
        Proper Placement
        Cultural Meaning
    Historical Accuracy
      Martial Arts Heritage
        Traditional Techniques
        Historical Context
        Cultural Significance
      Combat Methods
        Authentic Applications
        Traditional Knowledge
        Cultural Respect
      Educational Value
        Real Learning
        Cultural Understanding
        Traditional Wisdom
```

## Development & Quality Assurance

```mermaid
%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
mindmap
  root((Development))
    Code Quality
      TypeScript Strict
        Type Safety
        Interface Design
        Error Prevention
      Testing Strategy
        Unit Tests
        Integration Tests
        E2E Testing
      Performance
        60fps Target
        Memory Management
        Load Optimization
    Testing Focus
      Combat Mechanics
        Damage Calculations
        Physics Accuracy
        Technique Validation
      Korean Content
        Text Rendering
        Cultural Accuracy
        Terminology Validation
      Audio System
        Damage Scaling
        Korean Themes
        Spatial Positioning
    Cultural Validation
      Native Review
        Korean Language
        Cultural Accuracy
        Traditional Knowledge
      Martial Arts Consultation
        Technique Authenticity
        Historical Accuracy
        Combat Realism
      Educational Standards
        Learning Objectives
        Cultural Respect
        Traditional Values
```

This mindmap provides a comprehensive overview of the Black Trigram project, covering Korean martial arts philosophy, combat mechanics, player archetypes, technical architecture, and cultural authenticity requirements. It serves as a visual guide for understanding the interconnected concepts that make up this authentic Korean martial arts combat simulator.

---

**흑괘의 길을 걸어라** - _Walk the Path of the Black Trigram through Conceptual Understanding_

This mindmap provides a comprehensive visual guide to Black Trigram's Korean martial arts combat system, covering 70 vital points (급소), 8 trigram stances (팔괘), 5 player archetypes (오대 무사), 28-bone skeletal animation system, and Three.js + React 19 technical architecture. It serves as an authoritative reference for understanding the interconnected concepts that make up this authentic Korean martial arts combat simulator.

---

**📋 Document Control:**  
**✅ Approved by:** James Pether Sörling, CEO  
**📤 Distribution:** Public  
**🏷️ Classification:** [![Confidentiality: Public](https://img.shields.io/badge/C-Public-lightgrey?style=flat-square&logo=shield&logoColor=black)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#confidentiality-levels) [![Integrity: Moderate](https://img.shields.io/badge/I-Moderate-yellow?style=flat-square&logo=check-circle&logoColor=black)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#integrity-levels) [![Availability: Standard](https://img.shields.io/badge/A-Standard-lightgreen?style=flat-square&logo=server&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md#availability-levels)  
**📅 Effective Date:** 2026-04-21  
**⏰ Next Review:** 2026-10-21  
**🎯 Framework Compliance:** [![ISO 27001](https://img.shields.io/badge/ISO_27001-2022_Aligned-blue?style=flat-square&logo=iso&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md) [![NIST CSF 2.0](https://img.shields.io/badge/NIST_CSF-2.0_Aligned-green?style=flat-square&logo=nist&logoColor=white)](https://github.com/Hack23/ISMS-PUBLIC/blob/main/CLASSIFICATION.md)
