mandate-gate

Tables (9)

agents

  • id — BIGINT — Primary key — NOT NULL — 에이전트 PK
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 소유 사용자
  • agent_name — VARCHAR(100) — NOT NULL — 쇼핑비서 / 은행비서
  • agent_type — VARCHAR(30) — NOT NULL — SHOPPING / BANKING
  • api_key_hash — CHAR(64) — SHA-256. 평문 저장 금지
  • status — VARCHAR(20) — NOT NULL — ACTIVE / SUSPENDED
  • created_at — DATETIME(6) — NOT NULL

approvals

  • id — BIGINT — Primary key — NOT NULL — 승인 PK
  • payment_request_id — BIGINT — Foreign key → payment_requests.id — NOT NULL — 대상 요청
  • status — VARCHAR(20) — NOT NULL — PENDING / APPROVED / REJECTED / EXPIRED
  • expires_at — DATETIME(6) — NOT NULL — 만료 시 자동 거부
  • resolved_at — DATETIME(6) — 사용자 결정 시각
  • resolved_note — VARCHAR(300) — 결정 사유
  • created_at — DATETIME(6) — NOT NULL

audit_logs

  • id — BIGINT — Primary key — NOT NULL — 로그 PK
  • payment_request_id — BIGINT — Foreign key → payment_requests.id — 관련 요청. 발급 로그는 NULL
  • event_type — VARCHAR(40) — NOT NULL — MANDATE_ISSUED / MANDATE_REVOKED / REQUEST_RECEIVED / DECISION_MADE / APPROVAL_RESOLVED
  • payload — JSON — NOT NULL — 이벤트 본문
  • prev_hash — CHAR(64) — 직전 로그 해시. 체인 첫 행만 NULL
  • current_hash — CHAR(64) — NOT NULL — sha256(prev_hash + payload + created_at)
  • created_at — DATETIME(6) — NOT NULL

context_sources

  • id — BIGINT — Primary key — NOT NULL — 소스 PK
  • session_id — VARCHAR(50) — Foreign key → sessions.id — NOT NULL — 소속 세션
  • source_type — VARCHAR(30) — NOT NULL — USER_UTTERANCE / USER_REGISTERED / MERCHANT_API / WEB_PAGE / DOCUMENT / EMAIL
  • trust_level — TINYINT — NOT NULL — 0~3. 서버가 결정. 낮을수록 신뢰
  • source_url — VARCHAR(500) — 출처 URL
  • raw_text — MEDIUMTEXT — 에이전트가 읽은 원문
  • fetched_at — DATETIME(6) — NOT NULL

mandate_categories

  • category — VARCHAR(30) — Primary key — NOT NULL — FOOD / TRANSPORT / DAILY / SUBSCRIPTION / ETC
  • mandate_id — BIGINT — Foreign key → mandates.id — NOT NULL — 위임장

mandates

  • id — BIGINT — Primary key — NOT NULL — 위임장 PK
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 위임자
  • agent_id — BIGINT — Foreign key → agents.id — NOT NULL — 수임 에이전트
  • token_jti — VARCHAR(50) — NOT NULL — M-2026-0041 형식
  • max_amount_per_tx — BIGINT — NOT NULL — 1회 한도. 원 단위 정수
  • max_amount_total — BIGINT — NOT NULL — 총 한도. 원 단위 정수
  • used_amount — BIGINT — NOT NULL — 누적 사용액. 토큰에 넣지 않는다
  • allowed_hours — VARCHAR(11) — 07-22 형식. 파싱은 애플리케이션
  • allow_transfer — TINYINT(1) — NOT NULL — 송금 허용. 기본값 불허
  • allowed_recipients — JSON — 등록 수취인 목록
  • valid_from — DATETIME(6) — NOT NULL — 유효 시작. UTC
  • valid_until — DATETIME(6) — NOT NULL — 유효 종료. UTC
  • status — VARCHAR(20) — NOT NULL — ACTIVE / REVOKED / EXPIRED
  • revoked_at — DATETIME(6) — 폐기 시각
  • created_at — DATETIME(6) — NOT NULL

payment_requests

  • id — BIGINT — Primary key — NOT NULL — 요청 PK
  • public_id — VARCHAR(50) — NOT NULL — 외부 노출 ID. req_4821
  • mandate_id — BIGINT — Foreign key → mandates.id — NOT NULL — 검사 기준 위임장
  • agent_id — BIGINT — Foreign key → agents.id — NOT NULL — 요청 에이전트
  • session_id — VARCHAR(50) — Foreign key → sessions.id — NOT NULL — 요청 맥락 세션
  • amount — BIGINT — NOT NULL — 원 단위 정수. DOUBLE 금지
  • currency — CHAR(3) — NOT NULL
  • request_type — VARCHAR(20) — NOT NULL — PAYMENT / TRANSFER
  • merchant_name — VARCHAR(200) — 가맹점명
  • category — VARCHAR(30) — 결제 카테고리
  • recipient_account — VARCHAR(50) — 송금 수취 계좌
  • agent_reasoning — TEXT — 에이전트가 밝힌 실행 근거
  • decision — VARCHAR(20) — NOT NULL — ALLOW / REQUIRE_APPROVAL / BLOCK
  • headline — VARCHAR(300) — 사람이 읽는 판정 문장
  • decision_reasons — JSON — 계층별 판정 근거 배열
  • provenance_result — JSON — 파라미터별 출처 등급 판정
  • risk_score — DECIMAL(4, 3) — 0.000~1.000
  • created_at — DATETIME(6) — NOT NULL
  • decided_at — DATETIME(6) — 판정 완료 시각

sessions

  • id — VARCHAR(50) — Primary key — NOT NULL — sess_ + UUID. 41자
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 발화 주체
  • agent_id — BIGINT — Foreign key → agents.id — NOT NULL — 대상 에이전트
  • user_utterance — VARCHAR(500) — NOT NULL — 사용자 원문 발화. 에이전트 쓰기 불가
  • created_at — DATETIME(6) — NOT NULL

users

  • id — BIGINT — Primary key — NOT NULL — 사용자 PK
  • email — VARCHAR(255) — NOT NULL — 로그인 ID
  • name — VARCHAR(100) — NOT NULL — 이름
  • password_hash — VARCHAR(100) — BCrypt 해시
  • created_at — DATETIME(6) — NOT NULL
  • updated_at — DATETIME(6) — NOT NULL