Audit Log란
Audit Log는 Contract Decision OS에서 계약 전 판단이 어떤 데이터와 기준으로 생성되었고, 이후 어떤 사유와 조치로 상태가 변경되었는지 기록하는 판단 이력 구조입니다.
부동산 계약 판단에서 중요한 것은 결과만 보여주는 것이 아닙니다.
현재 계약이 왜 특정 상태로 분류되었는지, 어떤 데이터가 사용되었는지, 어떤 Reason Code가 발생했는지, 어떤 Action Code가 안내되었는지, 이후 어떤 자료 확인이나 재평가를 통해 상태가 바뀌었는지 남길 수 있어야 합니다.
Audit Log는 이 과정을 기록합니다.
세이프홈즈는 부동산 계약 이전 단계의 판단을 일회성 결과가 아니라, 상태와 사유와 기준과 이력이 연결된 구조로 관리합니다.
| 문서명 | Audit Log란 무엇인가 |
|---|---|
| URL | /audit-log |
| 문서 유형 | Contract Decision OS 구성요소 문서 |
| 상위 체계 | Contract Decision OS |
| 관련 구성 | State, Reason Code, Action Code, Data Sources, Snapshot |
| 첫 적용 서비스 | 안심등기 |
| 현재 버전 | Public v1.0 |
| 최종 업데이트 | 2026-06-12 |
| 공개 범위 | 개념, 필요성, 기록 항목, 활용 방식, 관리 원칙 |
왜 Audit Log가 필요한가
부동산 계약은 여러 참여자가 서로 다른 시점에 같은 계약을 반복해서 판단하는 구조입니다.
- 임차인은 계약 전에 위험을 확인합니다.
- 중개사는 고객에게 계약 상태를 설명합니다.
- 금융기관은 대출 실행 전에 리스크를 검토합니다.
- 보증기관은 보증 가능성을 심사합니다.
- 문제가 발생하면 어떤 기준으로 계약을 진행했는지 다시 확인해야 합니다.
그러나 기존 방식에서는 판단이 흩어져 있었습니다.
누가 어떤 자료를 확인했는지, 어떤 이유로 조건부 판단이 나왔는지, 어떤 후속 조치가 안내되었는지, 이후 상태가 왜 바뀌었는지 추적하기 어려웠습니다.
Audit Log는 이 문제를 해결하기 위한 판단 이력 구조입니다.
계약 전 판단이 한 번의 결과로 끝나는 것이 아니라, 데이터 확인, 사유 발생, 후속 조치, 재평가, 상태 변경의 흐름으로 남도록 합니다.
Audit Log는 무엇을 기록하는가
Audit Log는 계약 판단 과정에서 발생하는 주요 이벤트를 기록합니다.
| 기록 항목 | 의미 |
|---|---|
| 판단 시점 | 언제 판단이 생성되었는가 |
| 계약 식별 정보 | 어떤 계약 또는 물건에 대한 판단인가 |
| 사용 데이터 | 어떤 데이터 출처와 입력값이 사용되었는가 |
| 기준 버전 | 어떤 판단 기준과 버전이 적용되었는가 |
| State | 당시 계약 상태는 무엇이었는가 |
| Reason Code | 왜 그런 상태가 나왔는가 |
| Action Code | 어떤 후속 조치가 안내되었는가 |
| Snapshot | 판단 시점의 데이터와 기준 기록 |
| 재평가 여부 | 이후 다시 판단이 이루어졌는가 |
| 상태 변경 | 이전 상태와 이후 상태가 어떻게 달라졌는가 |
| 변경 사유 | 상태가 바뀐 이유는 무엇인가 |
| 처리 주체 | 시스템, 사용자, 운영자, 제휴기관 등 어떤 주체가 관련되었는가 |
Audit Log는 단순 접속 기록이 아닙니다.
계약 전 판단이 어떤 근거와 과정으로 만들어졌는지 설명하기 위한 판단 이력입니다.
Snapshot과 Audit Log의 차이
Snapshot과 Audit Log는 모두 판단 이력과 관련되지만 역할이 다릅니다.
Snapshot은 특정 시점의 데이터와 기준을 기록합니다. Audit Log는 여러 시점에 걸쳐 판단, 재평가, 상태 변경이 어떻게 이어졌는지 기록합니다.
| 구분 | Snapshot | Audit Log |
|---|---|---|
| 핵심 질문 | 그때 무엇을 기준으로 판단했는가? | 판단과 상태가 어떻게 바뀌었는가? |
| 기록 대상 | 특정 시점의 데이터와 기준 | 판단 생성, 재평가, 상태 변경 흐름 |
| 시간 개념 | 단일 시점 | 여러 시점의 변화 |
| 주요 역할 | 판단 재현 가능성 | 판단 이력 추적 |
| 예시 | 당시 등기, 시세, 보증금, 기준 버전 | 추가 자료 제출, 재평가, 상태 변경 |
Snapshot은 판단의 근거를 남깁니다.
Audit Log는 그 판단이 이후 어떻게 바뀌었는지 남깁니다.
State, Reason Code, Action Code와의 관계
Audit Log는 Contract Decision OS의 다른 구성 요소와 함께 작동합니다.
| 구성 요소 | 역할 |
|---|---|
| State | 현재 계약 상태를 표현합니다. |
| Reason Code | 왜 그런 상태가 나왔는지 설명합니다. |
| Action Code | 다음에 무엇을 확인해야 하는지 안내합니다. |
| Data Sources | 어떤 데이터에 근거했는지 설명합니다. |
| Snapshot | 판단 시점의 데이터와 기준을 기록합니다. |
| Audit Log | 판단과 상태 변화의 흐름을 기록합니다. |
State가 결론이라면, Reason Code는 이유입니다. Action Code는 다음 조치이고, Snapshot은 판단 시점의 근거입니다. Audit Log는 이 판단이 생성되고 변경된 흐름입니다.
예를 들어 처음에는 핵심 시세 정보가 부족해 판단불가 상태가 나올 수 있습니다. 이후 추가 시세 자료가 확인되면 재평가가 이루어지고, 상태가 조건부적격 또는 적격으로 바뀔 수 있습니다.
Audit Log는 이 변화 과정을 기록합니다.
Audit Log가 필요한 대표 상황
Audit Log는 다음과 같은 상황에서 중요합니다.
| 상황 | Audit Log가 필요한 이유 |
|---|---|
| 판단 결과가 바뀐 경우 | 왜 이전 결과와 현재 결과가 다른지 설명해야 합니다. |
| 추가 서류가 제출된 경우 | 어떤 자료가 추가되어 재평가되었는지 남겨야 합니다. |
| 등기나 권리관계가 변동된 경우 | 변경 전후 상태를 비교할 수 있어야 합니다. |
| 보증금이나 계약 조건이 변경된 경우 | 조건 변경이 판단에 미친 영향을 기록해야 합니다. |
| 금융기관 또는 보증기관이 검토하는 경우 | 사전 판단 근거와 이력을 확인할 수 있어야 합니다. |
| 고객 민원이 발생한 경우 | 당시 어떤 기준으로 안내했는지 확인할 수 있어야 합니다. |
| 내부 기준이 업데이트된 경우 | 어떤 버전의 기준이 적용되었는지 구분해야 합니다. |
부동산 계약 판단은 시간이 지나면서 달라질 수 있습니다.
Audit Log는 그 변화를 설명 가능하게 만듭니다.
판단 상태가 바뀌는 과정
Audit Log는 계약 전 판단의 변화 과정을 기록합니다.
예를 들어 다음과 같은 흐름이 있을 수 있습니다.
| 단계 | 상태 | 발생 사유 | 후속 조치 | 기록 의미 |
|---|---|---|---|---|
| 1차 판단 | 판단불가 | 핵심 시세 정보 부족 | 시세 자료 재확인 | 데이터 부족으로 평가 제한 |
| 추가 확인 | 조건부적격 | 일부 보증금 회수 위험 | 보증금 및 조건 재검토 | 추가 확인 필요 |
| 계약 조건 조정 | 조건부적격 | 보증금 조정 반영 | 재평가 진행 | 입력값 변경 기록 |
| 재평가 | 적격 또는 추가 확인 필요 | 변경 조건 반영 | 최종 확인 안내 | 상태 변경 이력 기록 |
이 예시는 특정 계약의 안전성을 보장하는 것이 아닙니다.
중요한 것은 Contract Decision OS가 판단 결과만 보여주는 것이 아니라, 판단이 어떻게 생성되고 바뀌었는지를 남기는 구조라는 점입니다.
금융기관 내부통제와 Audit Log
금융기관은 단순히 결과값만으로 판단하기 어렵습니다.
특히 전세대출, 보증, 담보 판단에서는 다음 질문에 답할 수 있어야 합니다.
- 어떤 데이터로 판단했는가?
- 어떤 기준 버전이 적용되었는가?
- 왜 추가 확인 필요로 분류되었는가?
- 어떤 후속 조치가 안내되었는가?
- 재평가 후 상태가 왜 바뀌었는가?
- 고객 민원이나 사고 발생 시 당시 판단 근거를 확인할 수 있는가?
Audit Log는 금융기관이 계약 전 위험 신호를 사전에 확인하고, 내부 검토와 사후 확인에 활용할 수 있는 판단 이력 구조를 제공합니다.
Contract Decision OS는 금융기관의 최종 심사를 대체하지 않습니다. 대신 계약 이전 단계에서 상태와 사유와 기준과 이력을 구조화해, 사전 스크리닝과 내부통제에 활용될 수 있는 기반을 제공합니다.
개인정보와 접근 통제
Audit Log는 판단 이력을 남기기 위한 구조이지만, 모든 개인정보를 공개하거나 저장하기 위한 구조가 아닙니다.
세이프홈즈는 Audit Log를 관리할 때 다음 원칙을 적용합니다.
| 원칙 | 의미 |
|---|---|
| 최소 기록 | 판단에 필요한 범위의 정보만 기록합니다. |
| 목적 제한 | 계약 전 판단, 재평가, 사후 확인 목적에 맞게 관리합니다. |
| 접근 통제 | 필요한 권한을 가진 주체만 확인할 수 있도록 관리합니다. |
| 민감 정보 보호 | 개인정보와 민감 정보는 공개 대상에서 제외합니다. |
| 보관 기준 관리 | 내부 정책과 관련 법령에 따라 보관 기준을 관리합니다. |
공개 페이지에서는 Audit Log의 구조와 원칙을 설명하되, 개별 계약의 원본 로그나 민감 정보는 공개하지 않습니다.
안심등기에서의 적용
안심등기는 Contract Decision OS가 전세·임대차 시장에서 적용된 첫 번째 서비스입니다.
안심등기에서 Audit Log는 계약 전 판단과 상태 변화의 이력을 관리하는 구조로 활용될 수 있습니다.
예를 들어 다음과 같은 변화가 기록될 수 있습니다.
| 상황 | Audit Log에서의 의미 |
|---|---|
| 최초 분석 생성 | 최초 판단 시점과 사용 데이터 기록 |
| 필수 정보 보완 | 주소, 보증금, 계약 조건 등 입력값 변경 기록 |
| 등기 정보 변경 | 권리관계 변화에 따른 재평가 기록 |
| 시세 자료 추가 | 가격 판단 근거 보완 이력 |
| 서류 확인 완료 | Action Code 처리 여부 기록 |
| 상태 변경 | 판단불가, 조건부적격, 적격 등 상태 변화 기록 |
안심등기는 단순히 한 번 결과를 보여주는 리포트가 아니라, 계약 전 확인 과정과 상태 변화를 설명 가능한 구조로 관리하는 방향을 지향합니다.
Audit Log가 하지 않는 것
Audit Log는 다음을 하지 않습니다.
- 계약의 법적 안전성을 확정하지 않습니다.
- 대출 가능 여부를 확정하지 않습니다.
- 보증보험 가입 가능 여부를 확정하지 않습니다.
- 보증금 반환 가능성을 보장하지 않습니다.
- 모든 판단 오류 가능성을 제거하지 않습니다.
- 개별 계약의 민감 정보를 공개하지 않습니다.
- 금융기관의 최종 심사를 대체하지 않습니다.
Audit Log는 계약 전 판단 과정과 상태 변화를 설명하고, 사후에 기준과 이력을 확인할 수 있도록 돕는 구조입니다.
자주 묻는 질문
Audit Log란 무엇인가요?
Audit Log는 계약 전 판단이 어떤 데이터와 기준으로 생성되었고, 이후 어떤 사유와 조치로 상태가 변경되었는지 기록하는 판단 이력 구조입니다.
Snapshot과 Audit Log는 무엇이 다른가요?
Snapshot은 특정 시점의 데이터와 기준을 기록합니다. Audit Log는 여러 시점에 걸쳐 판단, 재평가, 상태 변경이 어떻게 이어졌는지 기록합니다.
왜 판단 이력이 중요한가요?
부동산 계약은 등기, 시세, 보증금, 계약 조건, 보증 기준이 시간에 따라 바뀔 수 있습니다. 판단 이력이 있어야 왜 결과가 바뀌었는지, 어떤 기준이 적용되었는지 설명할 수 있습니다.
판단 결과가 바뀌면 어떻게 기록되나요?
추가 자료 확인, 입력값 변경, 등기 변동, 기준 업데이트, 재평가 결과 등이 기록될 수 있습니다. Audit Log는 이전 상태와 이후 상태, 변경 사유, 적용 기준을 함께 남기는 구조입니다.
금융기관 내부통제와 어떤 관련이 있나요?
금융기관은 전세대출, 보증, 담보 판단에서 어떤 데이터와 기준으로 판단했는지 확인해야 합니다. Audit Log는 사전 판단 근거와 상태 변화 이력을 남겨 내부 검토와 사후 확인에 활용될 수 있습니다.
Audit Log에는 개인정보가 포함되나요?
Audit Log는 판단 이력을 관리하기 위한 구조이며, 공개 페이지에서는 개별 계약의 개인정보나 민감 정보를 공개하지 않습니다. 실제 운영에서는 최소 기록, 목적 제한, 접근 통제, 민감 정보 보호 원칙이 필요합니다.
유의사항
Audit Log는 계약 전 판단 과정과 상태 변화를 설명하기 위한 기록 구조입니다.
Audit Log가 존재한다고 해서 계약 가능 여부, 대출 가능 여부, 보증보험 가입 가능 여부, 보증금 반환 가능성이 확정되는 것은 아닙니다.
세이프홈즈는 현재 확인 가능한 데이터와 기준을 바탕으로 계약 전 위험 신호와 판단 이력을 구조화하며, 최종 의사결정을 대신하지 않습니다.
판단 근거 및 출처
이 글의 핵심 요약
Audit Log는 계약 전 판단이 어떤 데이터와 기준으로 생성되었고, 이후 어떤 사유와 조치로 상태가 변경되었는지 기록하는 판단 이력 구조입니다.
Snapshot이 특정 시점의 근거를 남긴다면, Audit Log는 여러 시점에 걸친 판단 생성·재평가·상태 변경 흐름을 남깁니다.
Audit Log는 금융기관 내부통제와 사후 확인에 활용될 수 있으며, 최소 기록·목적 제한·접근 통제·민감 정보 보호 원칙으로 관리됩니다. 계약·대출· 보증 가능 여부를 확정하지는 않습니다.
Audit Log records how a pre-contract decision was generated and how its state changed over time, supporting explainability, reproducibility, and internal control within Contract Decision OS.