봇과 사람을 어떻게 가를까

// ─────────────────────────────────────────────────────────────────────────────
// chatmu — 확장안 (b): 봇의 살림살이만 딸린 표로 나간다
//
// ⚠️ 이것은 **제안**이다. 지금 도는 스키마가 아니다(그쪽은 db/schema.sql 에서 뽑는다).
// actors 는 여전히 「발화 주체」한 축이고, messages·room_participants·direct_rooms 는
// 하나도 안 바뀐다 — 바뀌는 것은 봇 전용 칸의 자리뿐이다.
// ─────────────────────────────────────────────────────────────────────────────

Table users {
  id bigint [pk]
  login_id text [unique, not null]
  password_hash text [not null]
  display_name text [not null, note: '⚠ actors.display_name 과 중복 — 별도 검토 중']
  created_at timestamptz [not null]
  password_changed_at timestamptz [not null, note: '옛 토큰을 끊는 기준선']
}

Table actors {
  id bigint [pk]
  user_id bigint [unique, note: 'NULL 이면 사람 계정이 없는 화자 (ADR 0001)']
  display_name text [not null, note: 'Profile — 남이 보는 이름표']
  status_message text [note: 'Profile · 한 줄 · 인라인 마크다운만']
  profile_body text [note: 'Profile · Message 본문과 같은 계약']
  profile_body_format text [note: '본문과 한 몸 — CHECK 가 짝을 진다']
  created_at timestamptz [not null]
}

Table bots {
  actor_id bigint [pk, note: 'actors 를 그대로 잇는다 — 새 id 를 만들지 않는다']
  owner_user_id bigint [not null, note: '★ NOT NULL — 주인 없는 봇이 표현될 수 없다']
  bot_token_hash text [not null, unique, note: '★ NOT NULL — 토큰 없는 봇이 표현될 수 없다']
  deactivated_at timestamptz [note: 'NULL 이 살아 있다. 거두면 여기만 채운다']
  created_at timestamptz [not null]
}

Table rooms {
  id bigint [pk]
  name text [not null, note: 'DM 방은 빈 문자열 — 판단 근거가 아니다']
  created_at timestamptz [not null]
}

Table room_participants {
  room_id bigint [pk]
  actor_id bigint [pk]
  last_read_message_id bigint [note: '읽음 커서 — 일부러 FK 가 아니다']
  joined_at timestamptz [not null]
}

Table messages {
  id bigint [pk, note: '정렬·커서의 정본']
  room_id bigint [not null]
  actor_id bigint [not null, note: '작성자는 언제나 Actor — 사람이든 봇이든']
  body text [not null]
  body_format text [not null]
  client_message_id uuid [note: '재시도가 두 번 남기지 않게']
  created_at timestamptz [not null]
  edited_at timestamptz
  deleted_at timestamptz
}

Table direct_rooms {
  room_id bigint [pk]
  actor_a_id bigint [not null, note: 'CHECK (a < b)']
  actor_b_id bigint [not null, note: 'UNIQUE (a, b)']
  created_at timestamptz [not null]
}

// ── 사람 ───────────────────────────────────────────────────────────────────
Ref: users.id < actors.user_id [delete: cascade]

// ── 봇: actors 를 1:1 로 잇는다 ────────────────────────────────────────────
Ref: actors.id - bots.actor_id [delete: cascade]

// ⚠️ owner 가 NOT NULL 이므로 **SET NULL 을 쓸 수 없다.** 지금 (a) 는 그것을 썼다.
// CASCADE 면 「주인을 지우면 그 봇의 살림살이가 사라진다」 — actors 행은 남으므로
// 지나간 Message 의 작성자 이름은 그대로다. 토큰이 사라져 더는 말하지 못할 뿐이다.
Ref: users.id < bots.owner_user_id [delete: cascade]

// ── 방·발화 (두 안에서 똑같다) ─────────────────────────────────────────────
Ref: rooms.id < room_participants.room_id [delete: cascade]
Ref: actors.id < room_participants.actor_id [delete: cascade]
Ref: rooms.id < messages.room_id [delete: cascade]
Ref: actors.id < messages.actor_id
Ref: rooms.id - direct_rooms.room_id [delete: cascade]
Ref: actors.id < direct_rooms.actor_a_id [delete: cascade]
Ref: actors.id < direct_rooms.actor_b_id [delete: cascade]

