# 결 GYEOL

> **목표에서 시작해, 기회를 발굴하고, 판단을 남기고, 과거로부터 강해지는 개인 투자 운영체계.**

결은 단순한 뉴스 검색기, 종목 추천기, 자동매매봇이 아닙니다.  
결은 **7년 내 더 나은 주거·학군 환경으로 이동하기 위한 자본 목표**에서 출발해, 필요한 수익 구조를 계산하고, 장기 트렌드·저평가·공시·이벤트 전 기회를 발굴하며, 모든 판단을 기록·복기해 사용자의 투자 로직을 강화하는 AI 투자 튜터입니다.

---

## 0. 프로젝트 절대 원칙

### 0.1 개발 원칙

이 프로젝트는 MVP 축소 방식으로 가지 않습니다.

```text
작게 만들고 나중에 붙인다 X
최종 그림을 먼저 설계하고, 전체 구조에서 작동 가능한 코드를 넣는다 O
```

결의 개발 원칙은 다음과 같습니다.

```text
1. 최종 모드 기준으로 설계한다.
2. 필요한 API는 붙인다.
3. 기능을 임시로 축소하지 않는다.
4. 미연동 데이터는 미연동으로 명확히 표시한다.
5. 가짜 데이터로 화면을 채우지 않는다.
6. 전체 흐름이 깨지는 임시 땜빵 코드는 넣지 않는다.
7. 코드 파일은 GitHub에 바로 넣을 수 있는 단위로 제공한다.
8. 한 번에 여러 파일이 어렵다면 파일 단위로 순차 제공한다.
9. 최종 구조가 맞다면, 코드는 전체 구조 안에서 바로 동작하도록 넣는다.
```

---

### 0.2 데이터 원칙

결의 운영 DB에는 가짜 데이터를 넣지 않습니다.

```text
mock 금지
sample 금지
fake 금지
dummy 금지
placeholder 금지
묵업 데이터 금지
가짜 뉴스 금지
가짜 가격 금지
가짜 PER/PBR 금지
가짜 수익률 금지
```

허용되는 데이터는 다음뿐입니다.

```text
real_api
- 실제 API에서 온 데이터

manual_user
- 사용자가 직접 입력한 목표, 판단, 메모, 복기

system_generated_from_real_data
- 실제 데이터 기반으로 AI가 요약·해석한 결과

error_log
- API 실패, 데이터 누락, 연결 실패 기록
```

원칙:

```text
데이터가 없으면 없음.
API가 실패하면 실패.
미연동이면 미연동.
AI가 모르면 모른다.
```

---

## 1. 결은 무엇인가

결은 다음이 아닙니다.

```text
뉴스 검색기 X
종목 추천기 X
자동매매봇 X
단순 증권앱 X
리딩방 X
단순 포트폴리오 앱 X
```

결은 다음입니다.

```text
목표 기반 투자 운영체계
기회 발굴 시스템
종목 해부실
판단 원장
복기 시스템
로직 강화 엔진
AI 투자 튜터
```

결의 한 문장 정의:

> **결은 사용자의 인생 목표에서 필요한 자본 목표를 계산하고, 시장의 숨은 기회를 발굴해, 근거 있는 판단과 복기를 통해 투자 로직을 강화하는 AI 투자 튜터다.**

---

## 2. 결의 시작점: 목표의 결

결은 종목에서 시작하지 않습니다.  
결은 **목표**에서 시작합니다.

사용자의 핵심 목표:

```text
7년 이내
서울 또는 더 중심부의
초등 학군과 학원 인프라가 좋은 지역으로 이동한다.
```

결은 먼저 다음을 계산해야 합니다.

```text
현재 주택 가치
현재 대출 잔액
현재 월 대출 상환액
현재 월 고정지출
현재 현금 보유액
투자 가능 현금
목표 지역 주택 가격
목표 시점
필요 자본 갭
연간 필요 수익
월간 필요 수익
허용 가능한 손실
필요한 투자 강도
```

결의 첫 질문:

```text
당신이 원하는 주거/학군 목표를 달성하려면,
앞으로 7년 동안 얼마를 벌어야 하는가?
```

결의 두 번째 질문:

```text
그 목표를 위해 어떤 수준의 리스크와 수익률이 필요한가?
```

