happybell80 ef39716c19 docs: DB 테이블 구조 업데이트 및 rb8001 크론잡 트러블슈팅 문서 추가

- tables.md: 실제 DB 구조에 맞게 수정
  - gmail_tokens 테이블 추가 컬럼 반영 (access_token, refresh_token 등)
  - robeing_stats 테이블 컬럼 수정 (email_sent_count 제거, name 추가)
  - 테이블 소유자 정보 업데이트
  - gmail_tokens_old 백업 테이블 문서화

- rb8001 일일 요약 크론잡 실패 분석 문서 신규 작성
  - Gateway-rb8001-skill 서비스 간 플로우 문서화
  - skill-email 500 에러 원인 분석 (auth_db 부재)
  - 해결 방안 및 모니터링 포인트 제시

2025-08-25 00:18:19 +09:00

11 KiB

Raw Blame History

PostgreSQL 테이블 구조

작성일: 2025-08-20

최종 수정일: 2025-08-24

데이터베이스: main_db

1. 사용자 관련 테이블

users

용도: 시스템 전체 사용자 정보
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		사용자 고유 식별자
email	VARCHAR(255)	NO		이메일 주소 (UNIQUE)
name	VARCHAR(255)	YES		사용자 실명
username	VARCHAR(50)	YES		로그인 ID (UNIQUE)
picture	VARCHAR(500)	YES		프로필 이미지 URL
oauth_provider	VARCHAR(50)	YES		OAuth 제공자 (google 등)
oauth_id	VARCHAR(255)	YES		OAuth 고유 ID
is_active	BOOLEAN	YES	true	활성 상태
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각
last_login_at	TIMESTAMP	YES		마지막 로그인

2. Workspace 관련 테이블

workspaces

용도: 워크스페이스 정보
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		워크스페이스 ID
name	VARCHAR(255)	NO		워크스페이스 이름
company_id	UUID	YES		회사 ID (FK → companies)
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

workspace_members

용도: 워크스페이스 멤버 관계
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		멤버십 ID
workspace_id	UUID	NO		워크스페이스 ID (FK → workspaces)
user_id	UUID	NO		사용자 ID (FK → users)
role	ENUM	YES	member	역할 (admin/member)
robeing_id	VARCHAR(50)	YES		할당된 로빙 ID
robeing_url	VARCHAR(255)	YES		로빙 서비스 URL
is_active	BOOLEAN	YES	true	활성 상태
joined_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	가입 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

companies

용도: 회사 정보
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		회사 ID
name	VARCHAR(255)	NO		회사명
domain	VARCHAR(255)	YES		도메인
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

3. Slack 통합 테이블

slack_workspaces

용도: Slack 워크스페이스 정보
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		워크스페이스 ID
team_id	VARCHAR(50)	NO		Slack Team ID (UNIQUE)
team_name	VARCHAR(255)	YES		팀 이름
bot_token	TEXT	YES		Bot User OAuth Token
bot_user_id	VARCHAR(50)	YES		Bot User ID
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

slack_user_mapping

용도: Slack 사용자와 시스템 사용자 매핑
Primary Key: id (UUID)

컬럼명	타입	NULL	기본값	설명
id	UUID	NO		매핑 ID
slack_user_id	VARCHAR(50)	NO		Slack User ID (U로 시작)
slack_workspace_id	UUID	YES		Slack 워크스페이스 ID (FK → slack_workspaces)
user_id	UUID	NO		시스템 사용자 ID (FK → users)
workspace_member_id	UUID	YES		워크스페이스 멤버 ID (FK → workspace_members)
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

4. Gmail 관련 테이블

gmail_tokens

용도: Gmail OAuth 토큰 저장
Primary Key: id (SERIAL)
소유자: robeings

컬럼명	타입	NULL	기본값	설명
id	SERIAL	NO		토큰 ID
user_id	UUID	NO		사용자 ID (FK → users) (UNIQUE)
username	VARCHAR(50)	YES		사용자명 (users.username과 동일)
slack_id	VARCHAR(50)	YES		Slack User ID (U로 시작)
robeing_id	VARCHAR(50)	YES		로빙 ID
token_data	JSONB	YES		access_token, refresh_token, token_type 등
oauth_config	JSONB	YES		client_id, client_secret, token_uri
scopes	JSONB	YES		Gmail API 권한 목록
metadata	JSONB	YES		email, name, picture, verified_email 등
expiry	TIMESTAMP	YES		토큰 만료 시각
is_equipped	BOOLEAN	YES	false	장착 상태
equipped_to	VARCHAR(50)	YES		장착된 로빙 ID
access_token	TEXT	YES		직접 저장된 액세스 토큰
refresh_token	TEXT	YES		직접 저장된 리프레시 토큰
token_type	VARCHAR	YES	'Bearer'	토큰 타입
expires_at	DOUBLE PRECISION	YES		토큰 만료 시간 (Unix timestamp)
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

gmail_audit_logs

용도: Gmail 아이템 작업 감사 로그
Primary Key: id (SERIAL)
소유자: postgres (권한 조정 필요)

컬럼명	타입	NULL	기본값	설명
id	SERIAL	NO		로그 ID
user_id	UUID	YES		사용자 ID (FK → users)
robeing_id	VARCHAR(50)	YES		로빙 ID
action	VARCHAR(50)	YES		작업 유형 (equip/unequip/reauth)
success	BOOLEAN	YES		성공 여부
details	JSONB	YES		상세 정보
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각

gmail_tokens_old

용도: gmail_tokens 테이블 백업 (마이그레이션 과정 중 생성)
Primary Key: id (SERIAL)
소유자: robeings
참고: 이전 구조의 백업 테이블로, 향후 제거 가능

