ivada-infra/DOCS
3
0
Fork 0
Code Issues 1 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
DOCS/300_architecture/database/tables.md
happybell80 98a44d1733 UUID 문서 업데이트: Slack UUID 변환 실패 시 에러 처리 추가 
- 파일명 날짜 250911 → 250924로 변경
- 의사코드 제거하여 가독성 개선
- Slack ID→UUID 변환 실패 시 403 에러 반환 방안 추가
- DB 현황과 tables.md 문서 불일치 수정 (rb_news 테이블 추가)

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-24 13:30:53 +09:00

319 lines
12 KiB
Markdown
Raw Blame History

# PostgreSQL 테이블 구조
## 작성일: 2025-08-20
## 최종 수정일: 2025-09-24
## 데이터베이스: main_db
---
## 1. 조직 관련 테이블
### company
- **용도**: 회사 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 회사 ID |
| name | VARCHAR(255) | NO | | 회사명 |
| url | VARCHAR(255) | YES | | 회사 URL |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
### team
- **용도**: 팀 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 팀 ID |
| company_id | UUID | NO | | 회사 ID (FK → company) |
| name | VARCHAR(32) | NO | | 팀 이름 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
### user
- **용도**: 시스템 사용자 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 사용자 ID |
| team_id | UUID | NO | | 팀 ID (FK → team) |
| email | VARCHAR(255) | NO | | 이메일 (UNIQUE) |
| name | VARCHAR(255) | YES | | 사용자명 |
| picture | VARCHAR(500) | YES | | 프로필 이미지 |
| oauth_provider | VARCHAR(50) | YES | | OAuth 제공자 |
| oauth_id | VARCHAR(255) | YES | | OAuth ID |
| is_active | BOOLEAN | YES | | 활성 상태 |
| last_login_at | TIMESTAMPTZ | YES | | 마지막 로그인 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
| username | VARCHAR(64) | YES | | 사용자명 |
### workspace_member
- **용도**: 워크스페이스 멤버십
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 멤버십 ID |
| user_id | UUID | NO | | 사용자 ID (FK → user) |
| role | user_role | NO | GUEST | 역할 (OWNER/MEMBER/GUEST) |
| is_active | BOOLEAN | YES | | 활성 상태 |
| joined_at | TIMESTAMP | YES | CURRENT_TIMESTAMP | 가입 시각 |
| updated_at | TIMESTAMP | YES | CURRENT_TIMESTAMP | 수정 시각 |
---
## 2. 제품 및 로빙 테이블
### product
- **용도**: 제품 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 제품 ID |
| name | VARCHAR(32) | NO | | 제품명 |
| app_id | VARCHAR(16) | YES | | 앱 ID |
| scope | JSON | YES | | 권한 범위 |
| description | VARCHAR(256) | YES | | 설명 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
### robeing
- **용도**: 로빙 엔티티 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 로빙 ID |
| product_id | UUID | NO | | 제품 ID (FK → product) |
| team_id | UUID | NO | | 팀 ID (FK → team) |
| name | VARCHAR(32) | YES | | 로빙 이름 |
| level | INTEGER | YES | 1 | 레벨 |
| experience | INTEGER | YES | 0 | 경험치 |
| memory | INTEGER | YES | 10 | 메모리 스탯 |
| compute | INTEGER | YES | 10 | 연산 스탯 |
| react | INTEGER | YES | 10 | 반응 스탯 |
| empathy | INTEGER | YES | 10 | 공감 스탯 |
| leadership | INTEGER | YES | 10 | 리더십 스탯 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| robeing_container_id | VARCHAR(64) | YES | | 컨테이너 ID |
| robeing_container_url | VARCHAR(128) | YES | | 컨테이너 URL |
---
## 3. Slack 통합 테이블
### slack_workspace
- **용도**: Slack 워크스페이스 정보
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 워크스페이스 ID |
| team_id | UUID | NO | | 팀 ID (FK → team) |
| slack_team_id | VARCHAR(32) | YES | | Slack 팀 ID |
| bot_token | VARCHAR(255) | YES | | 봇 토큰 |
| is_enterprise_install | BOOLEAN | YES | | 엔터프라이즈 설치 |
| is_active | BOOLEAN | YES | | 활성 상태 |
| installed_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 설치 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
---
## 4. 사용자 설정 및 토큰 테이블
### user_preference
- **용도**: 사용자 개인 설정
- **Primary Key**: id (INTEGER)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | INTEGER | NO | | 설정 ID |
| user_id | UUID | NO | | 사용자 ID (FK → user) |
| slack_user_id | VARCHAR(32) | YES | | Slack 사용자 ID |
| news_keywords | VARCHAR(128)[] | YES | | 뉴스 키워드 |
| email_filter | VARCHAR(128)[] | YES | | 이메일 필터 |
| briefing_enabled | BOOLEAN | YES | true | 브리핑 활성화 |
| briefing_time | TIME | YES | 09:00:00 | 브리핑 시간 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
### gmail_token
- **용도**: Gmail OAuth 토큰
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 토큰 ID |
| user_id | UUID | NO | | 사용자 ID (FK → user) |
| token_data | JSONB | YES | | 토큰 데이터 |
| oauth_config | JSONB | YES | | OAuth 설정 |
| scopes | JSONB | YES | | 권한 범위 |
| metadata | JSONB | YES | | 메타데이터 |
| expiry | TIMESTAMP | YES | | 만료 시각 |
| is_equipped | BOOLEAN | YES | false | 장착 상태 |
| equipped_to | VARCHAR(50) | YES | | 장착 대상 |
| token_type | VARCHAR | YES | Bearer | 토큰 타입 |
| expires_at | DOUBLE PRECISION | YES | | 만료 시간 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
---
## 5. 로그 및 데이터 테이블
### conversation_log
- **용도**: 대화 기록
- **Primary Key**: id (INTEGER)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | INTEGER | NO | | 로그 ID |
| user_id | UUID | NO | | 사용자 ID (FK → user) |
| channel_id | VARCHAR(16) | YES | | 채널 ID |
| message | VARCHAR | YES | | 사용자 메시지 |
| response | VARCHAR | YES | | 응답 메시지 |
| intent | VARCHAR(256) | YES | | 의도 분석 |
| confidence | DOUBLE PRECISION | YES | | 신뢰도 |
| thread_ts | VARCHAR(128) | YES | | 스레드 타임스탬프 |
| timestamp | TIMESTAMPTZ | YES | | 대화 시각 |
| channel_type | VARCHAR(32) | YES | | 채널 타입 |
### news
- **용도**: 뉴스 데이터
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | | 뉴스 ID |
| user_id | UUID | YES | | 사용자 ID (FK → user) |
| data | JSONB | YES | | 뉴스 데이터 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
### rb_news
- **용도**: 뉴스 발행 관리
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | gen_random_uuid() | 뉴스 ID |
| title | TEXT | NO | | 뉴스 제목 |
| url | TEXT | NO | | 뉴스 URL (UNIQUE) |
| summary | TEXT | YES | | 뉴스 요약 |
| slack_message_ts | VARCHAR(100) | YES | | Slack 메시지 타임스탬프 |
| slack_channel_id | VARCHAR(100) | YES | | Slack 채널 ID |
| is_published | BOOLEAN | YES | false | 발행 상태 |
| published_at | TIMESTAMPTZ | YES | | 발행 시각 |
| created_at | TIMESTAMPTZ | YES | now() | 생성 시각 |
**인덱스**:
- `rb_news_pkey`: PRIMARY KEY (id)
- `rb_news_url_key`: UNIQUE (url)
- `idx_rb_news_url`: btree (url)
- `idx_rb_news_slack_message_ts`: btree (slack_message_ts)
- `idx_rb_news_created_at`: btree (created_at DESC)
### team_document
- **용도**: 팀 문서 RAG 시스템
- **Primary Key**: id (UUID)
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | gen_random_uuid() | 문서 ID |
| team_id | UUID | NO | | 팀 ID (FK → team) |
| filename | VARCHAR(255) | NO | | 파일명 |
| file_hash | VARCHAR(64) | NO | | SHA256 해시 |
| file_size | BIGINT | YES | | 파일 크기 (bytes) |
| mime_type | VARCHAR(100) | YES | | MIME 타입 |
| storage_path | TEXT | NO | | 저장 경로 (/mnt/hdd/uploads/{team_id}/) |
| text_content | TEXT | YES | | 추출된 텍스트 |
| chunk_count | INTEGER | YES | 0 | ChromaDB 청크 수 |
| processing_status | VARCHAR(20) | YES | 'pending' | 처리 상태 (pending/completed/failed) |
| metadata | JSONB | YES | '{}' | 메타데이터 (uploaded_by, tags, summary 등) |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
**인덱스**:
- `idx_team_doc_hash`: UNIQUE (team_id, file_hash) - 팀별 파일 중복 방지
---
### naverworks_token
- **용도**: NAVER WORKS OAuth 토큰 및 Passport 정보
- **Primary Key**: id (UUID)
- **Unique**: user_id
- **Foreign Key**: user_id → user(id) ON DELETE CASCADE
| 컬럼명 | 타입 | NULL | 기본값 | 설명 |
|--------|------|------|--------|------|
| id | UUID | NO | gen_random_uuid() | 토큰 ID |
| user_id | UUID | NO | | 사용자 ID (FK → user) |
| access_token | TEXT | YES | | 액세스 토큰 (개별 저장용) |
| refresh_token | TEXT | YES | | 리프레시 토큰 (개별 저장용) |
| token_type | VARCHAR(50) | YES | 'Bearer' | 토큰 타입 |
| expires_at | TIMESTAMP | YES | | 토큰 만료 시각 |
| scopes | JSONB | YES | | OAuth 스코프 목록 |
| domain_id | VARCHAR(255) | YES | | NAVER WORKS 도메인 ID |
| service_account | VARCHAR(255) | YES | | 서비스 계정 |
| metadata | JSONB | YES | | 사용자 메타데이터 |
| created_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 생성 시각 |
| updated_at | TIMESTAMPTZ | YES | CURRENT_TIMESTAMP | 수정 시각 |
| username | VARCHAR(255) | YES | | 사용자명 |
| account_id | VARCHAR(255) | YES | | NAVER WORKS 계정 ID |
| token_data | JSONB | YES | | 토큰 데이터 (통합 저장용) |
| oauth_config | JSONB | YES | | OAuth 설정 정보 |
| expiry | TIMESTAMP | YES | | 토큰 만료 시각 (passport용) |
| is_equipped | BOOLEAN | YES | false | Passport 장착 여부 |
**인덱스**:
- idx_naverworks_token_user_id (user_id)
- idx_naverworks_token_expires_at (expires_at)
**트리거**:
- update_naverworks_token_updated_at: updated_at 자동 갱신
## 6. 기타 정보
### Custom Types
- **user_role**: ENUM (OWNER, MEMBER, GUEST)
### Functions
- **update_column_updated_at**: 모든 테이블의 updated_at 자동 갱신 트리거
### 외래키 관계
| 테이블 | 컬럼 | 참조 테이블 | 참조 컬럼 |
|--------|------|------------|----------|
| team | company_id | company | id |
| user | team_id | team | id |
| robeing | product_id | product | id |
| robeing | team_id | team | id |
| slack_workspace | team_id | team | id |
| workspace_member | user_id | user | id |
| conversation_log | user_id | user | id |
| gmail_token | user_id | user | id |
| news | user_id | user | id |
| user_preference | user_id | user | id |
| team_document | team_id | team | id |
---
## 주의사항
### 데이터베이스 정보
- **소유자**: 모든 테이블 robeings 소유
- **타임스탬프**: TIMESTAMPTZ 사용 (WITH TIME ZONE)
- **자동 갱신**: update_column_updated_at 트리거로 updated_at 자동 관리
- **UUID 기반**: 주요 테이블 모두 UUID 사용
---
**문서 끝**
Reference in New Issue View Git Blame Copy Permalink