---

## 3. Goal Math Engine — 목표 계산 엔진

결은 목표를 감으로 계산하지 않습니다.

### 3.1 기본 계산식

```text
현재 순자산
= 현재 주택 예상가
- 주택담보대출 잔액
+ 금융자산
- 기타부채
```

```text
목표 필요자본
= 목표 주택 예상가
+ 취득세
+ 중개수수료
+ 이사비
+ 예비자금
- 예상 대출 가능액
```

```text
필요 자본 갭
= 목표 필요자본 - 현재 순자산
```

```text
월간 필요 순증
= 필요 자본 갭 / 남은 개월 수
```

```text
연간 필요 순증
= 필요 자본 갭 / 남은 연수
```

```text
필요 CAGR
= (목표 순자산 / 현재 순자산)^(1 / 남은 연수) - 1
```

### 3.2 시나리오

목표 주택 가격과 금리, 대출 가능액은 변동됩니다.

따라서 결은 항상 복수 시나리오로 계산합니다.

```text
보수 시나리오
- 목표 주택 가격 상승률 높음
- 투자 수익률 낮음
- 금리 부담 높음

기준 시나리오
- 현재 시장 흐름 기준

공격 시나리오
- 투자 성과 양호
- 목표 주택 가격 상승률 제한

실패 시나리오
- 투자 손실
- 목표 주택 가격 상승
- 대출 조건 악화
```

### 3.3 목표 기반 결론 문장

결은 목표 계산 후 반드시 다음 문장을 생성합니다.

```text
현재 목표를 달성하려면 앞으로 N년 동안 연평균 X% 수준의 자산 증가가 필요합니다.
월 기준으로는 약 Y원의 순증이 필요합니다.
현재 현금흐름과 투자 가능 금액을 고려하면 전략 강도는 Z입니다.
```

---

## 4. Strategy Intensity Engine — 전략 강도 엔진

목표 수익률에 따라 투자 전략 강도가 달라집니다.

```text
필요 CAGR 5% 이하
→ 보수형
→ 현금흐름, 예금, 채권, 배당, 광범위 ETF 중심

필요 CAGR 5~10%
→ 균형형
→ 우량 성장주, 저평가주, ETF, 일부 테마

필요 CAGR 10~20%
→ 성장형
→ 장기 트렌드, 숨은 저평가, 공시 시즌, 이벤트 후보 적극 발굴

필요 CAGR 20% 이상
→ 고위험 성장형
→ 집중 투자 가능성 검토
→ 단, Survival Guard를 강화해야 함
```

전략 강도는 단순 수익률만으로 정하지 않습니다.

```text
목표 수익률
남은 기간
현금흐름
투자 가능 현금
대출 부담
부동산 목표 민감도
허용 손실
가족 생활 안정성
```

---

## 5. Risk Budget / Survival Guard — 생존 방어선

결은 공격적인 기회를 찾지만, 생존을 해치지 않습니다.

### 5.1 리스크 예산

```text
1회 진입 최대 금액
1종목 최대 비중
1테마 최대 비중
월 손실 한도
연 손실 한도
현금 최소 보유선
대출 상환 안전선
주거 목표 훼손 금지선
```

### 5.2 Survival Guard 질문

투자 실행 전 결은 반드시 묻습니다.

```text
이 판단이 주거 목표를 훼손할 수 있는가?
손실이 나도 다음 기회를 잡을 현금이 남는가?
한 종목/한 테마에 과도하게 몰려 있는가?
무효 조건이 명확한가?
손실 시 복기 가능한 판단인가?
```

---

## 6. 결의 핵심 철학

### 6.1 손실은 실패가 아니다

```text
손실은 데이터다.
복기는 학습이다.
포기만이 실패다.
```

결은 손실 자체를 실패로 보지 않습니다.

결이 실패로 보는 것은 다음입니다.

```text
근거 없는 판단
반대 근거 없는 확신
복기 없는 손실
반복되는 같은 실수
로직 수정 없는 반복
포기
```

---

### 6.2 뉴스는 사라는 신호가 아니다

결의 기본 관점:

```text
소문에 사서 뉴스에 팔아라.
```

