---

⚡ Combat Mastery

Black Trigram is a realistic combat simulator that teaches authentic Korean martial arts through precise anatomical targeting. Master traditional vital-point techniques via modern 3D combat mechanics powered by Three.js across 5 distinct fighter archetypes.

🎯 Combat Disciplines

🎯 정격자 Jeonggyeokja Precision Striker Every strike targets anatomical weak points

⚔️ 비수 Bisu Lethal Technique Decisive unarmed combat methods

🥷 암살자 Amsalja Shadow Assassin Silent takedown techniques

💀 급소격 Geupsogyeok Vital Point Strike 70 anatomical targets for incapacitation

---

📸 Concept

---

🌟 Authentic Combat Features

🥋 Player Archetypes

Master combat through 5 distinct fighting philosophies:

🎯 Anatomical Targeting System

Master 70 authentic vital points for combat effectiveness:

💪 Realistic Body Mechanics

• 🩸 Authentic Trauma – Realistic injury visualization and blood
• 🦴 Bone Impact Audio – Genuine bone contact and fracture sounds
• 🫁 Breathing Disruption – Respiratory system targeting
• ⚖️ Balance System – Realistic stance and momentum physics
• 🧠 Consciousness States – Progressive awareness impairment
• 😵 Pain Response – Physiological pain affecting performance

🎯 Combat Specializations

• 🎯 Anatomical Precision – 70 target points for tactical advantage
• 🇰🇷 Traditional Korean Arts – Authentic techniques from 태권도, 합기도, 택견
• ⚫ Advanced Techniques – Professional combat methods from 5 distinct archetypes
• 🥋 Combat Application – Real martial arts effectiveness

---

🚀 Technical Excellence

Built for combat realism and authentic simulation:

🎯 Combat Components

• VitalPointTargeter – Interactive anatomical targeting system
• CombatTracker – Real-time damage and status monitoring
• TechniqueCalculator – Precise combat effectiveness calculations
• CombatAnalyzer – Post-match technique analysis
• ThreeJS Renderer – Hardware-accelerated 3D combat visualization

---

🎮 Combat Controls

⌨️ Desktop Input System

• 🏃 Movement: WASD or Arrow Keys – Tactical positioning and footwork
• ⚔️ Techniques: 1–8 (Trigram-based combat techniques)
• 🛡️ Guard: Spacebar – Defensive positioning and blocks
• 🎯 Vital Strike: Mouse – Targeted vital-point attacks
• 🔄 Archetype Switch: Tab – Change between 5 fighter types

📱 Mobile Touch Controls (375x667+ screens)

Virtual Controls (Auto-displayed on screens < 768px width):

• 🕹️ Virtual D-Pad (Bottom-Left) – 8-directional movement control

  • Tap directional buttons for tactical positioning
  • Korean arrow indicators (↑ ↗ → ↘ ↓ ↙ ← ↖)
  • 44px+ touch targets for accessibility

• ⚡ Action Buttons (Bottom-Right)

  • Attack Button (60x60px, Gold ⚡) – Execute current stance technique
  • Block Button (50x50px, Blue 🛡️) – Activate defensive guard

• ☯️ Stance Wheel (Bottom-Center)

  • Tap to expand circular selector (200px diameter)
  • 8 trigram stances (☰ ☱ ☲ ☳ ☴ ☵ ☶ ☷)
  • Korean names: 건 태 리 진 손 감 간 곤

Gesture Controls:

• Swipe Right → – Advance toward opponent
• Swipe Left ← – Retreat from opponent
• Swipe Up ↑ – High attack execution
• Swipe Down ↓ – Low attack execution
• Two-Finger Tap 🤞 – Toggle vital point targeting mode

Haptic Feedback:

• Light vibration (10ms) on D-pad movement and stance selection
• Medium vibration (50ms) on attack execution
• Heavy vibration (100ms) on critical hits and vital point strikes

🩸 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

---

🎭 Training Modules

🎯 해부학 연구 (Anatomical Study)

• 📚 급소학습 (Vital Point Study) – 70 anatomical target points
• 🎯 정밀타격 (Precision Striking) – Accurate targeting techniques
• ⚫ 고급기법 (Advanced Techniques) – Professional combat methods
• 🥋 실전응용 (Practical Application) – Combat effectiveness training

