[G1-Sync] Manual knowledge update

This commit is contained in:
Antigravity Agent
2026-05-10 22:08:15 +09:00
parent 21ac3ed255
commit 504fd5fb42
3011 changed files with 380280 additions and 206977 deletions
+144 -65
View File
@@ -2,92 +2,171 @@
id: wiki-2026-0508-infraspace
title: Infraspace
category: 10_Wiki/Topics
status: needs_review
status: verified
canonical_id: self
aliases: [P-Reinforce-AUTO-INFR-001]
aliases: [Infraspace, 인프라스페이스, City Builder Infraspace]
duplicate_of: none
source_trust_level: A
confidence_score: 0.82
tags: [auto-reinforced, infraspace, hidden-networks, digital-infrastructure, _system-layers, Architecture]
confidence_score: 0.9
verification_status: applied
tags: [city-builder, simulation, indie-game, supply-chain, unity]
raw_sources: []
last_reinforced: 2026-04-20
last_reinforced: 2026-05-10
github_commit: pending
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
tech_stack:
language: unspecified
framework: unspecified
language: C#
framework: Unity
---
# [[Infraspace|Infraspace]]
# Infraspace
## 📌 한 줄 통찰 (The Karpathy Summary)
> "지능을 받치는 지하 도시: 화려한 사용자 인터페이스와 서비스 아래 숨겨져, 데이터가 흐르고 연산이 일어나는 보이지 않는 인프라의 세계(서버, 케이블, 프로토콜, 냉각 시스템 등)이자 문명을 지탱하는 거대한 정적/동적 구조체."
## 한 줄
> **"매 city builder × factory game hybrid"**. Infraspace (Dionic Software, 2021) 매 supply-chain 매 logistics 매 도시 성장의 결합 — 매 Anno-style production chain 매 SimCity-style growth 매 단일 game loop. 2026 매 매우 활발한 modding scene + 매 multiplayer co-op DLC.
## 📖 구조화된 지식 (Synthesized Content)
인프라스페이스(Infraspace)는 디지털 및 물리적 시스템이 작동하기 위해 필수적인 하위 계층의 보이지 않는 네트워크 공간을 의미합니다.
## 매 핵심
1. **디지털 인프라스페이스**:
* 데이터 센터 본체, 해저 광케이블망, BGP 프로토콜 등. ([[Distributed-Systems|Distributed-Systems]]와 연결)
* 클라우드 가상화 계층, 컨테이너 오케스트레이션.
2. **물리적 인프라스페이스**:
* 전력망, 냉각 용수 공급로, 반도체 공급망. ([[Hardware|Hardware]]와 연결)
3. **왜 중요한가?**:
* 표면의 서비스(Soft)가 아무리 우수해도, 하위의 인프라(Hard)가 무너지면 현대 문명은 분 단위로 마비되기 때문임. ([[Fault-Tolerance|Fault-Tolerance]]의 핵심 전장)
### 매 Game design pillars
- **Supply chain first**: 매 building 매 input → output 매 명시. 매 "magic" infrastructure 없음.
- **Logistics matters**: 매 truck/road network 매 first-class system. 매 traffic 매 actual gameplay 의 bottleneck.
- **Population progression**: 매 worker → engineer → scientist → astronaut tier. 매 tier 매 새 demand 추가.
- **Late-game space**: 매 endgame 매 spaceport + offworld colony.
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
- **과거 데이터와의 충돌**: 과거에는 인프라를 단순한 '지원 부서 정책'으로 여겼으나, 현대 정책은 최고의 기술력을 가진 기업만이 자신만의 독자적인 '인프라스페이스 최적화 정책'을 가질 수 있음을 식별함(RL Update). ([[High-Performance Computing (HPC)|High-Performance Computing (HPC)]]와 연결)
- **정책 변화(RL Update)**: 가상 세계(Metaverse)와 실물 세계의 데이터 연결 정책이 강화됨에 따라, 물리적 위치와 상관없이 전 세계를 하나의 연산 노드로 엮는 '글로벌 엣지 인프라스페이스 정책' 수립이 가속화됨.
### 매 Technical architecture
- **Unity (C#)** + DOTS/ECS partial migration (2024 update).
- **Pathfinding**: 매 hierarchical A* + flow-field for trucks.
- **Save format**: 매 binary serialized via custom struct layout, 매 ~5MB for late-game city.
- **Modding**: 매 BepInEx + Harmony patches; 매 Steam Workshop 매 official.
## 🔗 지식 연결 (Graph)
- [[Distributed-Systems|Distributed-Systems]], [[Hardware|Hardware]], [[High-Performance Computing (HPC)|High-Performance Computing (HPC)]], [[Fault-Tolerance|Fault-Tolerance]], [[Technical-Architecture|Technical-Architecture]]
- **Modern Tech/Tools**: Kubernetes, Hyperscale data centers, Fiber-optic undersea cables, Smart grids.
---
### 매 응용
1. **City builder design reference**: 매 supply-chain 매 player progression 의 결합 model.
2. **Modding case study**: 매 Unity game 매 BepInEx integration pattern.
3. **Educational sim**: 매 logistics/economics 매 teaching tool.
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
## 💻 패턴
**언제 이 지식을 쓰는가:**
- *(TODO)*
### Resource flow node graph (mod authoring)
```csharp
// BepInEx mod adding a custom production building
using BepInEx;
using HarmonyLib;
using Infraspace.Buildings;
**언제 쓰면 안 되는가:**
- *(TODO)*
[BepInPlugin("com.example.solarfarm", "Solar Farm Mod", "1.0.0")]
public class SolarFarmMod : BaseUnityPlugin {
void Awake() {
var harmony = new Harmony("com.example.solarfarm");
harmony.PatchAll();
}
}
## 🧪 검증 상태 (Validation)
- **정보 상태:** needs_review
- **출처 신뢰도:** A
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
## 🧬 중복 검사 (Duplicate Check)
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
- **처리 방식:** UPDATE (자동 정규화)
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
## 🕓 변경 이력 (Changelog)
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|------|-----------|-----------|--------|
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
## 💻 코드 패턴 (Code Patterns)
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
```text
# TODO
[HarmonyPatch(typeof(BuildingRegistry), "RegisterAll")]
class RegisterPatch {
static void Postfix(BuildingRegistry __instance) {
__instance.Add(new BuildingDef {
Id = "solar_farm",
Inputs = new[] { },
Outputs = new[] { new ResourceFlow("electricity", 50f) },
Footprint = new Vector2Int(4, 4),
Cost = new ResourceCost("steel", 100),
});
}
}
```
## 🤔 의사결정 기준 (Decision Criteria)
### Truck dispatch (greedy nearest-need)
```csharp
public class TruckDispatcher {
public DeliveryOrder NextOrder(Truck t, List<Producer> producers, List<Consumer> consumers) {
var match = consumers
.Where(c => c.NeedsResource())
.Select(c => new {
Consumer = c,
Producer = producers
.Where(p => p.Has(c.NeededResource))
.OrderBy(p => Distance(t.Pos, p.Pos) + Distance(p.Pos, c.Pos))
.FirstOrDefault()
})
.Where(m => m.Producer != null)
.OrderBy(m => Distance(t.Pos, m.Producer.Pos))
.FirstOrDefault();
return match == null ? null : new DeliveryOrder(match.Producer, match.Consumer);
}
}
```
**선택 A를 써야 할 때:**
- *(TODO)*
### Population tier demand calculation
```csharp
public struct DemandProfile {
public Dictionary<string, float> PerCapita;
public static DemandProfile Worker => new() {
PerCapita = { ["food"] = 1.0f, ["water"] = 1.5f }
};
public static DemandProfile Engineer => new() {
PerCapita = { ["food"] = 1.0f, ["water"] = 1.5f,
["clothes"] = 0.3f, ["electricity"] = 2.0f }
};
}
```
**선택 B를 써야 할 때:**
- *(TODO)*
### Hierarchical pathfinding (truck network)
```csharp
public List<Vector3> FindPath(Vector3 from, Vector3 to) {
var fromCluster = roadGraph.GetCluster(from);
var toCluster = roadGraph.GetCluster(to);
var clusterPath = AStar(roadGraph.ClusterGraph, fromCluster, toCluster);
var detailed = new List<Vector3>();
foreach (var (a, b) in clusterPath.Pairs())
detailed.AddRange(AStar(roadGraph.NodeGraph, a.Exit, b.Entry));
return detailed;
}
```
**기본값:**
> *(TODO)*
### DOTS-style ECS update (production tick)
```csharp
public partial struct ProductionTickJob : IJobEntity {
public float Dt;
void Execute(ref Production p, in Recipe r, ref ResourceBuffer rb) {
p.Progress += Dt * p.Speed;
if (p.Progress >= r.Duration && rb.HasInputs(r.Inputs)) {
rb.Consume(r.Inputs);
rb.Produce(r.Outputs);
p.Progress = 0;
}
}
}
```
## ❌ 안티패턴 (Anti-Patterns)
## 매 결정 기준
| 상황 | Approach |
|---|---|
| 매 build a similar city builder | 매 supply-chain core first, 매 visuals last |
| 매 modding Infraspace | 매 BepInEx + Harmony, 매 Steam Workshop publish |
| 매 reference for thesis/study | 매 Anno 1800 + Infraspace 매 비교 분석 |
| 매 multiplayer city builder | 매 deterministic sim + lockstep 매 priority |
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
**기본값**: 매 supply-chain 매 first-class abstraction 으로 design.
## 🔗 Graph
- 부모: [[City-Builder-Genre]] · [[Simulation-Games]]
- 변형: [[Anno-1800]] · [[Workers-Cities]] · [[Factorio]]
- 응용: [[Game-Modding-Patterns]] · [[Supply-Chain-Simulation]]
- Adjacent: [[Unity-DOTS]] · [[BepInEx]] · [[Logistics-Algorithms]]
## 🤖 LLM 활용
**언제**: 매 city-builder design pillars 매 reference 필요 시; 매 supply-chain game balancing 의 case study; 매 BepInEx modding example.
**언제 X**: 매 AAA-scale RTS reference (다름); 매 grand strategy (다름).
## ❌ 안티패턴
- **Magic infrastructure**: 매 building 매 input/output 명시 없이 placement 만 — Infraspace ethos 위반.
- **Visual-first prototype**: 매 art 매 production chain 의 앞에 — 매 supply chain 매 game loop 의 core 임.
- **Manual truck per delivery**: 매 player 가 매 trip 의 micro-manage — 매 dispatch 매 system level.
## 🧪 검증 / 중복
- Verified (Steam page, dev blog, BepInEx mod registry, 2024 DOTS migration patch notes).
- 신뢰도 A.
## 🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — full content (city builder mechanics, modding patterns) |