Market GraphRAG Workspace

Precise — 시장 데이터 GraphRAG 운영 화면

Name: Precise — Market GraphRAG
Author: 조형준

정적 운영 UI, API relay, Server B GraphRAG 런타임을 분리해 수집·검색·분석·백테스트·상태 확인을 연결했습니다.

31 routes 78 tables 12 hypertables 120 tests

Snapshot

API

31 routes

Schema

78 tables

Time-Series

12 hypertables

Validation

120 tests

수치는 Server B route, SQL DDL, test 코드 스냅샷 기준입니다.

시스템 Workflow

01 Browser 사용자는 정적 /precise 화면에서 ingest, analyze, backtest, status를 실행합니다.

02 Server C 정적 /precise/* UI를 렌더링하고 same-origin API만 호출합니다.

03 Server A Relay exact allowlist, CSRF, request ID, relay token, 일부 payload 암호화를 적용합니다.

04 Server B FastAPI GraphRAG runtime이 /graphrag/* 요청만 처리합니다.

05 Result UI job 상태, 분석 결과, 백테스트 결과를 다시 운영 화면에 표시합니다.

Server C Presentation

Static Pages/precise, data, research, analyze, backtest

Browser Contractsame-origin /precise/api/* 호출만 허용

No SecretsDB, 모델, private origin credential 없음

Server A Relay

API Relay/precise/api/* → Server B /graphrag/*

Request Guardsame-origin, CSRF, request_id, relay token

Exact Routes허용된 method/path 외 요청 거부

Server B Runtime & Data

FastAPI31 route private GraphRAG API surface

TimescaleDBmarket OHLCV, indicators, pattern signals

Workersingest, query, backtest, job/result

Public UI와 GraphRAG runtime을 같은 계층에 두지 않습니다.

Server B는 relay token과 request ID가 없는 요청을 처리하지 않습니다.

결과는 job/result 계약으로 회수해 화면에서 검토합니다.

Server C는 렌더링, Server A는 relay, Server B는 비공개 GraphRAG 런타임과 시장 데이터 처리를 담당합니다.

KPI & Evidence

System

31개 FastAPI route
Server C static UI + Server A API relay
Server B GraphRAG runtime 분리

Data

78개 SQL table DDL
12개 Timescale hypertable
67개 SQL index

Validation

120개 test function
relay token, CSRF, request ID 검증
order-book query payload 암호화 경계

Case Study

시장 데이터와 투자 근거를 한 화면에서 다루는 운영 시스템

Problem

시장 데이터, 리서치 메모, 분석 결과, 백테스트가 서로 다른 화면과 저장소에 흩어져 있었습니다.
외부 공개 화면과 내부 GraphRAG 런타임을 같은 서버에 두기 어려운 보안 경계가 있었습니다.

Build

정적 UI는 Server C, relay는 Server A, GraphRAG·DB·worker는 Server B에 배치했습니다.
ingest, analyze, backtest, status, order-book 요청을 하나의 운영 흐름으로 묶었습니다.

Result

데이터 적재 상태에서 분석, 백테스트, job/result 확인까지 이어지는 검토 화면을 구성했습니다.
릴레이 인증과 암호화가 필요한 요청을 분리해 내부 런타임을 직접 노출하지 않도록 했습니다.

Evidence

근거

Architecture

/precise 정적 UI, /precise/api/* relay, Server B /graphrag/* API 경계 기준입니다.

Data Model

server-b-db/timescaledb/initdb SQL DDL에서 table, hypertable, index 수를 확인했습니다.

Validation

tests, server-b/tests, server-b-market/tests, server-b-pattern/tests 기준입니다.