뉴스가 크게 확산되었다는 것은 새로운 기회가 아니라, 이미 가격에 반영된 늦은 신호일 수 있습니다.

뉴스의 역할은 **후보 발굴의 중심**이 아니라 **시장 인지도와 과열도 확인**입니다.

```text
뉴스 없음
→ 시장 미인지 가능성

뉴스 초기 증가
→ 검증 필요

뉴스 폭증
→ 대중 확산, 추격매수 경고

뉴스 피크
→ 신규 매수보다 매도/관망/익절 점검
```

---

### 6.3 좋은 기업과 좋은 가격은 다르다

결의 종목 상세 분석은 다음 질문을 중심으로 움직입니다.

```text
이 기업은 좋은 기업인가?
이 가격은 좋은 가격인가?
지금 들어갈 타이밍인가?
현재 가격은 미래 성장성을 얼마나 반영했는가?
```

PER, PBR, ROE, EPS, 매출 성장률, 영업이익률, 부채비율, 수급, 뉴스 단계, 과거 플래시백은 모두 이 질문에 답하기 위한 재료입니다.

---

## 7. AI Role Architecture — AI 역할 분리

결의 AI는 하나의 챗봇이 아닙니다.

결의 AI는 역할별로 분리됩니다.

```text
Researcher
- 외부 자료 조사
- 장기 트렌드, 정책, 산업 변화 수집

Analyst
- 재무, 공시, 가격, 수급 분석

Red Team
- 반대 근거 생성
- 확증편향 방지

Tutor
- 어려운 지표를 쉬운 말로 설명

Strategist
- 관망, 소액, 분할, 매도, 헷지 등 전략 후보 제시

Reflection Coach
- 복기
- 반복 실수 발견
- 로직 업데이트 제안
```

모든 AI 판단은 다음 구조를 가져야 합니다.

```text
판단:
왜:
반대 근거:
틀리는 조건:
대안:
과거 유사 사례:
데이터 출처:
```

---

## 8. Data Reliability Layer — 데이터 신뢰도 계층

결은 데이터 출처를 구분합니다.

```text
A급
- 공식 공시
- 거래소
- KIS
- OpenDART
- 국토교통부
- 한국부동산원
- 기업 IR 원문

B급
- 주요 언론
- 증권사 리포트
- 산업 리포트

C급
- 포털 뉴스
- 블로그
- 일반 기사

D급
- 커뮤니티
- 미확인 루머
- 출처 불명 정보
```

데이터 신뢰도 원칙:

```text
A급 데이터는 판단 근거로 사용 가능
B급 데이터는 보조 근거
C급 데이터는 인지도 확인용
D급 데이터는 루머 표시 및 검증 전 판단 금지
```

---

## 9. 결의 전체 사용자 흐름

```text
목표 설정
↓
필요 자본 계산
↓
필요 연간/월간 수익률 계산
↓
위험 예산 설정
↓
장기 트렌드 탐색
↓
숨은 저평가/개선 후보 발굴
↓
공시/재무/수급 검증
↓
뉴스 인지도 확인
↓
종목 상세 분석
↓
판단 로그
↓
실행 또는 관망
↓
복기
↓
로직 강화
```

---

## 10. 결의 5대 분석축

### 10.1 목표의 결

```text
현재 주택 가치
현재 대출
월 고정비
현금 보유액
투자 가능 현금
목표 지역 주택 가격
목표 기간
필요 자본 갭
연간 필요 수익률
월간 필요 수익
허용 손실
```

### 10.2 거시의 결

```text
금리
환율
지수
미국장
부동산 시장
장기 산업 사이클
정책 방향
시장 모드: 공격 / 관망 / 방어
```

### 10.3 기회의 결

```text
장기 트렌드
저평가
턴어라운드
공시 시즌
대규모 계약/수주 이벤트
정책/보조금
공급 부족
밸류체인 2차 수혜
```

### 10.4 자산의 결

```text
PER
PBR
ROE
EPS
매출 성장률
영업이익 성장률
부채비율
현금흐름
수급
거래대금
가격 위치
뉴스 인지도
공시 리스크
```

### 10.5 과거의 결

```text
과거 유사 판단
성공 패턴
손실 패턴
반복 실수
로직 업데이트 후보
```

