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