Home - xxriny/KNU-PROJECT GitHub Wiki

Welcome to the KNU-PROJECT wiki!

ν”„λ‘œμ νŠΈ ꡬ쑰 및 μ½”λ“œμ˜ 상세 λ‚΄μ—­μž…λ‹ˆλ‹€. κ°œλ°œμ‹œ 주기적으둜 μ—…λ°μ΄νŠΈν•΄μ£Όμ„Έμš”

디렉터리 κ°œμš”

navigator/
β”œβ”€ electron/
β”‚  β”œβ”€ main.js                 # Electron 메인 ν”„λ‘œμ„ΈμŠ€, λ°±μ—”λ“œ μ‚¬μ΄λ“œμΉ΄ 관리
β”‚  └─ preload.js              # λ Œλ”λŸ¬ IPC λΈŒλ¦¬μ§€
β”œβ”€ src/
β”‚  β”œβ”€ App.jsx
β”‚  β”œβ”€ index.css
β”‚  β”œβ”€ components/
β”‚  β”‚  β”œβ”€ Workspace, ChatPanel, SAArtifactGraph, …
β”‚  β”‚  β”œβ”€ ResultViewer.jsx     # κ²°κ³Ό μ…Έ(νƒ­ λΌμš°νŒ…)
β”‚  β”‚  β”œβ”€ resultViewer/        # 탭별 UI (Overview, RTM, Context, Topology, SA μ „μš© νƒ­ λ“±)
β”‚  β”‚  β”œβ”€ graphLayout.js       # κ·Έλž˜ν”„ λ ˆμ΄μ•„μ›ƒ
β”‚  β”‚  └─ graphUtils.js        # κ·Έλž˜ν”„ μœ ν‹Έ
β”‚  └─ store/
β”‚     β”œβ”€ useAppStore.js       # 톡합 μŠ€ν† μ–΄(νŒŒμ΄ν”„λΌμΈΒ·UIΒ·μ„Έμ…˜ λ“±)
β”‚     β”œβ”€ storeHelpers.js
β”‚     β”œβ”€ debounce.js
β”‚     └─ slices/
β”‚        β”œβ”€ wsSlice.js        # WebSocket κ΄€λ ¨ μ•‘μ…˜/μƒνƒœ
β”‚        └─ configSlice.js    # μ„€μ • κ΄€λ ¨
β”œβ”€ backend/
β”‚  β”œβ”€ main.py                 # FastAPI μ—”νŠΈλ¦¬
β”‚  β”œβ”€ version.py              # κΈ°λ³Έ λͺ¨λΈ λ“± 곡톡 μƒμˆ˜
β”‚  β”œβ”€ transport/              # WebSocket / REST ν•Έλ“€λŸ¬
β”‚  β”œβ”€ orchestration/
β”‚  β”‚  β”œβ”€ pipeline_runner.py   # νŒŒμ΄ν”„λΌμΈ 선택·싀행 μ§„μž…
β”‚  β”‚  └─ executor.py          # RESTΒ·WS 곡톡 μ‹€ν–‰Β·κ²°κ³Ό shaping (PipelineExecutor)
β”‚  β”œβ”€ pipeline/
β”‚  β”‚  β”œβ”€ graph.py             # LangGraph StateGraph λΉŒλ”, νŒŒμ΄ν”„λΌμΈ λ ˆμ§€μŠ€νŠΈλ¦¬
β”‚  β”‚  β”œβ”€ state.py             # PipelineState (TypedDict μ‘°ν•©)
β”‚  β”‚  β”œβ”€ node_base.py         # @pipeline_node, NodeContext
β”‚  β”‚  β”œβ”€ utils.py             # LLM ν˜ΈμΆœΒ·κ΅¬μ‘°ν™” 좜λ ₯ 곡톡
β”‚  β”‚  β”œβ”€ schemas/             # Pydantic μŠ€ν‚€λ§ˆ νŒ¨ν‚€μ§€ (core λ“±)
β”‚  β”‚  └─ nodes/               # PM/SA/μ±„νŒ… 단계별 λ…Έλ“œ
β”‚  β”‚     β”œβ”€ pm_phase1 … pm_phase5   # atomizer β†’ … β†’ context_spec
β”‚  β”‚     β”œβ”€ sa_phase1 … sa_phase8
β”‚  β”‚     β”œβ”€ sa_phase3_reverse.py, sa_reverse_module.py, sa_layer_heuristics.py, …
β”‚  β”‚     β”œβ”€ chat_revision.py, idea_chat.py
β”‚  β”‚     └─ sa_reverse_context.py
β”‚  β”œβ”€ result_shaping/
β”‚  β”‚  β”œβ”€ result_shaper.py
β”‚  β”‚  β”œβ”€ sa_artifact_compiler.py
β”‚  β”‚  └─ container_config.py  # μ»¨ν…Œμ΄λ„ˆ λ‹€μ΄μ–΄κ·Έλž¨ κ·Έλ£ΉΒ·λ ˆμ΄μ–΄ 맀핑(ν”„λ‘œμ νŠΈ μ»€μŠ€ν„°λ§ˆμ΄μ¦ˆ)
β”‚  β”œβ”€ observability/
β”‚  β”œβ”€ connectors/
β”‚  β”œβ”€ Data/                   # 뢄석 κ²°κ³Ό JSON, PROJECT_STATE
β”‚  β”œβ”€ test/
β”‚  β”œβ”€ requirements.txt
β”‚  └─ .env.example
β”œβ”€ index.html
β”œβ”€ package.json
β”œβ”€ run_v2.bat
└─ vite.config.js