---

## 11. Opportunity Engine — 기회 발굴 엔진

결의 핵심은 뉴스 검색이 아니라 **기회 발굴**입니다.

### 11.1 Long Trend Engine — 장기 트렌드 엔진

```text
클라우드
빅데이터
AI
AI 인프라
전력망
로봇
양자
우주/위성
사이버보안
원전
방산
헬스케어 AI
```

출력:

```text
테마 지도
밸류체인
국내외 관련 종목
ETF 후보
이미 과열된 종목
아직 덜 본 하위 밸류체인
```

---

### 11.2 Theme Pulse Engine — 반짝 이슈/키워드 엔진

```text
스페이스X 상장/상장설
OpenAI 상장설
로봇택시
핵융합
AI 전력난
상온초전도체
우주 인터넷
대형 정책 발표
```

로직:

```text
이슈 발생
→ 진짜인지 검증
→ 직접 투자 가능 여부 확인
→ 파생 수혜 밸류체인 탐색
→ 뉴스 과열 여부 확인
→ ETF가 나은지 개별주가 나은지 판단
```

---

### 11.3 Hidden Value Engine — 숨은 저평가 발굴 엔진

후보 조건:

```text
저PER + EPS 증가
저PBR + ROE 개선
영업이익률 개선
부채비율 안정
현금흐름 개선
뉴스 저소음
거래대금 초기 증가
```

분류:

```text
숨은 보물 후보
턴어라운드 후보
질 좋은 가격 후보
가치 함정 후보
제외 후보
```

---

### 11.4 Turnaround Engine — 턴어라운드 엔진

```text
적자 축소
매출 회복
영업이익률 개선
재고 감소
부채 부담 완화
업황 바닥 통과
```

---

### 11.5 Event Radar — 대규모 계약/수주/입찰 전 레이더

```text
조선 수주
방산 수출
원전 수주
AI 데이터센터 전력 계약
반도체 장비 발주
해외 인프라 계약
정책 발표
규제 승인
```

로직:

```text
이벤트 후보 등록
→ 발주처/경쟁사/과거 수주 이력 확인
→ 수주 가능성 시나리오
→ 주가 선반영 여부 확인
→ 실패 시 하락 리스크
→ 보유/관망/비중축소/헷지 후보 제시
```

---

### 11.6 Disclosure Miner — 공시 시즌 채굴기

공시 시즌의 실적 개선·저평가 후보를 찾습니다.

```text
실적 개선
EPS 증가
PER 하락
PBR 낮음
ROE 회복
영업이익률 개선
부채비율 하락
뉴스량 낮음
주가 미반응
```

로직:

```text
실적 발표
→ 전년동기 대비 성장 확인
→ PER/PBR/ROE 재계산
→ 뉴스량 확인
→ 주가 반응 확인
→ 아직 덜 반응한 종목 발굴
```

---

### 11.7 Recognition Heat Engine — 시장 인지도 엔진

뉴스는 여기서 사용됩니다.

```text
뉴스 없음
→ 시장 미인지 가능성

뉴스 초기 증가
→ 관심 발생, 검증 필요

뉴스 폭증
→ 대중 확산, 추격 경고

뉴스 피크
→ 신규 매수보다 매도/관망/익절 점검
```

---

## 12. Opportunity Scoring Logic — 기회 점수화

### 12.1 Hidden Value Score

```text
Hidden Value Score
= 저평가 점수
+ 수익성 개선 점수
+ 성장성 개선 점수
+ 재무 안정성 점수
+ 뉴스 저소음 점수
+ 거래대금 초기 변화 점수
- 가치 함정 위험 점수
- 희석/CB/유상증자 위험 점수
```

### 12.2 Disclosure Surprise Score

```text
Disclosure Surprise Score
= 매출 증가율
+ 영업이익 증가율
+ EPS 증가율
+ 영업이익률 개선
+ 부채비율 하락
+ 현금흐름 개선
- 일회성 이익
- 희석 리스크
- 감사/소송/규제 리스크
```

### 12.3 Trend Fit Score

```text
Trend Fit Score
= 장기 트렌드 적합도
+ 밸류체인 핵심성
+ 실제 매출 연결성
+ 기술/계약 검증
+ ETF 대체 가능성
- 테마 과열도
- 실체 부족 위험
```

