v1.0.0 — 다닐만한가 첫 정식 버전

공공데이터(국민연금 사업장, OpenDART, 서울시 전월세 실거래가)로 서울 회사의 인원 추이 · 입퇴사율 · 추정 연봉 · 근처 주거비를 보여 주는 구직자용 웹 서비스의 첫 정식 버전입니다.

• 웹: https://web-chi-flax-46.vercel.app
• API: https://api-production-30254.up.railway.app (/docs)
• 데이터 기준월: 국민연금 2026-08, 전월세 2026-08
• DB 덤프: 팀 공유 드라이브 worth_joining_20261014_v1.zip (Alembic 0008, 복원하면 배포 DB와 같음)

주요 기능

• 지도 메인: 지도 범위 안의 회사를 10곳씩 목록 · 핀으로 보여 줍니다. 업종 · 지역(구) 필터, 지표(12개월 증감 · 퇴사율 · 추정 연봉), 같은 건물 회사 묶기
• 회사 검색: 회사명 또는 사업자번호 앞 6자리
• 회사 상세: 가입자 추이, 입사 · 퇴사율, 추정 연봉(하한), 업종 내 백분위, DART 재무, 회사 근처 역 원룸 시세 · 월급 대비 부담률, 사람인 · 잡코리아 검색 바로가기
• 회사 비교: 최대 3곳, 12개월 지수 추이와 근처 주거비
• 역 시세: 서울 309개 역, 역세권 500m 원룸 시세(6 · 12 · 24개월)와 24개월 추이
• 역 비교: 최대 3개 역, 지도가 담은 역을 모두 보이게 맞춤
• 계산 방법 화면: 계산식 · 한계 · 출처

데이터

항목	규모
서울 회사	126,407곳 (13개월, 2025-08 ~ 2026-08)
회사 지도 좌표	100% (건물 11,961 · 도로 중심 112,867 · 동 중심 1,579)
DART 연결률	가입자 1,000명 이상 회사의 79.1%
전월세 계약	443,227건 (연립다세대 · 오피스텔, 2024-09 ~)
지하철역	309곳

품질

• 테스트: pytest(SQL 회귀 · API), CI에서 ruff · pytest · 웹 lint · 타입 · 빌드 · API 타입 생성 비교
• 성능: docs/performance.md (locust)
• 접근성: Lighthouse 96 ~ 100
• 응답 캐시(1시간, ETag), 웹 보안 헤더

알려진 한계

• 추정 연봉은 국민연금 소득 상한 때문에 하한 추정치입니다
• 가입자 10명 미만 회사는 표본 부족으로 백분위를 내지 않습니다
• 서울 사업장만 다룹니다(decisions/002)
• 채용공고는 직접 보여 주지 않고 검색 링크로 연결합니다(decisions/008)
• 데이터 갱신은 월 1회 수동입니다(docs/runbook.md 4장)
• 지도 핀이 겹치는 곳에서 접근성 target-size 경고가 남아 있습니다

만든 사람

README의 팀원 목록을 참고하세요.

What's Changed

