안심사인

마주한 문제

한 사람과 한 회사의 계정을 같은 축으로 다루던 구조에 여러 회사 공간이 필요해졌습니다. 회사에서 나가는 행동이 사람의 로그인 정보까지 지우거나, 강퇴 직전에 시작한 수정 요청이 정리한 정보를 다시 쓰는 문제가 생길 수 있었습니다.

확인한 과정

토큰 발급을 바꾸는 것과 실제 비밀번호 조회를 옮기는 것은 다른 작업이었습니다. 로그인·추가 인증·프로필 변경·소셜 연결의 읽기와 쓰기를 각각 추적했습니다. 탈퇴 시 다른 소속을 보존하는 백엔드는 이미 있는 부분도 있어, 새 삭제 기능을 만들기보다 잘못된 화면 안내와 빠진 정리 경로를 구분했습니다.

선택한 방법

사람의 인증 정보와 회사별 소속을 분리했습니다. 같은 트랜잭션에서 쓰기 사본을 맞춘 뒤 토큰 검증, 실제 자격 조회 순서로 전환했습니다. 다른 소속이 남으면 공통 로그인 정보를 보존하고, 마지막 소속이 끝나면 이전 회사에 남은 소셜 연결까지 정리했습니다. 프로필 쓰기와 소셜 콜백에도 강퇴·탈퇴 상태를 다시 확인하는 조건을 뒀습니다.

어떻게 확인했는가

요청 도중 강퇴되는 순서, 다른 회사의 소속이 남는 경우, 마지막 소속에서 탈퇴하는 경우를 나눠 확인했습니다. 쓰기 사본을 다시 켜는 과정에서는 이메일 변경과 신규 가입이 충돌하는 반례를 찾아, 기존 사본 동기화를 신규 백필보다 먼저 하도록 순서를 바꿨습니다. 운영 개방 때는 스냅샷과 백필 재실행 결과를 별도로 확인했습니다.

단계별 처리와 경계

1. 쓰기 사본 정렬

   기존 인증 경로를 유지하며 실제 갱신 결과를 같은 트랜잭션으로 옮깁니다.

2. 토큰 검증 전환

   사람·회사·소속의 관계와 각 인증 버전을 함께 확인합니다.

3. 자격 조회 전환

   비밀번호와 추가 인증이 실제로 읽는 원본까지 옮깁니다.

4. 탈퇴 범위 확인

   다른 소속이 남는 경우와 마지막 소속이 끝나는 경우를 구분합니다.

5. 회사 공간 개방

   복구 준비 후 다중 소속을 열고 백필·재실행 결과를 확인합니다.

마주한 문제

수신자가 긴 내용을 입력해도 최종 PDF의 작은 칸에서는 글이 줄어들거나 뒤가 잘렸습니다. 화면에서 받은 내용과 실제로 전달하는 문서가 달랐습니다.

확인한 과정

입력 길이를 더 제한하려면 PDF의 실제 칸 크기와 페이지 정보를 알아야 했고, 추가 데이터 작업뿐 아니라 정상 서명을 막는 문제도 있었습니다. 넘친 부분만 별지로 보내면 독자가 본문과 뒷장을 이어 읽어야 한다는 점도 검토했습니다.

선택한 방법

기존 한 줄 필드는 유지하고 긴 글 필드는 줄바꿈하도록 나눴습니다. 그래도 넘치는 필드는 잔여 부분이 아닌 전문을 별지에 싣고, 원래 쪽 번호와 필드 이름을 함께 표시했습니다. 첫 장의 종이 규격을 따르며, 넘친 내용이 없을 때는 별지를 만들지 않습니다.

어떻게 확인했는가

렌더 함수만 시험하면 실제 DB 조회에서 필드 이름이 빠져도 통과했습니다. 조회부터 출력까지 이어지는 통합 검증을 추가했습니다. 이후 빈 줄 정리용 AI 초안의 정규식이 긴 입력에서 워커를 오래 점유하는 반례가 나와 줄 단위 처리로 바꿨습니다. 페이지 수뿐 아니라 문단 보존·공백 처리 결과·긴 입력의 시간 상한도 검사하도록 보강했습니다.

단계별 처리와 경계

1. 최종 입력 조회

   값뿐 아니라 필드 이름·좌표·원본 쪽 정보를 함께 읽습니다.

2. 본문 칸에 합성

   한 줄 필드와 긴 글 필드의 표시 규칙을 나눕니다.

3. 넘침 판정

   칸을 넘은 긴 글의 전체 내용과 원래 위치를 별지 입력으로 넘깁니다.

4. 전문 별지 작성

   문단을 보존하며 배치하고 상한에 도달하면 안내를 남깁니다.

5. 최종 PDF 봉인

   본문과 별지가 합쳐진 문서를 이후 봉인 처리의 입력으로 사용합니다.

마주한 문제

모든 사람이 서명한 뒤에도 PDF 합성, 저장소 쓰기, 외부 타임스탬프 발급이 남습니다. 이를 하나의 완료 상태로 다루면 아직 준비되지 않은 파일을 안내하거나, 외부 서비스 지연을 계약 제출 실패로 오해하게 됩니다.

확인한 과정

입력 임시 저장, 최종 제출, 전체 서명 완료, 봉인 작업의 경계를 나눴습니다. 워커가 오래 걸리거나 재시도할 때 작업을 더 이상 소유하지 않은 실행이 결과를 확정할 수 있는지, 타임스탬프가 정확히 어느 파일과 감사 기록을 가리키는지도 확인했습니다.

선택한 방법

최종 제출 트랜잭션에서 전체 서명 완료와 봉인 작업 생성을 처리하고, PDF 제작은 워커가 이어받도록 연결했습니다. 워커는 원본 해시를 대조하고 최종값을 합성한 뒤, 봉인 전 감사체인 헤드와 최종 PDF 해시를 묶어 TSA 타임스탬프를 요청합니다. 결과 확정 직전에도 작업 점유를 다시 확인합니다.

어떻게 확인했는가

서명 완료와 봉인 완료를 별도로 확인하고, 파일 해시·감사체인·타임스탬프의 연결 및 오래된 작업의 확정 차단을 회귀 검증했습니다. 공개 PDF 업로드 검증은 파일 자체를 검사하는 경로로, 계약 DB의 감사 기록까지 대조하는 검증과 구분했습니다.

단계별 처리와 경계

1. 서명 최종 제출

   필수값을 검증하고 임시 입력을 확정값으로 옮깁니다.

2. 전체 서명 완료

   대상자의 제출이 끝나면 같은 DB 트랜잭션에서 봉인 작업을 생성합니다.

3. PDF 제작

   워커가 원본 해시를 확인하고 본문·별지를 합성해 최종 파일을 만듭니다.

4. 외부 시점 연결

   봉인 전 체인 헤드와 최종 PDF 해시를 묶어 TSA에 요청합니다.

5. 봉인 결과 확정

   점유를 재확인한 뒤 봉인 상태·감사 이벤트·교부 예약을 기록합니다.