### 12.4 Event Probability Score

```text
Event Probability Score
= 발주처 예산/정책 적합성
+ 과거 수주 이력
+ 경쟁사 대비 우위
+ 공시/언론 신뢰도
+ 주가 선반영 낮음
- 실패 시 하락 리스크
- 루머 의존도
```

---

## 13. Engine → Screen → Action Mapping

### 13.1 Long Trend Engine

```text
엔진
→ 장기 기술/산업 흐름 추적

화면
→ /theme, /app, /asset/:code

사용자 행동
→ 테마 지도 확인
→ ETF/개별주 후보 비교
→ 덜 알려진 밸류체인 상세 분석
```

### 13.2 Hidden Value Engine

```text
엔진
→ 저평가/개선 후보 발굴

화면
→ /app, /asset/:code

사용자 행동
→ 숨은 저평가 후보 클릭
→ Valuation Lens 확인
→ 가치 함정 여부 판단
```

### 13.3 Disclosure Miner

```text
엔진
→ 공시 시즌 실적/재무 변화 채굴

화면
→ /app, /disclosure-season, /asset/:code

사용자 행동
→ 실적 개선 후보 확인
→ 공시 원문 및 재무 변화 검증
→ Decision Draft 생성
```

### 13.4 Event Radar

```text
엔진
→ 대형 계약/수주/정책 이벤트 추적

화면
→ /app, /event, /asset/:code, /portfolio

사용자 행동
→ 성공/실패 시나리오 확인
→ 보유/관망/비중축소/헷지 후보 검토
```

### 13.5 Recognition Heat Engine

```text
엔진
→ 뉴스량과 대중 인지도 측정

화면
→ /app, /asset/:code

사용자 행동
→ 시장 미인지/과열 여부 확인
→ 추격매수 방지
→ 보유 종목 익절/리스크 점검
```

---

## 14. 전체 화면 구조

```text
/
브랜드 인덱스

/goal
목표의 결 — 7년 내 주거/학군 이동 목표, 필요 자본, 필요 수익률

/app
오늘의 결 — 목표 달성을 위한 기회 발굴 레이더

/theme
미래의 결 — 장기 트렌드, 기술 변화, 테마 맵

/disclosure-season
공시 시즌 모드 — 실적 개선·저평가 후보 채굴

/event
이벤트 레이더 — 대형 계약/수주/정책 이벤트 시나리오

/asset/:code
종목의 결 — PER/PBR/ROE/EPS 기반 상세 분석

/portfolio
전략의 결 — 목표 연동 포트폴리오, 현금, 리스크, 포지션 배분

/decision/:id
판단의 결 — 판단 로그 상세, 결과 추적, 복기

/reflection
과거의 결 — 반복 실수, 성공 패턴, 로직 강화

/settings
API 연결, 데이터 상태, 원칙 설정
```

---

## 15. `/goal` — 목표의 결

### 목적

7년 내 주거/학군 목표를 달성하기 위한 필요 자본과 수익 구조를 계산합니다.

### 주요 입력

```text
현재 주택 가치
현재 대출 잔액
현재 월 상환액
월 고정지출
현금 보유액
투자 가능 현금
목표 지역
목표 주택 가격
목표 시점
```

### 주요 출력

```text
현재 순자산
필요 자본 갭
남은 기간
연간 필요 자산 증가액
월간 필요 자산 증가액
필요 수익률
위험 허용 범위
투자 강도
```

---

## 16. `/app` — 오늘의 결, Opportunity Radar

### 목적

오늘 무엇을 봐야 하는지 알려주는 기회 발굴 레이더입니다.

### 주요 영역

```text
1. 목표 진행률
2. 필요 수익률 대비 현재 속도
3. 오늘의 장기 트렌드
4. 숨은 저평가 후보
5. 턴어라운드 후보
6. 장기 트렌드 후보
7. 이벤트 전 후보
8. 공시 시즌 후보
9. 과열/매도 점검 후보
10. 복기 예정 판단
```

### 후보 바구니

```text
A. 숨은 저평가 후보
B. 턴어라운드 후보
C. 장기 트렌드 후보
D. 이벤트 전 후보
E. 공시 시즌 후보
F. 과열/매도 점검 후보
G. 제외 후보
```

