장애인의 취업 이후 근속까지 고려한, 맞춤형 일자리 매칭 플랫폼
BridgeWork는 장애인 구직자의 직무 적합성 + 이동 접근성 + 지원 인프라를 함께 반영해, 단순 공고 노출이 아닌 실제 근속 가능한 일자리 추천을 목표로 합니다.
- Backend: https://github.com/nodongservice/backend
- AI Server: https://github.com/nodongservice/aiserver
- Backend Infra: https://github.com/nodongservice/backend-infra
- Frontend: https://github.com/nodongservice/frontend
React Frontend
-> Nginx
-> Spring Backend
-> FastAPI AI Server
-> PostgreSQL/PostGIS + Redis
-> OpenAI API / ODsay API / 공공데이터 API
장애인 구직자에게 직무 적합성, 접근성, 지원 인프라를 반영한 실제 근속 가능한 일자리를 추천한다.
- 인증/회원/프로필/공공데이터 동기화/API 게이트웨이
- OCR 업로드 파일 1차 검증 후 FastAPI OCR+LLM API로 중계
- FastAPI 요청/응답 중계
- FastAPI에는 사용자 선택 프로필 1개만 전달
- 추천(quick/map)은 Redis 기반 비동기 작업으로 처리하고 requestId 상태 조회 제공
- 스코어링 계산, 추천 순위 산출, LLM 설명 생성
- 포트폴리오 PDF OCR + LLM 기반 프로필 초안 생성
- PostgreSQL 직접 조회(공고/공공데이터)
- 접근성 점수 산정 시 ODsay 대중교통 소요시간 메타데이터 활용
- 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) + 지오코딩(네이버 NCP Geocoding API)
- 한국장애인고용공단_장애인 고용직무분류 (15157071)
- 한국장애인고용공단_장애인 표준사업장 실시간 조회 (15119304)
- 한국장애인고용공단_근로지원인 수행기관 실시간 정보 (15131282) + 지오코딩(네이버 NCP Geocoding API)
- 한국철도공사_편의시설정보 (15125774)
- 서울교통공사_교통약자이용정보(휠체어리프트) (15143843)
- 전국교통약자이동지원센터정보표준데이터 (15028207)
- 국가철도공단_역사별 휠체어리프트 위치 (KRIC-205)
- 역사별 휠체어리프트 이동동선 (KRIC-209)
- 서울교통공사_휠체어리프트 설치현황 (15044262)
- 서울시 지하철 출입구 리프트 위치정보 (OA-21211)
- 서울특별시_자치구별 도보 네트워크 공간정보 (OA-21208)
- 국토교통부_전국 버스정류장 위치정보 (15067528)
- 전국신호등표준데이터 (15028198)
- 전국횡단보도표준데이터 (15028201)
- 서울교통공사_휠체어경사로 설치 현황 (OA-13116)
- 서울시 저상버스 도입 노선 및 노선별 보유율 (OA-22229)
- 한국고용정보원_직업훈련_국민내일배움카드 훈련과정 (Work24 000004)
- 한국고용정보원_구직자취업역량 강화프로그램 (Work24 000098)
- 동기화 스케줄: 매일 자정(Asia/Seoul)
0 0 0 * * * - 실행 잠금: 수동 실행과 정기 실행 충돌 방지를 위해 전역 락 사용
- 정규화 저장:
public_data_record원본과pd_*정규화 테이블 동시 유지 - 변경 최적화: payload hash 비교로 변경건만 정규화 재계산, 미변경건은 수집 시각만 갱신
- 지오코딩: 정규화 단계에서 주소 기반 네이버 지오코딩 수행
- 채용공고(
pd_kepad_recruitment):compAddr->geo_latitude,geo_longitude - 수행기관(
pd_kepad_support_agency):excInstnAddr->geo_latitude,geo_longitude
- 채용공고(
- 품질 보호: 지오코딩 실패는 부분 성공이 아닌 실패로 처리해 데이터 품질 보장
- 가입 완료 시 기본 프로필 1개를 반드시 생성한다.
- 온보딩은 4-2 프로필 입력의 필수 입력만 진행한다.
가입 이탈을 줄이기 위해 스코어링 필수 최소 항목만 필수 유지. 스코어링 품질에 강한 영향이 있는 항목만 필수로 유지.
- 프로필은 사용자당 최대 3개.
- 기본 프로필 1개는 필수 보유(삭제 불가, 기본 변경 가능).
- 내정보에서 등록/수정/삭제.
- 기본: 이름, 성별, 연락처, 이메일, 생년월일, 거주지 상세 주소
- 학력/경력
- 최종 학력(고졸 이하/고졸/전문대졸/대졸/석사/박사/기타)
- 졸업 상태(졸업/졸업예정/재학/수료/중퇴/기타)
- 주요 경력(없으면 신입 표기)
- 직무: 지원 직무(희망 직무 백엔드 API 사용), 보유 기술/역량
- 장애
- 장애 유형(지체장애/뇌병변장애/시각장애/청각장애/언어장애/지적장애/자폐성장애/정신장애/신장장애/심장장애/호흡기장애/간장애/안면장애/장루·요루장애/뇌전증장애/기타)
- 장애 정도(중증/중등도/경증)
- 장애인 등록 여부
- 근무조건
- 가능한 고용형태(정규직/계약직/무기계약직/시간제/일용직/인턴/파견·용역/재택·원격)
- 소개: 자기소개
- 비상 연락처
- 전공, 세부 경력, 프로젝트, 공백 사유
- 자격증, 포트폴리오 URL/파일, 수상, 교육 이수
- 상세 장애 설명, 보조기기, 필요 지원사항
- 근무 가능 시점(즉시/2주 이내/1개월 이내/협의 가능)
- 희망 연봉
- 시간 선호(주간/오전/오후/야간/탄력근무/협의 가능)
- 재택 여부
- 이동 가능 범위
- 지원 동기, 직무 적합성 설명, 커리어 목표, 강점/약점
- 병역(군필/면제/해당없음/복무중)
- 국가유공자 여부
- SNS/개인 웹사이트
프론트에서 매 요청마다 선택. 모든 항목은 선택형(옵션)이며 중복 가능.
- 희망 직무
- 선택 목록은 Spring 스케줄러가 매일 수집한
한국장애인고용공단_장애인 고용직무분류데이터를 트리(대분류 > 중분류 > 소분류) API로 제공
- 선택 목록은 Spring 스케줄러가 매일 수집한
- 희망 근무지역(전국 17개 시/도)
- 서울, 부산, 대구, 인천, 광주, 대전, 울산, 세종, 경기, 강원, 충북, 충남, 전북, 전남, 경북, 경남, 제주
- 고용형태
- 정규직, 계약직, 무기계약직, 시간제, 일용직, 인턴, 파견/용역, 재택/원격
- 급여 방식
- 월급, 연봉, 시급, 일급, 건별/성과급, 회사 내규에 따름, 면접 후 협의
- 카카오/네이버 로그인
- 최초 로그인 시 기본 프로필 필수 항목 입력 완료 후 가입 완료
- 탈퇴 신청(PENDING_DELETION) 계정 로그인 시 토큰 발급 없이 계정 상태/탈퇴 예정 시각/탈퇴취소 토큰 반환
- 탈퇴 신청 취소 시 계정 ACTIVE 복구 및 토큰 재발급
- 직접 입력 저장
- 또는 포트폴리오로 생성하기
- 입력 시 포트폴리오 파일 업로드 -> Spring 파일 검증/중계 -> FastAPI OCR + LLM으로 프로필 초안 생성
- 프로필 최대 3개 관리
- 기본 프로필 지정/변경
- 회원 탈퇴 신청 시 즉시 삭제하지 않고 상태를
PENDING_DELETION으로 전환 - 30일 유예기간 경과 후 배치로 최종 soft delete 처리
- 최종 처리 시 providerUserId/이메일 등 재식별 정보 비식별화 및 재가입 가능 상태 보장
- AI 직무 적합도 토글 ON (비동기)
- 프론트에서 프로필 1개 선택(기본 프로필 최상단 노출)
- Spring -> FastAPI: 사용자 선택 프로필만 전달
- FastAPI: DB 공고를 최신순 조회 후 직무 적합도만 계산
- FastAPI -> Spring: 공고별 직무 적합도 포함 결과 반환
- Spring -> 프론트:
requestId반환(PROCESSING/COMPLETED/FAILED) - 프론트 -> Spring:
GET /api/v1/recommend/tasks/{requestId}로 상태/결과 조회 - 프론트: 화면 필터 적용, 일정 점수 이상 공고 강조
- AI 직무 적합도 토글 OFF (비동기 캐시 동일 규칙)
- FastAPI 호출 없음
- Spring이 DB 공고 최신순 반환
- 프론트가 화면 필터 적용
지도상에 공고 + 기업정보를 나타내며 추가로 근로지원인 수행기관 마커를 함께 표시한다. (백엔드 API)
- 근로지원인 수행기관 데이터는 점수 미반영, 지도 레이어 전용
- AI 스코어링 토글 ON (비동기)
- 프론트에서 프로필 1개 선택
- Spring -> FastAPI: 사용자 선택 프로필만 전달
- FastAPI: DB 공고/공공데이터 직접 조회, 동일 비중 종합 점수 계산
- FastAPI -> Spring: 항목별 점수 + 총점 + 내림차순 결과 반환
- Spring -> 프론트:
requestId반환(PROCESSING/COMPLETED/FAILED) - 프론트 -> Spring:
GET /api/v1/recommend/tasks/{requestId}로 상태/결과 조회 - 프론트: 화면 필터 적용
- AI 스코어링 토글 OFF (비동기 캐시 동일 규칙)
- FastAPI 호출 없음
- Spring이 DB 공고 반환
- 프론트가 화면 필터 적용
- 선택 프로필과 공고/점수 정보를 바탕으로 추천 사유, 주의사항, 체크리스트 생성
- 다음 단계 준비 요약(
next_step_summary) 제공 - 추천 프로그램 목록(
recommended_programs, 최대 2개) 제공 - 추천 프로그램 데이터 출처
- 국민내일배움카드 직업훈련 과정
- 구직자 취업역량 강화 프로그램
- 공고 상세 조회, 인기 공고 조회
- 공고 스크랩/해제, 내 스크랩 목록 조회
- 지역 기반 접근성 지도 서비스는 모바일 화면에서도 공고 위치, 접근성 요약, 상세 정보를 확인할 수 있도록 확장 가능
- 홈 화면에서는 스크랩 공고와 퀵 공고 접근을 함께 제공해 핵심 탐색 동선을 단축
- 기능2: 직무 적합도만 적용
- 기능3: 6개 항목 동일 비중 종합 점수 적용
| 점수 항목 | 공공데이터(명칭/URL) | 사용 컬럼 | 사용자 프로필 사용 항목 |
|---|---|---|---|
| 직무 적합도 | 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) | jobNm, reqCareer, reqEduc, reqMajor, reqLicens, envHandWork, envLiftPower, envStndWalk |
필수: 지원 직무, 보유 기술/역량, 최종 학력, 주요 경력 / 선택: 전공, 자격증, 직무 적합성 설명 |
| 근무조건 적합도 | 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) | empType, enterType, salaryType, salary, termDate |
필수: 가능한 고용형태 / 선택: 근무 가능 시점, 희망 연봉, 시간 선호, 재택 여부 |
| 장애 지원 적합도 | 한국장애인고용공단_장애인 표준사업장 실시간 조회 (15119304), 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) | 표준사업장: compName, compBizNo, compRegNo, compTypeNm, authDate, cancelDate, compCert / 공고: enterType, jobNm, compAddr |
필수: 장애 유형, 장애 정도, 장애인 등록 여부 / 선택: 필요 지원사항, 상세 장애 설명, 보조기기 |
| 업무환경 적합도 | 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) | envBothHands, envEyesight, envLstnTalk, envHandWork, envLiftPower, envStndWalk, jobNm |
필수: 장애 유형, 장애 정도 / 선택: 상세 장애 설명, 보조기기, 이동 가능 범위 |
| 기업 안정성/채용 친화도 | 한국장애인고용공단_장애인 표준사업장 실시간 조회 (15119304), 한국장애인고용공단_장애인 구인 실시간 현황 (15117692) | 표준사업장: compName, compBizNo, authDate, cancelDate, compTypeNm / 공고: busplaName, compAddr, regagnName, offerregDt, regDt |
사용 없음 |
| 접근성 요약 점수 | 교통/보행/편의시설/저상버스/KRIC/ODsay 메타데이터 (아래 세부 목록) | 이동지원센터, KRIC 위치/동선, 서울 리프트, 출입구 리프트, 도보네트워크, 버스정류장, 신호등, 횡단보도, 코레일 편의시설, 경사로, 저상버스, ODsay 통근 메타데이터 | 필수: 거주지 상세주소, 장애 유형, 장애 정도 / 선택: 이동 가능 범위, 보조기기, 필요 지원사항 |
- 전국교통약자이동지원센터정보표준데이터 (15028207)
- 국가철도공단_역사별 휠체어리프트 위치 (KRIC-205)
- 역사별 휠체어리프트 이동동선 (KRIC-209)
- 서울교통공사_휠체어리프트 설치현황 (15044262)
- 서울교통공사_교통약자이용정보 (15143843)
- 서울시 지하철 출입구 리프트 위치정보 (OA-21211)
- 서울특별시_자치구별 도보 네트워크 공간정보 (OA-21208)
- 국토교통부_전국 버스정류장 위치정보 (15067528)
- 전국신호등표준데이터 (15028198)
- 전국횡단보도표준데이터 (15028201)
- 한국철도공사_편의시설정보 (15125774)
- 서울교통공사_휠체어경사로 설치 현황 (OA-13116)
- 서울시 저상버스 도입 노선 및 노선별 보유율 (OA-22229)
- ODsay 대중교통 길찾기 API(외부 교통 메타데이터)
- WCAG 2.2 AA 준수
- 스크린리더 라벨 제공
- 키보드 탐색 가능
- 색상 단독 상태표현 금지
- 지도 정보 목록 대체 제공
- 용어 설명 제공
- 구체적 오류 메시지 제공
- 단계형 온보딩
- Prometheus
- Grafana
- Loki
- Alloy
수집 기준(코드 기준):
- Spring 메트릭:
host.docker.internal:18080/actuator/prometheus,18081슬롯 - FastAPI 메트릭:
host.docker.internal:19000/metrics,19001슬롯 - 로그 수집: Alloy -> Loki 전송
- 대시보드: Grafana provisioning으로
BridgeWork Overview자동 로딩
- Spring 애플리케이션 알림:
SPRING_BOT_DISCORD_WEBHOOK_URL- 동기화 시작/완료/실패
- 회원가입 이벤트
- 관리자 계정 잠금
- Unhandled Exception
- 시스템 헬스체크 장애/복구
- 인프라 알림:
INFRA_ALERT_DISCORD_WEBHOOK_URL- Grafana Alerting contact point로 Discord 전송
- Spring Security + JWT 기반 stateless 인증
- OAuth 소셜 로그인(카카오/네이버)
- CORS 허용 도메인 화이트리스트 관리
- Redis 기반 API Rate Limit
- HSTS/Frame-Deny/Content-Type-Options 보안 헤더 적용
- OCR 업로드 파일 MIME/PDF 시그니처/용량 검증 후 중계
- 운영 시크릿은 환경변수로 분리(
application-prod.yml${...})
- 박민정 (Leader): Frontend, FastAPI Development
- 최성현: Backend, Infrastructure
- 장혜진: Project Planning
- 김수인: UI/UX Design