Repository navigation
Home
사용자가 받는 최종 리포트. AI 초안을 손해사정사가 검수해 쟁점별로 인정·수정·추가한 결과다(데모 데이터).
AI 손해사정 플랫폼(팀 윤동주) 백엔드 위키다. 사용자가 사고 정보와 진단서를 올리면 AI가 보험금 리포트 초안을 만들고, 여러 손해사정사가 그 초안을 검수해 제안을 보낸다. 이 레포(Spring Boot)는 인증·회원, 리포트 접수와 OCR 트리거, 검수·제안·채팅, 알림을 맡는다.
위키에는 코드를 읽어도 알 수 없는 것을 남긴다. 무엇이 문제였고, 무엇을 재고 비교했고, 그래서 무엇을 바꿨는지다. 쓰는 방법은 위키 작성 가이드에 있다.
- 프로젝트 개요: 무엇을 왜 만드는지, 백엔드와 AI 워커의 경계
- 사례 기록 24편: 아래 목록
- Kubernetes · Kubernetes 런북: 비공개 매니페스트 레포 대신 구성과 운영 절차를 여기에 둔다
- 결정 로그 · 용어집
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| 사건번호 발급 락 경합으로 처리량 붕괴 | 2026-09 | 관찰 중 | 혼합 부하에서 실패율 23~37% → 단일 API 100 RPS에서 실패 0% |
| HikariCP 풀 확대로는 풀리지 않은 RDS CPU 한계 | 2026-09 | 관찰 중 | 풀을 30으로 늘려도 Pending 172, RDS CPU 95% |
| k6 부하테스트 401 폭주를 VU별 토큰 재주입으로 해결 | 2026-09 | 해결 | 요청의 약 90%가 401이던 측정 도구 버그 |
| 채팅 구독 거절이 WebSocket 연결 전체를 끊던 문제 | 2026-09 | 해결 | 구독 하나가 거절되면 연결이 1002로 끊기던 문제 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| 스키마 미지정 마이그레이션이 배포를 깨뜨려 core 스키마로 통일 | 2026-08 | 해결 | V33 배포 실패에서 V40 스키마 통일까지 |
| AI 워커가 남긴 상태를 소비하지 않아 리포트가 무음으로 멈춤 | 2026-08 | 해결 | BLOCKED·NEEDS_REUPLOAD를 아무도 읽지 않던 무음 정지 |
| OpenAPI 프로퍼티명이 camelCase로 문서화돼 실제 응답과 어긋남 | 2026-08 | 해결 | 602개 프로퍼티 중 599개가 실제 응답과 달랐다 |
| OpenAPI 응답 상태코드가 전부 200으로 문서화됨 | 2026-09 | 해결 | 51개 엔드포인트가 전부 200으로 문서화 |
| 서버 오류는 0건인데 500이 144건이던 포괄 예외 핸들러 문제 | 2026-07 | 해결 | dev 500 144건이 전부 4xx(404 142, 405 2)였고 서버 오류는 0건 |
| 읽는 곳은 다섯인데 쓰는 곳이 없던 비정규화 컬럼으로 사정사 평점이 항상 0점 | 2026-09 | 해결 | 다섯 화면이 읽는 평점 컬럼을 아무도 쓰지 않아 후기를 남겨도 0점 |
| 검수 대기 숫자가 화면마다 다르고 목록에서 누르면 404 | 2026-07 | 해결 | 쿼리마다 따로 정의된 '검수 대기'를 하나의 기준으로 맞춤 |
| 프론트 계약이 어긋나 기능이 조용히 깨진 두 번 | 2026-07 ~ 08 | 해결 | 응답 타입 변경으로 로그인이 조용히 풀리고, 가입 이름·지역이 버려짐 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| Refresh 토큰 동시 재발급 경쟁을 Lua 원자 CAS로 해결 | 2026-07 | 해결 | 동시 재발급 두 건이 모두 성공하던 경쟁 조건 |
| 회원 탈퇴의 dual-write를 트랜잭셔널 아웃박스로 해결 | 2026-07 | 해결 | DB 커밋과 Redis·외부 호출 사이의 dual-write |
| OCR 트리거 브로커를 Kafka에서 MSK를 거쳐 SQS로 전환 | 2026-07 ~ 09 | 해결 | 하루 사이에 브로커를 두 번 바꾼 기록 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| 배포는 초록불인데 컨테이너가 계속 재시작되던 일 | 2026-07, 10 | 해결 | 배포 성공 ≠ 앱 기동, 그리고 verify-deploy |
| Spring Boot 4에 트레이싱을 붙이다 세 번 조용히 실패한 일 | 2026-07 | 해결 | 에러 없이 스팬 0개 |
| 타깃은 UP인데 컨테이너 메트릭이 비어 있던 일 | 2026-07 | 해결 | cAdvisor와 containerd 이미지 스토어 |
| pgAudit 감사 로그 범위를 두 번 고친 일 | 2026-08 | 해결 | 정작 제일 위험한 테이블이 빠져 있던 감사 로그 |
| 사례 | 시기 | 상태 | 한 줄 |
|---|---|---|---|
| CNI를 Flannel에서 Calico를 거쳐 Cilium으로 전환 | 2026-09 ~ 10 | 해결 | CNI를 두 번 바꾼 이유와 부작용 |
| GitHub App 키를 지워 dev 배포가 멈추고 조직 시크릿으로 통합 | 2026-10 | 해결 | 키 하나를 지워 dev 배포가 12시간 멈춤 |
| Helm 3과 4의 렌더링 차이를 리소스 단위 대조로 잡고 애드온을 Argo CD로 이전 | 2026-10 | 해결 | 전 노드 Cilium 재시작을 대조로 막은 이전 작업 |
| 클러스터 상태가 레포 밖에 있어서 잃어버린 것들 | 2026-10 | 관찰 중 | 재부팅으로 사라진 차트, 노드 이동으로 사라진 Redis |
| GitOps 이전 중에 드러난 Traefik 서비스 타입 오류와 외부에 열린 actuator | 2026-09 ~ 10 | 해결 | 12일 동안 외부에 열려 있던 /actuator/prometheus |