---

## 17. `/theme` — 미래의 결

장기 트렌드와 미래 기술 밸류체인을 관리합니다.

```text
왜 중요한가
현재 산업 단계
핵심 밸류체인
ETF 후보
국내외 관련 종목
이미 과열된 종목
아직 덜 본 하위 밸류체인
```

---

## 18. `/disclosure-season` — 공시 시즌 모드

공시 시즌에는 결의 발굴력이 가장 강해져야 합니다.

```text
실적 개선인데 뉴스 적은 기업
EPS 증가율 상위
PER 재평가 후보
PBR 낮고 ROE 회복 후보
영업이익률 개선 후보
부채비율 하락 후보
현금흐름 개선 후보
유상증자/CB 위험 후보
```

---

## 19. `/event` — 이벤트 레이더

```text
대형 수주
입찰
정책 발표
금리 결정
실적 발표
신제품 공개
규제 승인
상장/IPO
락업 해제
M&A
분할/합병
```

이벤트 화면은 성공/실패 양방향 시나리오를 제공합니다.

```text
성공 시나리오
실패 시나리오
선반영 여부
하락 리스크
보유자 대응
신규 진입 여부
헷지 후보
```

---

## 20. `/asset/:code` — 종목의 결, Asset Lens

### 목적

이 종목이 좋은 기업인지, 좋은 가격인지, 지금 살 구간인지 판단합니다.

### 화면 구성

```text
1. 왜 발굴됐는가
2. 종목 요약
3. 결의 현재 판단
4. Valuation Lens
5. Growth Reflection
6. News Heat
7. Disclosure & Risk
8. Supply & Price
9. Flashback
10. Decision Draft
```

### Valuation Lens

```text
현재가
시가총액
PER
Forward PER
PBR
ROE
EPS
매출 성장률
영업이익 성장률
영업이익률
부채비율
현금흐름
```

### Growth Reflection

```text
성장성 반영도: 0~100
```

종합 요소:

```text
PER 부담
PBR 프리미엄
ROE 지속성
EPS 성장률
매출 성장률
영업이익 성장률
뉴스 과열도
가격 위치
거래대금 변화
수급 방향
```

### Decision Draft

```text
판단
찬성 근거
반대 근거
무효 조건
실행 조건
관망 이유
대안 전략
```

---

## 21. `/portfolio` — 전략의 결

목표 달성을 위한 자산 배분과 리스크를 관리합니다.

```text
목표까지 남은 자본 갭
현재 투자 포트폴리오
현재 현금
현재 위험 노출
목표 달성 확률
현재 속도로 달성 가능 여부
올해 필요한 수익
이번 달 필요한 순증
현재 전략이 목표에 비해 보수적인지/공격적인지
헷지 필요 여부
```

---

## 22. `/decision/:id` — 판단의 결

판단 로그 상세 화면입니다.

### 저장 항목

```text
판단 시점
종목
판단 유형
당시 가격
당시 PER/PBR/ROE/EPS
당시 뉴스 단계
당시 시장 모드
찬성 근거
반대 근거
무효 조건
실행 조건
관망 이유
최종 사용자 선택
```

### 결과 라벨

수익/손실만으로 판단을 평가하지 않습니다.

```text
좋은 판단 / 좋은 결과
좋은 판단 / 나쁜 결과
나쁜 판단 / 좋은 결과
나쁜 판단 / 나쁜 결과
판단 불충분 / 결과 보류
```

---

## 23. `/reflection` — 과거의 결

결이 lv1에서 lv2000으로 가는 화면입니다.

```text
반복 손실 패턴
반복 성공 패턴
뉴스 피크 추격매수 빈도
가치 함정 진입 기록
분할매수 성공/실패
무효 조건 미설정 빈도
섹터 쏠림 손실
목표 대비 전략 괴리
```

---

## 24. Execution Pre-check — 실행 전 체크리스트

판단 실행 전 결은 반드시 아래를 확인합니다.

