From e2ab10915f3257162445d636878939f9c13c0ac3 Mon Sep 17 00:00:00 2001
From: happybell80 <happybell80@naver.com>
Date: Thu, 4 Dec 2025 15:14:03 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20user=20=ED=85=8C=EC=9D=B4=EB=B8=94=20?=
 =?UTF-8?q?=EC=8A=A4=ED=82=A4=EB=A7=88=20=EC=97=85=EB=8D=B0=EC=9D=B4?=
 =?UTF-8?q?=ED=8A=B8=20(metadata,=20oauth=5Fproviders=20=EC=B6=94=EA=B0=80?=
 =?UTF-8?q?)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 book/300_architecture/database/tables.md | 28 +++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/book/300_architecture/database/tables.md b/book/300_architecture/database/tables.md
index b41d457..91b8afd 100644
--- a/book/300_architecture/database/tables.md
+++ b/book/300_architecture/database/tables.md
@@ -1,7 +1,7 @@
 # PostgreSQL 테이블 구조
 
 ## 작성일: 2025-08-20
-## 최종 수정일: 2025-09-24
+## 최종 수정일: 2025-12-04
 ## 데이터베이스: main_db
 
 ---
@@ -34,14 +34,36 @@
 | email | VARCHAR(255) | NO | UNIQUE |
 | name | VARCHAR(255) | YES | |
 | picture | VARCHAR(500) | YES | |
-| oauth_provider | VARCHAR(50) | YES | google/slack |
-| oauth_id | VARCHAR(255) | YES | |
+| oauth_providers | JSONB | YES | OAuth 정보 (google/slack/naverworks) |
 | is_active | BOOLEAN | YES | |
 | last_login_at | TIMESTAMPTZ | YES | |
 | created_at | TIMESTAMPTZ | YES | |
 | updated_at | TIMESTAMPTZ | YES | |
 | username | VARCHAR(64) | YES | |
 | is_admin | BOOLEAN | NO | |
+| metadata | JSONB | YES | 사용자 확장 정보 (nickname, position, preferences 등) |
+
+**metadata 예시**:
+```json
+{
+  "nickname": "joann",
+  "position": "CEO",
+  "department": "경영",
+  "preferences": {
+    "communication": "direct",
+    "work_style": "flexible"
+  }
+}
+```
+
+**oauth_providers 예시**:
+```json
+{
+  "google": "oauth_id_123",
+  "slack": "U01234567",
+  "naverworks": "nw_user_id"
+}
+```
 
 ### workspace_member
 | 컬럼명 | 타입 | NULL | 설명 |