파일 총 κ°œμš”

μΉ΄ν…Œκ³ λ¦¬ 파일 수 μ£Όμš” μ—­ν• 
루트 μ„€μ • 6 Vite/Tailwind/PostCSS/배치/HTML/npm
Electron 2 λ°μŠ€ν¬ν†± μ…Έ, IPC preload
Backend 핡심 4 main.py, version, requirements, pytest
Pipeline μ½”μ–΄ 7 state, graph, node_base, utils, ast_scanner, chroma, action_type
Pipeline μŠ€ν‚€λ§ˆ 2 Pydantic λͺ¨λΈ(core.py + init.py)
Pipeline λ…Έλ“œ 22 PM 5단계 + SA 8단계(+sa_phase3_reverse, sa_phase5_schemas) + μ±„νŒ…/아이디어 + 역뢄석 2개 + νœ΄λ¦¬μŠ€ν‹± + atomizer + init
Connectors 2 폴더 μŠ€μΊ”, κ²°κ³Ό μ €μž₯
Observability 3 λ‘œκΉ…, Prometheus λ©”νŠΈλ¦­
Orchestration 3 νŒŒμ΄ν”„λΌμΈ μ‹€ν–‰/슀트리밍
Transport 4 WS/REST/컀λ„₯μ…˜ λ§€λ‹ˆμ €
Result Shaping 4 κ²°κ³Ό μ •ν˜•ν™”, SA μ‚°μΆœλ¬Ό, μ»¨ν…Œμ΄λ„ˆ μ„€μ •
Frontend Store 5 Zustand μŠ€ν† μ–΄(메인 + 슬라이슀 2개 + 헬퍼 + λ””λ°”μš΄μŠ€)
Frontend 메인 μ»΄ν¬λ„ŒνŠΈ 10 App, Sidebar, ChatPanel, Workspace, HomeScreen, PipelineProgress, ResultViewer, StatusBar, CodeViewer, SessionPanel
Frontend resultViewer 14 12개 νƒ­ + SharedComponents + resultUtils
Frontend κ·Έλž˜ν”„ 5 SAArtifactGraph, saGraphAdapters, graphLayout, graphUtils, TopologyGraph
Backend ν…ŒμŠ€νŠΈ 11 각 λ…Έλ“œ λ‹¨μœ„/톡합 ν…ŒμŠ€νŠΈ
합계 ~103개