📝 [Wiki] Gopedia → High-Efficiency Enterprise Knowledge Graph Platform

[lyckabc]

[Gopedia] Official Wiki

KR: 이 페이지는 Gopedia의 비전, 기술적 방향성, 그리고 협업 방식을 정의하는 통합 문서입니다. 팀원과 외부 기여자들이 조화롭게 협업할 수 있도록 돕는 공식 가이드라인입니다.
빠른 요약·실행 가이드는 README(영문) · README(한국어)를 우선 확인하세요.

EN: This page defines the vision, technical direction, and collaboration model for Gopedia—an official guideline for the team and external contributors. For a concise overview and how to run the code, start with the English README or Korean README.

---

문서 맵 (이 저장소 / This repository)

문서	용도
README (EN)	아키텍처 다이어그램, 데이터 계층, IR 스냅샷, 설치, API
README (KO)	위와 동일 구조의 한국어 정리
Phloem (인제스트) / Xylem (RAG)	코드 기반 파이프라인·갭
Run 가이드	로컬/Compose 실행
RAG 테스트 리포트	Gardener IR 버전 스냅샷
images/ (PNG + .mmd 소스)	KR/EN <details> 본문에 동일 이미지 첨부; 재생성은 images/README.md

참고: 아래 본문에 등장하는 SKILL.md, gopedia-feature-guide.md, RoadMap/SKILL.md 는 Universitas / GeneSo 모노레포 기준 경로 표기입니다. 이 gopedia 단독 클론에는 동일 경로의 파일이 없을 수 있으므로, 구현·스키마 세부는 Rev2/Rev4 설계와 README(영문)를 우선하세요. (외부 워크스페이스에 해당 문서가 있으면 팀 내부 URL로 대체.)

Phloem / Xylem / IR PNG는 아래 프로젝트 소개 (KR) — 시각 자료 · Project overview (EN) — figures에 각각 첨부합니다. 상세·갭: phloem/README.md, xylem/README.md, IR 스냅샷.

---

프로젝트 소개 (KR)

1. 프로젝트 개요 (Project Overview)

Purpose (목적)

• Gopedia는 파편화된 정보를 지식 신경망으로 통합하는 Enterprise Knowledge Graph Platform(ingestion 및 RAG) 입니다.
• 단순한 저장소를 넘어, 관계 추론과 맥락 파악이 가능한 Enterprise Ontology의 근간을 제공합니다.
• Target: 분산된 데이터의 단일 진실 공급원(SSoT) 및 지식 추론 엔진.
• 이 저장소의 구체 구현은 README(한국어)의 «아키텍처: 뿌리줄기 은유»·Phloem/Xylem·Rhizome 절에 정리되어 있습니다.

Background / Introduction (배경·소개)

“데이터라는 토양에 지식의 뿌리를 내려, 유기적으로 연결된 지혜의 열매를 맺는다.”

Gopedia는 데이터를 “적재”하는 수준을 넘어, Root(플러거블 소스) → Stem(Phloem: Ingestion / Xylem: RAG) → Rhizome(저장·관계) → Leaf(인덱싱 뷰) · Fruit(리포트) 의 생명 주기에 맞춰 설계됩니다. GeneSo Design Standard(v1.3)의 관계 중심 원칙을 적용하며, 리좀(Rhizome) 메타포를 통해 수평·무한 확장 가능한 지식망을 지향합니다.
(영문 머릿말: README(영문) Introduction.)

Core Values (핵심 가치)

메타포	의미	설명
Pluggable (Root)	입력의 유연성	뿌리. 외부 소스·연결(DB, API, 스트림)을 플러거블하게 정의
Scalable (Stem)	파이프라인 확장성	gRPC 기반 Phloem(Ingestion)·Xylem(RAG) 으로 데이터 실어나르기. Phloem: 소스→Rhizome 기록. Xylem: Rhizome→Leaf/사용자 검색·응답.
Relational (Rhizome)	저장·관계	TypeDB·Qdrant·PostgreSQL 등 폴리글랏 저장소와 관계 추론
View (Leaf)	인덱싱 뷰	도메인·프로젝트별로 인덱싱된 보기. Markdown, Code, Ticket 등 소스가 Rhizome에 적재된 뒤 Xylem으로 끌어올려 보이는 형태
Actionable (Fruit)	가치 산출	여러 Leaf·Root 데이터를 조합한 리포트 템플릿·형식. Skill Engine·RAG 결과물 등 사용자가 소비하는 결실