• docs(claude): 커밋 메시지 규칙을 Conventional Commits로 명시 by @ssklpp in #1
• docs: 커밋 규칙 통일과 저장소 보호 단계 기록 by @ssklpp in #2
• chore: 저장소 구조와 의존성, CODEOWNERS, PR 템플릿 추가 by @ssklpp in #3
• chore: 환경 변수 설정과 DB 연결, /health 추가 by @ssklpp in #4
• fix(app): Windows 로컬에서 DB 접속이 실패하는 문제 수정 by @ssklpp in #5
• ci: GitHub Actions에 ruff와 pytest 추가, conftest 구성 by @ssklpp in #6
• docs: 트러블슈팅 기록 문서와 작성 규칙 추가 by @ssklpp in #7
• docs(decisions): CI 필수 검사 적용을 기록 by @ssklpp in #8
• feat(pipeline): 국민연금 CSV 서울 추출 · 헤더 매핑 · 프로파일링 추가 by @ssklpp in #9
• docs: 서비스 범위를 서울특별시 사업장으로 한정 by @ssklpp in #10
• docs: 국민연금 적재의 탈퇴 행 처리와 품질 검사 기준 확정 by @ssklpp in #11
• docs: 회사 지도 좌표 정확도 단계 확정 by @ssklpp in #12
• feat(db): 초기 스키마 마이그레이션과 nps_rate 시드 추가 by @ssklpp in #13
• feat(pipeline): 국민연금 raw 적재기 추가 by @ssklpp in #14
• feat(pipeline): 국민연금 raw → core upsert와 월 적재 진입점 추가 by @ssklpp in #15
• feat(pipeline): 국민연금 월 적재 품질 검사 추가 by @ssklpp in #16
• feat(pipeline): 법정동코드로 시군구 region 적재기 추가 by @ssklpp in #17
• docs: Phase 2 완료 상태를 README · CLAUDE.md · 문서에 반영 by @ssklpp in #18
• feat(db): mart_company_monthly · summary와 refresh_mart 추가 by @ssklpp in #19
• feat(api): 회사 검색 · 상세 · 월별 추이 엔드포인트 추가 by @ssklpp in #20
• feat(api): 업종 · 산출 방법 API와 Phase 4 성능 측정 추가 by @ssklpp in #21
• feat(pipeline): DART 스키마 · 공통 API 클라이언트 · 고유번호 적재기 추가 by @ssklpp in #22
• fix(pipeline): 상호 정규화에 NFKC를 적용해 전각 괄호 처리 by @ssklpp in #23
• feat(pipeline): DART 기업개황 수집과 국민연금 회사 매칭 추가 by @ssklpp in #24
• feat: DART 재무 수집과 회사 재무 API 추가 by @ssklpp in #25
• feat(web): Next.js 기본 구조와 계산 방법 화면 추가 by @ssklpp in #26
• feat(web): 회사 검색 화면 추가 by @ssklpp in #27
• feat(web): 회사 상세 화면 추가 by @ssklpp in #28
• build: Railway · Vercel 배포 준비와 운영 runbook 추가 by @ssklpp in #29
• fix(web): Next.js · React를 보안 패치 버전으로 올림 by @ssklpp in #30
• docs: Phase 7 배포 결과와 runbook 보완 by @ssklpp in #31
• feat(api): 회사 비교 API 추가 by @ssklpp in #32
• feat(pipeline): juso 지오코더와 좌표 테이블 추가 by @ssklpp in #33
• feat(api): 지도 핀 API 추가 by @ssklpp in #34
• feat(web): 비교에 담기와 회사 비교 화면 추가 by @ssklpp in #35
• feat(web): 네이버 지도 비교 화면 추가 by @ssklpp in #36
• feat(pipeline): 회사 지도 좌표(DART 본사 · 상호 검색) 생성기 추가 by @ssklpp in #37
• feat(api): 회사 상세에 지도 위치 추가 by @ssklpp in #38
• feat(web): 지도 메인 화면으로 검색 · 상세 · 비교 통합 by @ssklpp in #39
• docs(decisions): Phase 9 범위와 집계 기준월 기록 by @ssklpp in #40
• feat(db): 역세권 전월세 스키마와 월 파티션 스크립트 추가 by @ssklpp in #41
• feat(pipeline): 서울 역 적재기 추가 by @ssklpp in #42
• feat(pipeline): 회사 지도 좌표에 도로 · 동 중심 단계 추가 by @ssklpp in #43
• chore(pipeline): 역 데이터 기본 파일 이름을 영문으로 변경 by @ssklpp in #44
• docs: Phase 8 완료와 현재 상태 반영 by @ssklpp in #45
• feat(pipeline): 서울 전월세 적재기 추가 by @ssklpp in #46
• feat(pipeline): 전월세전환율 적재기 추가 by @ssklpp in #47
• feat(sql): 역세권 시세와 회사 근처 역 집계 추가 by @ssklpp in #48
• feat(api): 회사 근처 역 주거비와 역 시세 API 추가 by @ssklpp in #49
• feat(web): 회사 상세에 근처 주거비 구획 추가 by @ssklpp in #50
• docs: Phase 9 완료와 배포 반영 절차 기록 by @ssklpp in #51
• docs(validation): 회사 5곳 대조와 데이터 품질 지표 기록 by @ssklpp in #52
• perf(api): 지도 좌표 없는 회사 수를 필터별로 기억하고 성능 기록 정리 by @ssklpp in #53
• docs(readme): 현재 서비스 기준으로 README 최종화 by @ssklpp in #54
• docs: 발표 자료 소재 정리 by @ssklpp in #55
• fix(web): 지도 핀 · 비교함 링크의 접근성 이름과 누르는 영역 맞추기 by @ssklpp in #56
• docs(requirements): Phase 11 기능 누락 재점검 결과 기록 by @ssklpp in #57
• docs: 공유 드라이브 덤프 이름을 Phase 9 기준으로 갱신 by @ssklpp in #58
• chore: 쓰지 않는 코드와 파일 정리 by @ssklpp in #59
• feat(sql): 역세권 시세 24개월 추이 집계 추가 by @ssklpp in #60
• feat(api): 역 시세에 24개월 추이와 좌표 추가 by @ssklpp in #61
• feat(web): 역 시세 화면과 비교표 주거비 행 추가 by @ssklpp in #62
• feat(api): 헬스 품질 지표와 응답 캐시 헤더, 역 목록 좌표 추가 by @ssklpp in #63
• feat(web): 지도에 지하철역 표시와 역 이름 검색창 추가 by @ssklpp in #64
• feat(web): 채용 연계를 사람인 · 잡코리아 바로가기로 대체 by @ssklpp in #65
• feat(web): 없는 주소와 화면 오류에 한국어 안내 추가 by @ssklpp in #66
• chore: v1.0.0 전에 버전 · CI 타입 확인 · 사람인 설정 · 상태 문서 정리 by @ssklpp in #67
• feat(web): 기본 보안 헤더 추가 by @ssklpp in #68
• fix(web): 서울역이 서울역역으로 표시되던 문제 수정 by @ssklpp in #69
• docs: 공유 덤프를 v1(Alembic 0008) 기준으로 갱신 by @ssklpp in #70
• docs: 코드에 모듈 · 함수 설명 주석 추가 by @ssklpp in #71
• feat(web): 지역을 고르면 지도를 그 구로 옮기고 역 검색은 화면 안 역만 제안 by @ssklpp in #72
• feat(web): 역을 3개까지 담아 비교하는 역 비교 화면 추가 by @ssklpp in #73
• feat(web): 지도 안 회사 목록을 10곳씩 페이지로 나누고 지도도 그 페이지 핀만 표시 by @ssklpp in #74
• docs: 최근 화면 변경을 README · CLAUDE.md · 설계 문서에 반영 by @ssklpp in #75
• fix(web): 역 비교 표의 빼기 버튼이 여러 줄로 깨지던 문제 수정 by @ssklpp in #77
• docs(readme): 화면 캡처를 최신 화면으로 바꾸고 역 비교 캡처 추가 by @ssklpp in #76
• fix(web): 상세 · 비교 화면에서도 지도 핀을 10곳까지만 표시 by @ssklpp in #78
• docs(readme): 지도 핀 10곳 제한 뒤 화면으로 캡처 교체 by @ssklpp in #79
• fix(web): 역 시세 화면에서 역 위에 빈 회사 핀이 겹치던 문제 수정 by @ssklpp in #80
• fix(web): 역 비교의 없어진 역 오류 · 빼기 깜박임과 지난 위치 보기 수정 by @ssklpp in #81
• docs(troubleshooting): 역 화면 빈 핀(TS-026) · 역 비교 없어진 역 오류(TS-027) 추가 by @ssklpp in #82
• docs(runbook): 월 갱신 뒤 응답 캐시로 화면이 최대 1시간 늦게 바뀐다는 안내 추가 by @ssklpp in #83

New Contributors

• @ssklpp made their first contribution in #1

Full Changelog: https://github.com/ssklpp/worth-joining/commits/v1.0.0