⚔️ 무술 기법 (Martial Techniques)

• 🥋 기본기 (Fundamentals) – Basic striking and positioning
• 🔢 팔괘술 (Eight Trigram Arts) – Traditional Korean combat philosophy
• 🔗 연계기법 (Combination Techniques) – Flowing technique sequences
• 🎯 정밀술 (Precision Arts) – Exact targeting and timing

🥊 실전 훈련 (Combat Training)

• 👤 일대일 (One-on-One) – Single opponent combat simulation
• 🏢 환경전투 (Environmental Combat) – Using surroundings tactically
• 🧘 정신수양 (Mental Cultivation) – Psychological combat preparation
• 🏃 연속대전 (Continuous Combat) – Multiple opponent scenarios

🎭 원형 특화 (Archetype Mastery)

• 🏯 무사도 (Warrior's Way) – Traditional warrior discipline training
• 🥷 암영술 (Shadow Arts) – Stealth and assassination techniques
• 💻 사이버전 (Cyber Warfare) – Tech-enhanced combat methods
• 🕵️ 정보전 (Intelligence Warfare) – Psychological and strategic combat
• ⚡ 거리술 (Street Arts) – Underground survival combat

---

📝 Architecture & Development Insights

Explore in-depth technical analysis and architectural insights about Black Trigram through blog posts by our development team.

⭐ Simon Moon's Architecture Chronicles

Simon Moon reveals the hidden structures and sacred geometry in Black Trigram's architecture through the Law of Fives and numerological patterns.

🥋 Black Trigram Architecture Five Fighters, Sacred Geometry Five fighter archetypes discovered through combat domain analysis. Cultural authenticity meeting mechanical depth with zero backend architecture.

⚔️ Black Trigram Combat System 70 Vital Points & Physics Traditional Korean martial arts mapped to 70 biomechanical vital points. Five collision systems with anatomical precision and respect for cultural tradition.

🥽 Black Trigram Future Vision VR Martial Arts & Immersive Combat Five-year evolution roadmap from immersive 3D fighter to VR martial arts training platform. Korean martial arts preservation through immersive technology.

🔍 George Dorn's Code Analysis

George Dorn provides detailed repository deep-dives based on actual code inspection, not assumptions. Each analysis includes cloned repositories, file counts, dependency reviews, and verified metrics.

💻 Black Trigram Code Analysis Repository Deep-Dive Stack: TypeScript 5.9, React 19, Three.js 0.181, Vite 7 Metrics: 132 TypeScript files, 70 vital points system, 5 fighter archetypes Examined package.json dependencies, explored src/ structure, verified combat system implementation, and reviewed AI integrations.

🎮 Black Trigram Implementation Reality Combat Code: TypeScript vs. Martial Arts Physics George's technical commentary reveals collision detection challenges, performance optimization for 60fps combat, and Easter eggs hidden throughout the codebase. Easter Eggs: Land exactly 23 hits → FNORD victory screen. Konami code unlocks "Hagbard Mode". Health at 23% → UI pulses urgently.

---

📚 Documentation

API Reference

Complete TypeDoc API documentation with Korean martial arts context is available:

📘 View API Documentation

The API documentation includes:

• 📖 Core Types: All enums, interfaces, and type definitions with Korean-English bilingual descriptions
• 🥋 Eight Trigram System: Complete I Ching philosophy and stance mechanics
• 🎯 Vital Point System: All 70 Korean vital points with anatomical details
• ⚔️ Combat System: Combat mechanics, damage calculation, and technique execution
• 👤 Player Archetypes: Detailed descriptions of all 5 fighter types
• 🎨 UI Components: Component usage examples and props documentation
• 🔧 Utilities: Helper functions and system utilities

Key Documentation Sections

• Korean Martial Arts Concepts: Traditional philosophy integrated with modern combat
• I Ching (易經) Integration: How the Eight Trigrams influence combat flow
• Anatomical Targeting: Realistic vital point system based on Korean martial arts
• Combat Calculations: Damage, accuracy, and effectiveness algorithms
• Security Notes: Critical functions with security considerations

Documentation Coverage

• ✅ 100% of core types documented with examples
• ✅ All system classes with comprehensive JSDoc
• ✅ Korean-English bilingual terminology throughout
• ✅ Usage examples for complex functions
• ✅ Philosophy context for martial arts concepts

Validation Approach: Strict TypeDoc validation is enabled (notDocumented: true) to track documentation progress. This generates ~2,250 warnings initially, which are being addressed incrementally. The strict approach ensures all new exports are documented from the start, maintaining high documentation standards as the codebase evolves.

Building Documentation Locally

# Generate TypeDoc documentation
npm run docs

# View documentation
open docs/api/index.html
Copy

---

🔐 Commitment to Transparency and Security

At Hack23 AB, we believe that true security comes through transparency and demonstrable practices. Our Information Security Management System (ISMS) is publicly available, showcasing our commitment to security excellence and organizational transparency.

📋 Public ISMS Repository Complete Information Security Management System documentation

🔒 Information Security Policy Enterprise-grade security framework and governance

📊 ISMS Reference Mapping: For a complete mapping of all ISMS policies referenced by Black Trigram, see ISMS_REFERENCE_MAPPING.md

🏆 Security Through Transparency

Our approach to cybersecurity consulting is built on a foundation of transparent practices:

• 🔍 Open Documentation: Complete ISMS framework available for review
• 📋 Policy Transparency: Detailed security policies and procedures publicly accessible
• 🎯 Demonstrable Expertise: Our own security implementation serves as a live demonstration
• 🔄 Continuous Improvement: Public documentation enables community feedback and enhancement

---

🔧 Development Features

🎯 Anatomical Data Integration

// Authentic vital point data with combat applications
interface VitalPoint {
  name: { korean: string; english: string; technique: string };
  location: AnatomicalPosition;
  effectiveness: CombatEffectiveness;
  difficulty: PrecisionRequired;
  method: CombatTechnique[];
  archetypeBonus: ArchetypeModifier[]; // Special bonuses for different fighter types
}
Copy

🩸 Combat Mechanics System

// Realistic body mechanics for authentic combat
interface CombatState {
  health: number; // Physical condition remaining
  consciousness: number; // Awareness and responsiveness
  pain: number; // Pain levels affecting performance
  balance: CombatStability; // Physical stability in combat
  stamina: number; // Energy and endurance
  technique: number; // Skill and precision level
  archetype: PlayerArchetype; // Current fighter specialization
}

// Player archetype system
type PlayerArchetype = "musa" | "amsalja" | "hacker" | "jeongbo" | "jojik";
Copy

---

🚀 Quick Start

🌐 Enter the Dojang

🎮 Begin Combat Training

🔧 Local Development

# Clone repository
git clone https://github.com/Hack23/blacktrigram.git
cd blacktrigram

# Install dependencies
npm install

# Start combat simulation
npm run dev

# Build for deployment
npm run build

# Run combat testing
npm run test
npm run test:combat
Copy

---

📚 Documentation & Further Reading

Game/frontend will be open source with commercial backend supporting multiplayer functionality, rankings and subscriptions to fund development and runtime of backend. Will enable progressions and persistent state of game.

🔗 Architecture & Design

• 📐 ARCHITECTURE.md High-level C4 models, container/component views, and system context.
• 📈 FUTURE_ARCHITECTURE.md Vision for upcoming architectural enhancements and PWA integration.
• API Docs Detailed API reference for all components, types, and functions in the application.

🔗 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 🌑⚡🗡️ .Scene 1: Initiation Under Neon Skies 🌑🗡️🌆

🔒 CI/CD & Security Features

• 🔒 development.md The development implements comprehensive security measures.
• 🤖 Copilot MCP Setup Model Context Protocol servers for enhanced Copilot capabilities.
• 🛡️ Supply Chain Security - OSSF Scorecard analysis and dependency review
• 🔍 Static Analysis - CodeQL scanning for vulnerabilities
• 📦 Dependency Protection - Automated dependency vulnerability checks
• 🔐 Runner Hardening - All CI/CD runners are hardened with audit logging
• 📋 Security Policies - GitHub security advisories and vulnerability reporting
• 🏷️ Pinned Dependencies - All GitHub Actions pinned to specific SHA hashes
• 📄 SBOM Generation - Software Bill of Materials for transparency
• 🔏 Build Attestations - Cryptographic proof of build integrity
• 🏆 Artifact Verification - SLSA-compliant build provenance
• 🕷️ ZAP Security Scanning - OWASP ZAP dynamic application security testing
• ⚡ Lighthouse Performance - Automated performance and accessibility audits

---

🎯 Combat Philosophy

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

Each technique focuses on:

• 정확한 타격 (Precise Targeting) – Exact anatomical vulnerable points
• 최대 효과 (Maximum Effectiveness) – One-strike incapacitation
• 전투 심리 (Combat Psychology) – Mental preparation for combat
• 전통 지식 (Traditional Knowledge) – Authentic Korean martial arts
• 원형 특화 (Archetype Specialization) – Unique approach per fighter type

---

🏆 Combat Achievements

🎯 Combat Mastery

• 🎓 급소대가 (Vital Point Master) – Master all 70 vital-point targets
• 🩸 전투전문가 (Combat Expert) – Execute optimal combat techniques
• ⚫ 고수 (Advanced Practitioner) – Complete advanced technique training
• 🔪 완벽한 무사 (Perfect Warrior) – Achieve flawless combat records

🥋 Martial Proficiency

• 🎯 정밀타격사 (Precision Striker) – Perfect vital-point targeting accuracy
• ⚖️ 균형대사 (Balance Master) – Master all stance & footwork patterns
• 🧘 정신수양사 (Mental Cultivator) – Complete psychological combat training
• 🇰🇷 무도학자 (Martial Scholar) – Understand Korean martial arts philosophy

🎭 Archetype Mastery

• 🏯 무사완성 (Warrior Perfection) – Master traditional warrior discipline
• 🥷 그림자대사 (Shadow Master) – Perfect stealth & assassination arts
• 💻 사이버무사 (Cyber Warrior) – Tech-enhanced combat mastery
• 🕵️ 정보대가 (Intelligence Master) – Psychological warfare expertise
• ⚡ 거리왕 (Street King) – Underground combat supremacy

---

---

📚 Related Documents

🔐 Security & Compliance

• 🔐 Information Security Policy - Enterprise-grade security framework
• 🛡️ Security Architecture - Complete security implementation
• 🔮 Future Security Architecture - Planned security enhancements
• 🎯 Threat Model - STRIDE analysis and attack trees
• 📋 CRA Assessment - EU Cyber Resilience Act compliance
• 🔒 Security Policy - Vulnerability reporting and disclosure
• 🗺️ ISMS Reference Mapping - Complete ISMS policy mapping

🛠️ Development & Architecture

• 🛠️ Secure Development Policy - Security-integrated SDLC
• 📐 Architecture - High-level system design
• ⚔️ Combat Architecture - Combat system mechanics
• 🔄 Workflows - CI/CD security automation
• 🔧 Development Guide - Security features and testing
• 🏷️ Classification Framework - Business impact analysis

📊 Testing & Quality

• 🧪 Unit Test Plan - Comprehensive unit testing strategy
• 🎯 E2E Test Plan - End-to-end testing documentation
• 🎮 Screen-Specific E2E Strategy - One test per screen (3-4 min each)
• ⚡ Performance Testing - Lighthouse & load testing
• 🔍 Vulnerability Management - Security testing procedures

🎮 Game Design & Assets

• 🎮 Game Design - Overall game mechanics
• 📊 Game Status - Development progress
• 🖼️ Art Assets - Visual asset guidelines
• 🎵 Audio Assets - Sound design documentation
• 🎬 Video Assets - Cinematic content

🌐 ISMS Public Repository

• 🔓 Open Source Policy - Open source governance
• 🤖 AI Policy - AI governance framework
• 🌐 ISMS Transparency Plan - Public disclosure strategy
• 📊 Security Metrics - Performance measurement

---

🥋 Black Trigram Project Classification

🎯 Project Classification

🔒 Security Classification

⏱️ Business Continuity

💰 Business Impact Analysis Matrix

Impact Category	Financial	Operational	Reputational	Regulatory
🔒 Confidentiality
✅ Integrity
⏱️ Availability

🛡️ Security Investment Returns

🎯 Competitive Differentiation

📈 Porter's Five Forces Strategic Impact

---