```text
목표와 맞는가?
총 투자금 대비 비중은 적절한가?
손실 시 주거 목표를 훼손하지 않는가?
찬성 근거가 충분한가?
반대 근거가 기록됐는가?
무효 조건이 있는가?
뉴스 피크가 아닌가?
가격 반영도가 과도하지 않은가?
과거 플래시백을 확인했는가?
리스크 예산을 초과하지 않는가?
```

---

## 25. API 설계

최종 모드 기준으로 필요한 API는 다음과 같습니다.

### 25.1 목표/부동산

```text
국토교통부 실거래가 API
한국부동산원 부동산통계 API
```

용도:

```text
현재 주택/목표 지역 실거래가 추적
목표 주택 가격 추정
지역별 가격 동향 확인
```

### 25.2 주식/재무

```text
KIS Developers
OpenDART
```

용도:

```text
현재가
시가총액
PER
PBR
ROE
EPS
수익성비율
안정성비율
성장성비율
공시
정기보고서
재무제표
```

### 25.3 뉴스/인지도

```text
Naver News API
GDELT
```

용도:

```text
뉴스량
뉴스 단계
대중 과열도
글로벌 테마 흐름
```

### 25.4 AI

```text
Cloudflare Workers AI
OpenAI 또는 Azure OpenAI
```

용도:

```text
요약
반문
판단 초안
복기
로직 업데이트 제안
```

---

## 26. 현재 기술 구성

```text
Frontend
- Cloudflare Pages
- HTML/CSS/JavaScript
- Pretendard 기반 UI

Backend
- Cloudflare Pages Functions

Database
- Cloudflare D1

Cache
- Cloudflare KV

Storage
- Cloudflare R2

Data Sources
- Naver News API 연결 완료
- OpenDART 예정
- KIS Developers 예정
- GDELT 예정
- 국토교통부 실거래가 예정
- 한국부동산원 예정
```

---

## 27. 현재 API

### Health Check

```text
GET /api/health
```

### News Search

```text
GET /api/news/search?q=검색어
GET /api/news/search?q=검색어&save=1
```

### Decisions

```text
GET /api/decisions
POST /api/decisions
```

---

## 28. 개발 우선순위

이 프로젝트는 MVP 축소 방식으로 진행하지 않습니다.

최종 모드 기준의 전체 구조를 먼저 구축합니다.

```text
Phase 1
- README/철학/구조 확정
- D1 전체 테이블 확장
- /goal /app /theme /disclosure-season /event /asset /portfolio /decision /reflection 화면 골격 구축

Phase 2
- 목표 계산 엔진
- 부동산 실거래가 API
- 목표 주택 가격 추적
- Strategy Intensity Engine
- Survival Guard

Phase 3
- KIS/OpenDART 연결
- PER/PBR/ROE/EPS/재무비율 수집
- Hidden Value Engine
- Disclosure Miner

Phase 4
- Long Trend Engine
- Theme Pulse Engine
- Event Radar
- Recognition Heat Engine

Phase 5
- Asset Lens
- Decision Draft
- Decision Log
- Reflection Engine

Phase 6
- Portfolio Strategy
- 위험 예산
- 사용자 승인 기반 실행 후보
```

---

## 29. 금지사항

```text
기능 축소형 MVP로 방향 전환 금지
뉴스 검색기로 축소 금지
가짜 데이터로 화면 채우기 금지
API 실패를 성공처럼 보이기 금지
AI가 모르는 값을 지어내기 금지
뉴스만 보고 매수/매도 판단 금지
사용자 승인 없는 주문 금지
자동매매 우선 개발 금지
목표와 무관한 투자 추천 금지
```

---

## 30. 결의 최종 방향

결은 다음을 지향합니다.

```text
Bloomberg처럼 복잡하지 않고,
토스처럼 단순하지만,
증권앱보다 더 깊고,
리딩방보다 훨씬 냉정하고,
AI 챗봇보다 훨씬 구조화된 투자 튜터.
```

결은 수익을 예언하지 않습니다.

결은 목표를 계산하고, 기회를 발굴하고, 종목을 해부하고, 판단을 기록하고, 과거를 플래시백하고, 미래 시나리오를 현재 전략으로 번역합니다.

> **결은 목표에서 시작해, 시장의 소음 속 숨은 가격 왜곡과 기회를 찾는 개인 투자 운영체계입니다.**
