# BatchuKis Database Schema Definition

이 문서는 데이터베이스 설계를 위한 테이블 명세서입니다. 모든 컬럼명은 [models.md](./models.md)의 필드명과 일치해야 합니다.

---

## 1. System & Config (설정 제어)

### 1.1 `api_settings` (전체 시스템 설정)
- **Primary Key**: `id` (INTEGER, ALWAYS 1)
- **Columns**:
    - `appKey`, `appSecret`, `accountNumber`: TEXT
    - `useTelegram`, `useNaverNews`: BOOLEAN
    - `telegramToken`, `telegramChatId`: TEXT
    - `naverClientId`, `naverClientSecret`: TEXT
    - `kisApiDelayMs`, `newsScrapIntervalMin`: INTEGER
    - `preferredNewsAiId`, `preferredStockAiId`, `preferredNewsJudgementAiId`, `preferredAutoBuyAiId`, `preferredAutoSellAiId`: TEXT (FK to `ai_configs.id`)

### 1.2 `ai_configs` (AI 엔진 프로필 저장소)
- **Primary Key**: `id` (TEXT)
- **Columns**: `name`, `providerType`, `modelName`, `baseUrl` (TEXT)

---

## 2. Account & Portfolio (자산 데이터)

### 2.1 `account_status` (계좌 요약 정보)
- **Primary Key**: `id` (INTEGER, ALWAYS 1)
- **Columns**: `totalAssets`, `buyingPower`, `dailyProfit`, `dailyProfitRate` (REAL)
- **Update Frequency**: API 동기화 마다 갱신.

### 2.2 `holdings` (보유 자산 목록)
- **Primary Key**: `stockCode` (TEXT)
- **Columns**: `stockName` (TEXT), `quantity` (INTEGER), `avgPrice`, `currentPrice`, `profit`, `profitRate`, `marketValue` (REAL)

---

## 3. Market & Discovery (시세 및 탐색 데이터)

### 3.1 `master_stocks` (전체 종목 마스터)
- **Primary Key**: `code` (TEXT)
- **Columns**: 
    - `name`, `market` (TEXT)
    - `per`, `pbr`, `roe`, `marketCap`, `dividendYield` (REAL)
    - `memo` (TEXT), `isHidden` (BOOLEAN)
- **용도**: 종목 검색, 메타데이터 제공 및 사용자 설정(메모/숨김) 저장.

### 3.2 `news_cache` (뉴스 및 분석 캐시)
- **Primary Key**: `news_id` (TEXT - URL 해시 등)
- **Columns**: 
    - `title`, `description`, `link`, `pubDate`: TEXT
    - `sentiment`: TEXT
    - `relatedThemes`, `relatedStocks`: TEXT (JSON Array)
- **용도**: 동일 뉴스에 대한 중복 AI 분석 방지 및 히스토리 제공.

### 3.3 `discovery_ranking_cache` (발굴 랭킹 데이터)
- **Primary Key**: `category` + `market` (Composite)
- **Columns**: `updated_at` (DATETIME), `items_json` (TEXT - `StockItem[]` JSON)

### 3.4 `stock_stats` (종목별 확장 통계)
- **Primary Key**: `code` (TEXT)
- **Columns**: 
    - `tradingValue` (REAL)
    - `buyRatio`, `sellRatio`, `foreignNetBuy`, `institutionalNetBuy` (INTEGER)
    - `aiScoreBuy`, `aiScoreSell` (INTEGER)
- **용도**: `StockItem` 확장을 위한 분석/수급 데이터 저장.

---

## 4. Watchlist (보관함)

### 4.1 `watchlist_groups` (그룹 정의)
- **Primary Key**: `id` (TEXT)
- **Columns**: `name` (TEXT), `market` (TEXT)

### 4.2 `watchlist_items` (그룹별 포함 종목)
- **Primary Key**: `group_id` + `stock_code` (Composite)
- **Columns**: `added_at` (DATETIME)
- **Relationship**: `group_id` -> `watchlist_groups.id`

---

## 5. Trading & Automation (거래 및 자동화)

### 5.1 `trade_history` (전체 체결 내역)
- **Primary Key**: `id` (TEXT)
- **Columns**: 
    - `stockCode`, `stockName`, `type` (TEXT)
    - `quantity` (INTEGER), `price` (REAL)
    - `timestamp` (DATETIME), `status` (TEXT)

### 5.2 `auto_trade_robots` (자동매매 전략 로봇)
- **Primary Key**: `id` (TEXT)
- **Columns**: 
    - `stockCode`, `stockName`, `groupId`, `type`, `frequency`, `executionTime`, `market`: TEXT
    - `quantity`, `specificDay`: INTEGER
    - `trailingPercent`: REAL
    - `active`: BOOLEAN

### 5.3 `reserved_orders` (실시간 감시 주문)
- **Primary Key**: `id` (TEXT)
- **Columns**: 
    - `stockCode`, `stockName`, `type`, `monitoringType`, `trailingType`, `status`, `market`: TEXT
    - `quantity`: INTEGER
    - `triggerPrice`, `trailingValue`, `stopLossValue`, `highestPrice`, `lowestPrice`: REAL
    - `useStopLoss`, `sellAll`: BOOLEAN
    - `stopLossType`: TEXT
    - `createdAt`, `expiryDate`: DATETIME