컬럼명	타입	NULL	기본값	설명
(구조는 gmail_tokens와 유사하나 이전 버전)				마이그레이션 전 데이터 보관용

5. 로빙 관련 테이블

robeing_stats

용도: 로빙 통계 및 레벨 정보
Primary Key: id (SERIAL)
소유자: postgres (권한 조정 필요)

컬럼명	타입	NULL	기본값	설명
id	SERIAL	NO		통계 ID
user_id	UUID	YES		사용자 ID (FK → users)
robeing_id	VARCHAR(50)	NO		로빙 ID (UNIQUE)
name	VARCHAR(100)	YES		로빙 이름
level	INTEGER	YES	1	현재 레벨
experience	INTEGER	YES	0	경험치
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

robeing_settings

용도: 로빙 설정 정보
Primary Key: id (SERIAL)

컬럼명	타입	NULL	기본값	설명
id	SERIAL	NO		설정 ID
robeing_id	VARCHAR(50)	NO		로빙 ID (UNIQUE)
settings	JSONB	YES		설정 JSON
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

6. robeing 전용 스키마 테이블

robeing.contacts

용도: 로빙이 관리하는 연락처 정보
Primary Key: id (UUID)
스키마: robeing

컴럼명	타입	NULL	기본값	설명
id	UUID	NO	gen_random_uuid()	연락처 ID
robeing_id	VARCHAR(50)	NO		로빙 ID
name	VARCHAR(100)	NO		이름
email	VARCHAR(255)	YES		이메일 주소
phone	VARCHAR(50)	YES		전화번호
company	VARCHAR(200)	YES		회사명
relationship	VARCHAR(100)	YES		관계 (동료, 고객 등)
notes	TEXT	YES		메모
extra	JSONB	YES	{}	추가 정보
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각
updated_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	수정 시각

robeing.conversations

용도: 로빙 대화 기록
Primary Key: id (UUID)
스키마: robeing

컴럼명	타입	NULL	기본값	설명
id	UUID	NO	gen_random_uuid()	대화 ID
robeing_id	VARCHAR(50)	NO		로빙 ID
user_message	TEXT	YES		사용자 메시지
robeing_response	TEXT	YES		로빙 응답
context	JSONB	YES	{}	대화 컨텍스트
metadata	JSONB	YES	{}	메타데이터
timestamp	TIMESTAMP	YES	CURRENT_TIMESTAMP	대화 시각

7. 대화 로그 테이블

conversation_logs

용도: 대화 기록 저장
Primary Key: id (SERIAL)

컬럼명	타입	NULL	기본값	설명
id	SERIAL	NO		로그 ID
user_id	UUID	YES		사용자 ID (FK → users)
robeing_id	VARCHAR(50)	YES		로빙 ID
channel	VARCHAR(100)	YES		채널 (slack/web/api)
message_type	VARCHAR(50)	YES		메시지 유형
user_message	TEXT	YES		사용자 메시지
bot_response	TEXT	YES		봇 응답
metadata	JSONB	YES		추가 메타데이터
created_at	TIMESTAMP	YES	CURRENT_TIMESTAMP	생성 시각

인덱스 정보

주요 인덱스

users: email (UNIQUE), username (UNIQUE)
gmail_tokens: user_id (UNIQUE), username, slack_id, robeing_id, oauth_config (GIN), token_data (GIN)
slack_user_mapping: slack_user_id, user_id
workspace_members: workspace_id, user_id
conversation_logs: user_id, robeing_id, created_at
robeing.contacts: robeing_id, name, email
robeing.conversations: robeing_id, timestamp

외래키 제약

테이블	컬럼	참조 테이블	참조 컬럼
workspace_members	user_id	users	id
workspace_members	workspace_id	workspaces	id
slack_user_mapping	user_id	users	id
slack_user_mapping	slack_workspace_id	slack_workspaces	id
gmail_tokens	user_id	users	id
robeing_stats	user_id	users	id
conversation_logs	user_id	users	id

주의사항

데이터 타입 일관성

user_id: 모든 테이블에서 UUID 타입 사용
robeing_id: VARCHAR(50) 통일
timestamp: TIMESTAMP WITHOUT TIME ZONE 사용

최근 변경사항 (2025-08-23)

gmail_tokens 테이블 구조 변경:
- user_id: VARCHAR(100) → UUID로 변경 (users.id 외래키)
- username: VARCHAR(50) 컬럼 추가 (빠른 조회용)
- slack_id: VARCHAR(50) 컬럼 추가 (Slack 연동용)
외래키 관계 정립:
- gmail_tokens.user_id → users.id
- 데이터 무결성 보장

개선 필요 사항

일부 테이블의 소유자가 postgres로 되어있어 권한 조정 필요
- gmail_audit_logs: postgres → robeings
- robeing_stats: postgres → robeings
auth_db → main_db로 마이그레이션 완료
gmail_tokens_old 백업 테이블 정리 검토

문서 끝

11 KiB Raw Blame History

PostgreSQL 테이블 구조

작성일: 2025-08-20

최종 수정일: 2025-08-24

데이터베이스: main_db

1. 사용자 관련 테이블

users

2. Workspace 관련 테이블

workspaces

workspace_members

companies

3. Slack 통합 테이블

slack_workspaces

slack_user_mapping

4. Gmail 관련 테이블

gmail_tokens

gmail_audit_logs

gmail_tokens_old

5. 로빙 관련 테이블

robeing_stats

robeing_settings

6. robeing 전용 스키마 테이블

robeing.contacts

robeing.conversations

7. 대화 로그 테이블

conversation_logs

인덱스 정보

주요 인덱스

외래키 제약

주의사항

데이터 타입 일관성

최근 변경사항 (2025-08-23)

개선 필요 사항

11 KiB

Raw Blame History