해결하고자 하는 문제

1. 분산·비정형 데이터 통합: 여러 소스(Markdown, Code, Ticket, Meeting, ERP 등)에 흩어진 정보를 SSoT로 모으고, Rhizome형 지식 신경망(관계·온톨로지)으로 정돈.
2. 밀도 높은 조회·생성: L1/L2/L3 계층으로 구조화해 RAG 시 토큰을 절감. 세부는 Rev4 L3/청킹 전략 및 README 데이터 계층 참조.

• (광의 문서) L1/L2/L3 기준의 긴 설명은 Universitas 쪽 reference/gopedia-feature-guide.md §2 (모노레포)를 참고.

적용 가능한 대상 (도메인·조직)

• 범위: 모든 기업, 정부, 팀.
• 구체적 예 (템플릿 유지):
  • 핀테크·규제 리포팅
  • 대규모 인프라 운영 (Machine ID, 로그/설정 통합)
  • 개발·문서·이슈 통합 — 현재 gopedia는 Markdown·Code 인제스트와 HTTP 검색·Gardener 품질 루프가 동작; Ticket/Meeting 등은 로드맵(아래).

작동 방식 (요약) — 이 저장소 기준

• Root → Stem → Rhizome → Leaf · Fruit 생명 주기:
  • Phloem (Ingestion) — README의 Mermaid: IngestMarkdown → (wiki/code) → DefaultSink → PostgreSQL, Qdrant, 선택 Redis(Tuber). 자세한 단계: doc/design/phloem/pipeline.md.
  • Xylem (RAG) — flows.xylem_flow / GET /api/search: 임베딩 → Qdrant L3 → 선택 리랭크 → PG rich context. doc/design/xylem/pipeline.md.
• (원문 템플릿의 Envelope/ClickHouse/Red Panda·Schema Registry 상세) — Connect/Expand 단계와 GeneSo 런타임에 더 가깝습니다. 본 repo의 즉시 문서는 README·doc/design를 따릅니다.
• Universitas SKILL.md 및 reference/gopedia-feature-guide.md 는 설계 언어·용어의 광의 레퍼런스로 보시면 됩니다.

시각 자료: Phloem · Xylem · IR (PNG)

Phloem (인제스트)	Xylem (RAG)	IR 집계 (버전 스냅샷)

완성도 및 PoC 가능 범위

• 기간·Target Date (템플릿 유지)
  • Code Format(4.1.2): 4월 말까지 구현 완료 목표.
  • Ticket(4.1.3)·Meeting(4.1.4): 5월 말까지 구현 완료 목표.
  • 상세 target-day·마일스톤은 GeneSo/Universitas RoadMap/SKILL.md 참조.
• 이 open-source gopedia에서 검증 가능한 것: README – Installation & first scenario, run.md, RAG IR 리포트.
• 필요 환경 (로드맵): gRPC/Protobuf, Red Panda(Kafka 호환), ClickHouse, SpiceDB 등 — README의 현 구성은 PG·Qdrant·(옵션) TypeDB TCP·Phloem gRPC.

---

2. 팀 구성 (The Team)

Roles and responsibilities for the member team.

이름 (Name)	ID	역할 (Role)	SNS	주요 책임 (Responsibilities - KR/EN)
신동호	@lyckabc	Team Leader	Link	로드맵 및 최종 의사결정 / Roadmap & Final decision-making
박보민	@bmops0719	Core Infra	Link	인프라 아키텍처 리뷰 / Infra Architecture reviews
김준곤	@jgkim	Core Dev	Link	리뷰어 / reviewer

---

3. 기술 스택 (Tech Stack)

• 통신·계약: gRPC / Protobuf — Stem 통신. Contract-First; Schema Registry(Red Panda)는 Connect 단계 확장.

• Rhizome 저장소 (폴리글랏) (비전 + 본 repo 우선순위):

  • PostgreSQL: 마스터 메타·documents / knowledge_l1/2/3 등 (README – Rhizome).
  • TypeDB: 그래프·온톨로지 — 본 API는 TCP 가용성 체크 위주, 인제스트 직접 쓰기는 로드맵.
  • Qdrant: L3 벡터 검색.
  • ClickHouse: 분석·BM25·감사 — Expand 이후.