// ─────────────────────────────────────────────────────────────────────────────
// chatmu — 확장안 (d): **사람도 봇과 같은 모양으로** 붙는다
//
// ⚠️ 제안이다. 지금 도는 스키마가 아니다 — 다만 users.role 은 티켓 04 로 **이미 있다**
// (옮겨가는 것은 그 표의 PK 이지 컬럼이 아니다).
// 요점: 「사람과 봇이 공존하는 표」를 새로 만들 필요가 없다 — `actors` 가 이미 그것이다
// (ADR 0001). 그래서 하는 일은 **차이를 양쪽으로 빼내고 FK 방향을 맞추는 것**뿐이다.
//   지금:  actors.user_id ──→ users        (사람만 특별대우)
//   (d):   actors ←── users.actor_id       (사람도 확장 표)
//          actors ←── bots.actor_id        (봇도 확장 표)
// ─────────────────────────────────────────────────────────────────────────────

Table actors {
  id bigint [pk]
  display_name text [not null, note: '★ 이름은 여기 하나뿐 — users 의 중복이 사라진다']
  status_message text [note: 'Profile · 한 줄']
  profile_body text [note: 'Profile · Message 본문과 같은 계약']
  profile_body_format text [note: '본문과 한 몸']
  created_at timestamptz [not null]
  Note: '발화할 수 있는 주체 — 사람이든 봇이든 **여기 한 줄**이다 (ADR 0001)'
}

Table users {
  actor_id bigint [pk, note: '★ 방향이 뒤집힌다 — 사람도 확장 표가 된다']
  login_id text [unique, not null]
  password_hash text [not null, note: 'bcrypt — 로그인은 사람만 한다']
  password_changed_at timestamptz [not null, note: '옛 토큰을 끊는 기준선']
  role text [not null, note: '★ 이미 있다(티켓 04) — regular | admin. 값 집합은 CHECK 가 진다']
  Note: '**사람의 차이 = 로그인**. 이 행이 있으면 사람이다 (isHuman)'
}

Table bots {
  actor_id bigint [pk]
  owner_actor_id bigint [not null, note: '★ users 를 가리킨다 — 봇은 봇을 소유할 수 없다']
  bot_token_hash text [not null, unique]
  deactivated_at timestamptz [note: 'NULL 이 살아 있다']
  Note: '**봇의 차이 = 주인과 토큰**'
}

Table rooms {
  id bigint [pk]
  name text [not null]
  created_at timestamptz [not null]
}

Table room_participants {
  room_id bigint [pk]
  actor_id bigint [pk]
  last_read_message_id bigint
  joined_at timestamptz [not null]
}

Table messages {
  id bigint [pk]
  room_id bigint [not null]
  actor_id bigint [not null, note: '작성자는 언제나 Actor — 안 바뀐다']
  body text [not null]
  body_format text [not null]
  client_message_id uuid
  created_at timestamptz [not null]
  edited_at timestamptz
  deleted_at timestamptz
}

Table direct_rooms {
  room_id bigint [pk]
  actor_a_id bigint [not null]
  actor_b_id bigint [not null]
  created_at timestamptz [not null]
}

// ── 차이는 양쪽으로, 대칭으로 ──────────────────────────────────────────────
Ref: actors.id - users.actor_id [delete: cascade]
Ref: actors.id - bots.actor_id [delete: cascade]

// 주인은 **users 를 가리킨다.** 봇의 actor 는 users 에 행이 없으므로 여기 들어올 수 없다 —
// 「봇이 봇을 낳는다」가 (d) 에서도 표현될 수 없다.
Ref: users.actor_id < bots.owner_actor_id [delete: cascade]

// ── 방·발화 (세 안에서 전부 똑같다) ────────────────────────────────────────
Ref: rooms.id < room_participants.room_id [delete: cascade]
Ref: actors.id < room_participants.actor_id [delete: cascade]
Ref: rooms.id < messages.room_id [delete: cascade]
Ref: actors.id < messages.actor_id
Ref: rooms.id - direct_rooms.room_id [delete: cascade]
Ref: actors.id < direct_rooms.actor_a_id [delete: cascade]
Ref: actors.id < direct_rooms.actor_b_id [delete: cascade]