• 권한: SpiceDB 기반 ReBAC (Connect 단계).

• 메시징: Red Panda(Kafka 호환) (확장 시).

• 언어·런타임: Go(Phloem gRPC, API), Python(Xylem, Root). doc/design/phloem/pipeline.md / doc/design/xylem/pipeline.md.

상세 기능(L1/L2/L3, idempotency, Smart Sink, Machine ID 등) — 광의: Universitas reference/gopedia-feature-guide.md · 본 repo: Rev4 · Rev2 개요.

---

4. 로드맵 (Roadmap)

Gopedia는 Verify → Expand → Connect 세 단계로 진화합니다. 일정·target-day는 Universitas RoadMap/SKILL.md에서 관리합니다.

단계	의미	요약
Verify (발아)	최소 단위 검증	Root → Stem(Phloem) → Rhizome 안착. Markdown/Code 등.
Expand (생장)	용량·다소스 확장	Machine ID 분산, 다양한 소스.
Connect (결실)	생태계 연동	GeneSo·RAG Fruit(Skill Engine), SpiceDB.

이 저장소(README)의 Rev2 언어로는: Verify·Expand·Connect (README – Roadmap)와 연결해 읽을 수 있습니다.

• 4.1.1 Markdown — 인제스트 경로: Phloem README.
• 4.1.2 Code — domain: code 파이프라인: README – Stem.
• 이후 4.1.3~4.1.5, Expand, Connect 일정은 RoadMap/SKILL.md (모노레포) 참조.

---

5. 참여 방법 (How to Contribute)

• 이메일 신청: lyckabc@gmail.com

• 설계 원칙·명명 규칙 — 광의: Universitas SKILL.md · GeneSo Design Standard(외부)를 따릅니다. 이 repo에서는 Phloem/Xylem design을 우선합니다.

• Verify 단계 체크리스트 — README · run.md. (모노레포 skills/gopedia-verify-flow/ 경로는 템플릿 기준; 동일 절차가 별 skills 디렉터리로 있으면 그쪽과 병행.)

---

6. 리소스 및 링크 (Resources & Links)

리소스	비고
GitHub - tojiuni/gopedia · GitHub	public, Docker Compose 등
https://git.toji.homes/toji/gopedia	팀 오픈 예정 (템플릿)
Universitas universitas/gopedia/SKILL.md	(모노레포) 설계·단계·서브스킬 — 본 repo 루트에 없음
reference/gopedia-feature-guide.md	(모노레포) 기능 정의 — 본 repo는 doc/design 병행
RoadMap/SKILL.md	(모노레포) target-day / milestone
README(영문) / README(한국어)	이 저장소 공식 엔트리

---

Project Introduce (EN)

1. Project Overview

Purpose

• Gopedia is an Enterprise Knowledge Graph Platform (ingestion and RAG) that unifies fragmented information into a knowledge network.
• Beyond a simple store, it provides the foundation for Enterprise Ontology with relationship inference and context awareness.
• Target: Single Source of Truth (SSoT) for distributed data and a knowledge inference engine.
• Implementation in this repository is summarized in the English README (Phloem, Xylem, Rhizome, diagrams).

Background / Introduction

“Put down roots of knowledge in the soil of data, and bear the fruit of wisdom, organically connected.”

Gopedia is designed around the lifecycle Root → Stem (Phloem: Ingestion / Xylem: RAG) → Rhizome → Leaf · Fruit, following GeneSo Design Standard (v1.3) and the Rhizome metaphor. See the Korean README for the same structure in Korean.

Core Values

Metaphor	Meaning	Description
Pluggable (Root)	Input flexibility	Pluggable external sources and connections (DB, API, streams)
Scalable (Stem)	Pipeline scalability	gRPC Phloem (Ingestion) and Xylem (RAG). Phloem: source → Rhizome. Xylem: Rhizome → user search.
Relational (Rhizome)	Storage & relations	Polyglot: TypeDB, Qdrant, PostgreSQL, etc.
View (Leaf)	Indexed views	Domain/project views; content surfaced after ingest via Xylem
Actionable (Fruit)	Value delivery	Reports, Skill Engine and RAG outputs for users

Problems Addressed

1. Distributed data integration into SSoT and a Rhizome-style knowledge network.
2. Dense query/generation via L1/L2/L3; see Rev4 and Data hierarchy in README.

• (Wider doc): Universitas gopedia-feature-guide.md §2 when working inside the monorepo.

Applicable Domains and Organizations

• Scope: Any enterprise, government, or team.
• Examples (template): fintech/regulatory, large-scale infra, dev/docs/issues — this repo currently ships Markdown & code ingest and search; see README.

How It Works (Summary) — in this repository

• Phloem — gRPC IngestMarkdown → DefaultSink → PostgreSQL, Qdrant, optional Redis. doc/design/phloem/pipeline.md.
• Xylem — flows.xylem_flow / GET /api/search. doc/design/xylem/pipeline.md.
• Template items (Envelope plumbing, full ClickHouse/Red Panda integration) map to Expand/Connect; see README for what runs today.
• Universitas SKILL.md / gopedia-feature-guide.md remain the broad terminology references.

Figures: Phloem · Xylem · IR (PNG)

Phloem (ingestion)	Xylem (RAG)	IR aggregate (version snapshot)

Completeness and PoC Scope

• Timelines (template): Code format by end of April; Ticket/Meeting by end of May — see RoadMap/SKILL.md in the monorepo.
• What you can run here: README – Installation & first scenario, run.md, RAG reports.
• Environments (roadmap): SpiceDB, Red Panda, full polyglot — now: PG, Qdrant, optional TypeDB check, Phloem gRPC (per README).

---

2. The Team

Name	ID	Role	SNS	Responsibilities - EN
신동호	@lyckabc	Team Leader	Link	Roadmap & Final decision-making
박보민	@bmops0719	Core Infra	Link	Infra Architecture reviews
김준곤	@jgkim	Core Dev	Link	Reviewer

---

3. Tech Stack

• Communication & contract: gRPC / Protobuf — common for Stem. Schema Registry (Red Panda) in later phases.

• Rhizome storage (polyglot) (vision; this repo focuses on):

  • PostgreSQL — see README – Rhizome.
  • TypeDB — health/reachability; full graph write path is roadmap.
  • Qdrant — L3 vector search.
  • ClickHouse — analytics/BM25 — Expand.

• Authorization: SpiceDB (Connect).

• Messaging: Red Panda (Kafka-compatible) — when adopted.

• Languages & runtime: Go (Phloem, API), Python (Xylem, Root) — design docs.

For concepts (L1/L2/L3, idempotency, sinks), use this repo Rev4 and the English README; the monorepo gopedia-feature-guide.md is supplemental.

---

4. Roadmap

Gopedia evolves: Verify → Expand → Connect — schedule in monorepo RoadMap/SKILL.md. Align with README – Roadmap for this repository’s wording (Rev2).

Phase	Meaning	Summary
Verify (Sprouting)	Minimal validation	Root → Phloem → Rhizome (Markdown, Code, …)
Expand (Growth)	Scale & multi-source	Sharding, more sources
Connect (Fruiting)	Ecosystem	GeneSo, Skill Engine, SpiceDB

• Markdown/Code paths: Phloem design, README – Stem.
• 4.1.3+ and Expand/Connect: RoadMap/SKILL.md (monorepo).

---

5. How to Contribute

• Apply by email: lyckabc@gmail.com

• Design principles: monorepo SKILL.md and GeneSo standards; this repo Phloem/Xylem first.

• Verify checklists: README, run.md, and monorepo skills/gopedia-verify-flow/ if present.

---

6. Resources & Links

Resource	Notes
GitHub - tojiuni/gopedia · GitHub	Public Docker/Compose
https://git.toji.homes/toji/gopedia	Team mirror (planned)
Universitas universitas/gopedia/SKILL.md	Monorepo design & phases (not in this repo)
reference/gopedia-feature-guide.md	Monorepo feature doc — use with doc/design here
RoadMap/SKILL.md	Monorepo milestones
README (EN) / README (KO)	Official entry for this repository

---

| This is a space where knowledge is not merely consumed, but respected, sovereign, and connected—shared together with cloud industry professionals (Bros). |
| 지식이 소비되지 않고 존중·주권보장·연결되는 공간으로 클라우드 현업 전문가(Bro)와 함께 공유하고 있습니다. |