이어드림

시각장애인을 위한 음성 대화형 AI 고용지원 서비스

1. 필요성

현재 장애인의 고용 접근성은 여전히 낮은 수준에 머물러 있다. 한국장애인고용공단 고용개발원의 2025년 하반기 장애인경제활동실태조사에 따르면, 15세 이상 등록장애인의 경제활동참가율은 35.6%, 고용률은 34.0%, 실업률은 4.4% 로 나타났다. 이는 장애인의 노동시장 참여가 여전히 제한적이며, 구직 정보 접근, 직무 탐색, 지원 준비 과정에서 실질적인 지원 체계가 필요함을 보여준다.

특히 시각장애인은 일반 채용포털을 이용할 때 화면 기반 UI와 복잡한 메뉴 구조를 스크린리더에 의존해 탐색해야 한다. 고용24는 웹접근성을 준수하여 구축되었지만, 시각장애인이 사이트를 이용하려면 화면을 읽어주는 별도의 스크린리더 프로그램이 필요하다고 안내하고 있다. 또한 장애인 맞춤 일자리 찾기 역시 장애인 우대 채용관이나 상세검색의 장애인 희망채용 조건을 사용자가 직접 찾아 설정하는 방식이다.

또한 디지털 취약계층의 정보화 수준은 개선되고 있지만, 여전히 일반 국민 대비 격차가 존재한다. 2025년 디지털 정보격차·웹 접근성 실태조사에 따르면 디지털 취약계층의 디지털정보화 수준은 일반 국민 대비 **77.9%**이며, 웹 접근성 전체 평균 점수는 70.4점으로 조사되었다. 이는 온라인 중심의 구직 환경에서 디지털 접근성과 활용 능력의 차이가 채용 기회 격차로 이어질 수 있음을 의미한다.

따라서 시각장애인을 위한 고용 서비스는 단순히 채용공고를 제공하는 수준을 넘어, 사용자가 말로 원하는 조건을 입력하고, AI가 공공 채용데이터를 조회해 공고를 요약하며, 사용자의 경력·희망조건과 비교해 적합도를 설명하고, 지원서 작성과 면접 준비까지 안내하는 방식으로 확장될 필요가 있다.

본 서비스 이어드림은 이러한 문제를 해결하기 위해 하네스 엔지니어링 기반 AI 고용지원 구조를 적용한다. 즉, 단순히 AI 챗봇이 답변을 생성하는 방식이 아니라, 음성 입력 처리, 공공 채용데이터 조회, 공고 요약, 적합도 분석, 결과 검증, 음성 출력, 사용자 피드백 반영 과정을 하나의 실행 흐름으로 설계한다. 이를 통해 기존의 “사용자가 화면 중심 포털을 직접 탐색하는 방식”을 “AI가 사용자와 음성으로 대화하며 구직 과정을 단계별로 안내하는 방식”으로 전환하고자 한다.

2. 서비스 개요

이어드림은 시각장애인이 음성 대화를 통해 채용공고를 검색하고, 공고 요약·직무 적합도 확인·지원서 작성·면접 준비까지 수행할 수 있도록 돕는 AI 기반 고용지원 서비스이다. 사용자가 원하는 직무, 지역, 근무형태, 장애인 우대 조건을 말하면 서비스가 이를 분석해 공공 채용데이터에서 관련 공고를 조회하고, 긴 채용공고를 듣기 쉬운 형태로 요약해 제공한다.

이어드림은 한국장애인고용공단의 장애인 구인 실시간 현황 API와 고용24 채용정보 서비스를 활용해 실제 채용공고 데이터를 기반으로 동작한다. 한국장애인고용공단 API는 모집기간, 사업장명, 모집직종, 고용형태, 임금, 요구경력, 요구학력, 사업장 주소 등의 구인 정보를 제공하며, 고용24는 채용정보 상세검색, 직종별·지역별 채용정보, 구직신청, 이력서·자기소개서 관리 기능을 제공한다.

이를 통해 이어드림은 기존의 화면 중심 채용포털 탐색 방식을 보완하고, 시각장애인이 말로 일자리를 찾고 지원을 준비할 수 있는 음성 중심 구직 환경을 제공하는 것을 목표로 한다.

---

3. 요구사항 정의서

3.1 문서 목적

본 요구사항 정의서는 이어드림의 1주일 MVP 개발 범위를 정의하고, 공모전 심사기준인 AI 혁신성, 활용성, 실현 가능성, 창의성/차별성, 효과성에 맞춰 핵심 요구사항을 정리하는 것을 목적으로 한다. 공모전은 고용노동 공공데이터와 AI 활용을 요구하며, 주관기관 공공데이터 활용 시 가점이 부여된다. (2026 데이터 공모전)

---

3.2 서비스 개발 방향

이어드림은 시각장애인이 화면 중심 채용포털을 직접 탐색하지 않고, 음성으로 채용공고를 검색하고 결과를 안내받는 기능을 1차 목표로 한다. 이후 선택한 공고에 대해 AI와 대화하며 공고 요약, 직무 적합도 확인, 지원 준비를 수행하도록 확장한다.

1주일 개발 기간을 고려하여 MVP에서는 사용자 간 소통 기능, 상담사 연계, 실제 입사지원 자동화, 기업회원 기능, 정식 로그인 기능은 제외한다.

---

3.3 MVP 단계별 요구사항

단계	범위	설명	MVP 포함 여부
1단계	음성으로 채용공고 찾기	사용자가 음성으로 조건을 말하면 채용공고를 검색하고 결과를 안내	포함
2단계	AI와 소통	선택한 공고에 대해 요약, 적합도 분석, 지원서 초안 생성	포함
3단계	사람들과 소통	구직자, 상담사, 보호자 간 질문·답변·후기 공유	제외, 후속 확장

---

3.4 심사기준 기반 요구사항

심사기준	요구사항 방향	이어드림 적용
AI 혁신성	기존 화면 중심 탐색을 음성·AI 기반 흐름으로 전환	음성 입력 → 조건 추출 → 공고 검색 → AI 요약 → 적합도 분석
활용성	실제 시각장애인이 사용할 수 있어야 함	음성 검색, 음성 안내, 다시 듣기, 쉬운 설명 제공
실현 가능성	1주일 안에 서버 배포와 시연이 가능해야 함	공공 API, Web Speech API, LLM API, 모바일 웹 기반 MVP
창의성/차별성	기존 채용공고 제공 서비스와 달라야 함	단순 공고 목록이 아니라 음성 기반 구직 흐름 제공
효과성	사회적 이익이 명확해야 함	시각장애인의 채용정보 접근성 개선 및 구직 준비 부담 완화

---

3.5 핵심 사용자 요구사항

ID	사용자 요구사항	설명	우선순위
UR-01	사용자는 음성으로 채용공고를 검색할 수 있어야 한다.	“서울에서 사무직 일자리 찾아줘”	P0
UR-02	사용자는 검색된 공고 목록을 음성으로 안내받을 수 있어야 한다.	회사명, 직무, 지역, 고용형태, 임금 중심	P0
UR-03	사용자는 원하는 공고를 선택해 자세한 설명을 들을 수 있어야 한다.	“첫 번째 공고 자세히 알려줘”	P0
UR-04	사용자는 AI에게 공고를 쉽게 요약해달라고 요청할 수 있어야 한다.	긴 공고를 핵심 정보로 요약	P1
UR-05	사용자는 자신의 조건과 공고가 맞는지 물어볼 수 있어야 한다.	희망직무, 지역, 경력, 학력 조건 비교	P1
UR-06	사용자는 선택한 공고 기반 지원동기 초안을 받을 수 있어야 한다.	지원서 작성 보조	P1
UR-07	사용자는 공고 기반 예상 면접 질문을 받을 수 있어야 한다.	면접 준비 보조	P2
UR-08	사용자는 관심 공고를 저장하고 다시 확인할 수 있어야 한다.	브라우저 로컬 저장	P2
UR-09	사용자는 답변을 다시 듣거나 더 쉽게 설명받을 수 있어야 한다.	“다시 말해줘”, “쉽게 설명해줘”	P1

---

3.6 기능 요구사항

ID	기능	요구사항	우선순위
FR-01	음성 입력	사용자의 음성을 텍스트로 변환한다.	P0
FR-02	검색 조건 추출	음성 문장에서 지역, 직무, 근무형태, 키워드를 추출한다.	P0
FR-03	공고 검색	추출된 조건으로 장애인 채용공고를 검색한다.	P0
FR-04	공공데이터 연동	한국장애인고용공단 장애인 구인 실시간 현황 API를 활용한다.	P0
FR-05	검색 결과 안내	검색된 공고를 핵심 정보 중심으로 화면과 음성으로 제공한다.	P0
FR-06	공고 상세 요약	선택한 공고를 AI가 듣기 쉬운 형태로 요약한다.	P1
FR-07	AI 질의응답	사용자가 공고에 대해 질문하면 AI가 답변한다.	P1
FR-08	적합도 분석	사용자 조건과 공고 조건을 비교해 지원 가능성을 설명한다.	P1
FR-09	지원서 초안 생성	선택한 공고 기반 지원동기 또는 자기소개서 초안을 생성한다.	P1
FR-10	면접 질문 생성	공고 기반 예상 면접 질문을 생성한다.	P2
FR-11	관심 공고 저장	관심 공고를 브라우저에 저장하고 재조회한다.	P2
FR-12	오류 안내	음성 인식 실패, 검색 결과 없음, API 오류를 안내한다.	P0

Web Speech API는 브라우저에서 음성 인식과 음성 합성을 제공하지만, SpeechRecognition은 일부 주요 브라우저에서 제한될 수 있으므로 텍스트 입력 fallback을 함께 제공하는 것이 안전하다. (MDN 웹 문서)

---

3.7 데이터 요구사항

이어드림은 실제 채용공고 데이터를 기반으로 동작해야 한다. 한국장애인고용공단의 장애인 구인 실시간 현황 API는 현재 진행 중인 장애인 구인 사업체의 실시간 현황을 제공하며, 모집기간, 사업장명, 모집직종, 고용형태, 임금, 요구경력, 요구학력, 사업장 주소 등의 항목을 포함한다. (데이터.go.kr)

데이터	활용 목적
장애인 구인 실시간 현황 API	장애인 채용공고 검색
공고 상세 데이터	공고 요약, 적합도 분석, 지원서 초안 생성
사용자 입력 조건	검색 조건 추출
사용자 임시 프로필	적합도 분석, 지원서 초안 생성
관심 공고 데이터	저장 공고 재조회

---

3.8 인증 및 로그인 요구사항

1주일 MVP에서는 회원가입 및 로그인 기능을 제외한다.

로그인은 아이디·비밀번호 입력, 오류 처리, 접근성 검증, 개인정보 관리가 필요하므로 MVP 핵심 기능보다 우선순위가 낮다. WCAG 2.2에서도 로그인 과정은 사용자가 쉽게 인증할 수 있도록 접근성이 보장되어야 한다고 설명한다. (W3C)

ID	요구사항	설명
AUTH-01	MVP에서는 로그인 없이 사용할 수 있어야 한다.	공고 검색, 요약, 음성 안내는 비회원 사용
AUTH-02	사용자 프로필은 임시 입력 방식으로 처리한다.	희망직무, 희망지역, 경력, 보유역량
AUTH-03	관심 공고는 브라우저 로컬 저장소에 저장한다.	서버 계정 저장 제외
AUTH-04	민감정보는 저장하지 않는다.	주민등록번호, 장애등록번호, 상세 주소 제외
AUTH-05	정식 로그인은 후속 확장으로 분류한다.	접근성 로그인 화면은 V2에서 검토

---

3.9 MVP 포함 범위

기능	포함 여부	사유
음성 기반 채용공고 검색	포함	서비스 핵심
공공데이터 기반 공고 조회	포함	공모전 데이터 활용성 확보
검색 결과 음성 안내	포함	시각장애인 대상 핵심
AI 공고 요약	포함	AI 활용성 확보
AI 질의응답	포함	AI 소통 흐름 구현
적합도 분석	포함	차별성 강화
지원서 초안 생성	포함	실제 활용성 강화
면접 질문 생성	선택 포함	시간 남으면 구현
관심 공고 저장	선택 포함	구현 난이도 낮음
로그인/회원가입	제외	1주일 MVP 범위 초과
사용자 간 소통	제외	게시판, 로그인, 신고, 운영관리 필요
실제 입사지원 자동화	제외	외부 포털 로그인 및 개인정보 처리 필요
기업회원 기능	제외	MVP 핵심 범위 아님
상담사 관리 기능	제외	후속 확장 기능

---

3.10 개발 우선순위

우선순위	구현 항목
P0	음성 입력, 조건 추출, 장애인 구인 API 검색, 검색 결과 음성 안내, 오류 안내
P1	AI 공고 요약, AI 질의응답, 적합도 분석, 지원서 초안 생성
P2	면접 질문 생성, 관심 공고 저장
V2	로그인, 사용자 간 소통, 상담사 연계, 실제 입사지원 자동화

---

3.11 요구사항 정의 요약

이어드림의 MVP는 음성으로 채용공고가 실제로 찾아지는지를 먼저 증명하는 것을 목표로 한다. 사용자는 음성으로 원하는 일자리 조건을 말하고, 시스템은 이를 분석해 장애인 구인 공공데이터에서 공고를 검색한 뒤 결과를 음성으로 안내한다. 이후 사용자는 선택한 공고에 대해 AI와 대화하며 공고 요약, 적합도 분석, 지원서 초안 생성을 받을 수 있다.

사용자 간 소통 기능은 서비스 확장 방향으로는 의미가 있지만, 로그인, 게시글 관리, 신고 처리, 개인정보 보호 이슈가 함께 필요하므로 1주일 MVP에서는 제외한다. 따라서 MVP 범위는 음성 공고 검색 → 공고 음성 안내 → AI와 공고 기반 소통까지로 한정한다.

---

4. 요구사항 명세서

4.1 서비스 목표

이어드림은 시각장애인이 음성으로 채용공고를 검색하고, AI와 대화하며 자신에게 맞는 공고를 찾고, 해당 공고 지원자 채팅방의 내용을 음성으로 확인할 수 있도록 돕는 서비스이다.

MVP에서는 완성형 고용포털이 아니라, 다음 세 가지 핵심 흐름을 구현한다.

음성으로 공고 검색
→ AI와 공고 기반 대화
→ 공고별 채팅방 내용 음성 확인

---

4.2 핵심 기능 요구사항

ID	기능	설명	우선순위
FR-01	음성 공고 검색	사용자가 음성으로 원하는 직무, 지역, 근무형태를 말하면 채용공고를 검색한다.	필수
FR-02	검색 결과 음성 안내	검색된 공고의 회사명, 직무, 지역, 임금, 고용형태를 음성으로 안내한다.	필수
FR-03	AI 공고 대화	사용자가 선택한 공고에 대해 질문하면 AI가 공고 정보를 바탕으로 답변한다.	필수
FR-04	AI 공고 추천 보조	사용자의 희망 조건과 공고 정보를 비교해 어떤 공고가 더 맞는지 설명한다.	필수
FR-05	공고별 채팅방	각 채용공고마다 지원자들이 대화할 수 있는 채팅방을 제공한다.	필수
FR-06	채팅방 음성 읽기	사용자가 채팅방의 최근 메시지나 주요 내용을 음성으로 들을 수 있다.	필수
FR-07	음성 채팅 입력	사용자가 말한 내용을 채팅 메시지로 전송할 수 있다.	선택
FR-08	채팅 내용 AI 요약	AI가 채팅방 내용을 요약해 지원자들이 주로 말하는 내용을 알려준다.	선택

---

4.3 MVP 동작 흐름

1. 사용자가 “서울 사무직 일자리 찾아줘”라고 말한다.

2. 시스템이 음성을 텍스트로 변환한다.

3. 시스템이 지역, 직무, 근무형태 조건을 추출한다.

4. 공공 채용데이터에서 조건에 맞는 공고를 검색한다.

5. 검색 결과를 음성으로 읽어준다.

6. 사용자가 특정 공고를 선택한다.

7. 사용자는 AI에게 “이 공고 나한테 맞아?”, “월급 얼마야?”, “지원 조건 뭐야?”라고 질문한다.

8. AI가 공고 정보를 바탕으로 답변한다.

9. 사용자는 해당 공고의 채팅방에 들어간다.

10. 시스템이 채팅방의 최근 메시지 또는 요약 내용을 음성으로 읽어준다.

---

4.4 데이터 활용 요구사항

데이터	활용 목적
한국장애인고용공단 장애인 구인 API	장애인 채용공고 검색
채용공고 상세 정보	AI 공고 요약, 공고 질의응답, 적합도 분석
사용자 음성 입력	공고 검색 조건 추출, AI 질문 입력, 채팅 입력
공고별 채팅 메시지	지원자 간 정보 공유, 음성 읽기, AI 요약
사용자 희망 조건	공고 추천 보조

한국장애인고용공단의 장애인 구인 실시간 현황 API는 모집기간, 사업장명, 모집직종, 고용형태, 임금, 요구경력, 요구학력, 사업장 주소 등의 항목을 제공하므로 MVP의 공고 검색 데이터로 활용할 수 있다. (데이터.go.kr)

---

4.5 기능별 입출력 명세

기능	입력	처리	출력
음성 공고 검색	사용자 음성	STT 변환, 검색 조건 추출	검색 조건
공고 검색	지역, 직무, 근무형태	공공 API 조회	공고 목록
검색 결과 안내	공고 목록	핵심 정보 정리, TTS 변환	음성 안내
AI 공고 대화	사용자 질문, 선택 공고	공고 정보 기반 AI 답변 생성	답변
공고 추천 보조	사용자 조건, 공고 목록	조건 비교	추천 설명
공고별 채팅방	공고 ID	해당 공고 채팅방 조회	메시지 목록
채팅방 음성 읽기	채팅 메시지	TTS 변환 또는 AI 요약	음성 안내
음성 채팅 입력	사용자 음성	STT 변환 후 메시지 저장	채팅 메시지

Web Speech API는 음성 인식과 음성 합성을 제공하므로 브라우저 기반 MVP에서 음성 입력과 음성 안내 기능을 구현할 수 있다. 다만 SpeechRecognition은 일부 주요 브라우저에서 동작하지 않을 수 있으므로, 텍스트 입력 fallback을 함께 제공하는 것이 안전하다. (MDN 웹 문서)

---

4.6 채팅 기능 명세

기능	설명
공고별 채팅방 생성	사용자가 특정 공고를 선택하면 해당 공고 전용 채팅방을 제공한다.
메시지 작성	사용자는 텍스트 또는 음성으로 메시지를 작성할 수 있다.
메시지 조회	사용자는 채팅방의 최근 메시지를 확인할 수 있다.
메시지 음성 읽기	시스템은 최근 메시지를 음성으로 읽어준다.
채팅 요약	AI가 최근 대화 내용을 요약해 지원자들이 주로 이야기하는 내용을 알려준다.

채팅방은 실시간성이 필요하므로 WebSocket 기반으로 구현할 수 있다. WebSocket은 브라우저와 서버 사이에 양방향 통신 세션을 열어 서버 응답을 반복적으로 요청하지 않고도 메시지를 주고받을 수 있게 한다. (MDN 웹 문서)

---

4.7 MVP 제외 기능

제외 기능	제외 이유
정식 로그인/회원가입	해커톤 MVP 범위 초과
실제 입사지원 자동화	외부 포털 로그인과 개인정보 제출 필요
기업 회원 기능	핵심 시연 범위 아님
상담사 연계	기관 계정과 상담 관리 기능 필요
음성 생체 로그인	보안·개인정보 이슈가 큼
복잡한 커뮤니티 운영 기능	신고, 차단, 관리자 기능은 후속 확장으로 분리

---

4.8 최종 MVP 범위

이어드림 MVP는 음성 공고 검색, AI 공고 대화, 공고별 채팅방 음성 읽기를 핵심 기능으로 한다. 사용자는 음성으로 원하는 채용공고를 찾고, AI에게 공고 내용을 질문하며, 해당 공고에 관심 있는 다른 사용자들의 채팅 내용을 음성으로 들을 수 있다. 이를 통해 이어드림은 단순 채용공고 검색을 넘어, 공고 탐색·AI 상담·지원자 간 정보 공유를 하나의 음성 중심 구직 흐름으로 연결한다.

---

5. 기능 명세서

5.1 핵심 기능 요약

이어드림의 핵심 기능은 음성 공고 검색, AI 공고 대화, 공고별 채팅방 음성 소통이다. 사용자는 음성으로 원하는 채용공고를 찾고, AI와 대화하며 공고 내용을 이해한 뒤, 해당 공고에 관심 있는 사람들의 채팅 내용을 음성으로 들을 수 있다.

구분	핵심 기능	설명
1	음성 공고 검색	사용자가 음성으로 원하는 조건을 말하면 채용공고를 검색
2	공고 음성 안내	검색된 공고의 핵심 정보를 음성으로 읽어줌
3	AI 공고 대화	선택한 공고에 대해 AI와 질문·답변
4	공고별 채팅방	공고마다 지원자들이 대화할 수 있는 채팅방 제공
5	채팅 음성 읽기	채팅방의 최근 메시지나 요약 내용을 음성으로 안내

---

5.2 기능 1. 음성 공고 검색

항목	내용
기능 목적	시각장애인이 화면 입력 없이 음성으로 채용공고를 검색할 수 있게 한다.
사용자 입력	“서울에서 사무직 일자리 찾아줘”, “재택 가능한 공고 찾아줘”
처리 방식	음성 → 텍스트 변환 후 지역, 직무, 근무형태 등 검색 조건 추출
출력 결과	조건에 맞는 채용공고 목록
사용 기술	Web Speech API, 공공 채용데이터 API
예외 처리	음성 인식 실패 시 텍스트 입력으로 검색 가능

Web Speech API는 음성 인식과 음성 합성 기능을 제공하므로 브라우저 기반 MVP에서 음성 입력과 음성 안내를 구현할 수 있다. 다만 SpeechRecognition은 일부 브라우저에서 지원되지 않을 수 있으므로 텍스트 입력 fallback이 필요하다. (MDN 웹 문서)

---

5.3 기능 2. 공고 음성 안내

항목	내용
기능 목적	검색된 공고를 시각장애인이 화면을 보지 않고 이해할 수 있게 한다.
입력 데이터	검색된 채용공고 목록
처리 방식	회사명, 직무, 지역, 임금, 고용형태 등 핵심 정보만 정리
출력 결과	“첫 번째 공고는 서울 소재 사무보조직이며, 고용형태는 계약직입니다.”
사용 기술	TTS, 공고 데이터 요약
예외 처리	공고 정보가 부족하면 “해당 정보는 공고에 표시되지 않았습니다”라고 안내

장애인 구인 실시간 현황 API는 모집기간, 사업장명, 모집직종, 고용형태, 임금, 요구경력, 요구학력, 사업장 주소 등의 항목을 제공하므로 공고 검색과 안내에 활용할 수 있다. (데이터.go.kr)

---

5.4 기능 3. AI 공고 대화

항목	내용
기능 목적	사용자가 선택한 공고에 대해 AI와 대화하며 필요한 정보를 쉽게 이해하게 한다.
사용자 입력	“이 공고 나한테 맞아?”, “월급 얼마야?”, “지원 조건 알려줘”, “지원동기 써줘”
처리 방식	선택한 공고 데이터와 사용자 질문을 함께 AI에 전달
출력 결과	공고 기반 답변, 적합도 설명, 지원동기 초안
사용 기술	LLM API
예외 처리	공고 데이터에 없는 내용은 단정하지 않고 “공고에 명시되어 있지 않습니다”라고 안내

---

5.5 기능 4. 공고별 채팅방

항목	내용
기능 목적	같은 공고에 관심 있는 사용자들이 질문, 후기, 준비 정보를 공유할 수 있게 한다.
사용자 입력	채팅 메시지 작성
처리 방식	공고 ID 기준으로 채팅방 생성 및 메시지 저장
출력 결과	해당 공고 채팅방 메시지 목록
사용 기술	WebSocket 또는 기본 REST 방식
예외 처리	네트워크 오류 시 메시지 전송 실패 안내

WebSocket API는 브라우저와 서버 사이에 양방향 통신 세션을 열어 서버를 반복 호출하지 않고 메시지를 주고받을 수 있게 한다. 그래서 실시간 채팅 기능에 활용할 수 있다. (MDN 웹 문서)

---

5.6 기능 5. 채팅 음성 읽기

항목	내용
기능 목적	시각장애인이 채팅방 내용을 직접 읽지 않고 음성으로 확인할 수 있게 한다.
사용자 입력	“최근 메시지 읽어줘”, “채팅방 요약해줘”
처리 방식	최근 채팅 메시지를 TTS로 읽거나 AI가 요약
출력 결과	최근 메시지 음성 안내 또는 채팅방 요약
사용 기술	TTS, LLM 요약
예외 처리	메시지가 없으면 “아직 채팅 메시지가 없습니다”라고 안내

---

5.7 MVP 기능 우선순위

우선순위	기능
P0	음성 공고 검색, 공고 음성 안내
P1	AI 공고 대화
P2	공고별 채팅방, 채팅 음성 읽기
제외	로그인, 실제 입사지원 자동화, 기업회원, 상담사 관리

---

5.8 시연 시나리오

1. 사용자가 “서울에서 사무직 일자리 찾아줘”라고 말한다.

2. 이어드림이 음성을 인식하고 조건을 추출한다.

3. 공공데이터에서 관련 채용공고를 검색한다.

4. 이어드림이 검색 결과를 음성으로 읽어준다.

5. 사용자가 “첫 번째 공고 자세히 알려줘”라고 말한다.

6. AI가 공고 내용을 쉽게 요약한다.

7. 사용자가 “이 공고 지원자 채팅방 읽어줘”라고 말한다.

8. 이어드림이 해당 공고 채팅방의 최근 메시지를 음성으로 읽어준다.

9. 사용자가 “채팅방에 질문 남겨줘. 면접 경험 있으신 분 있나요?”라고 말한다.

10. 이어드림이 음성을 채팅 메시지로 변환해 전송한다.

---

5.9 최종 기능 범위

이어드림 MVP는 음성으로 채용공고를 검색하고, AI와 대화하며 공고를 이해하고, 공고별 채팅방 내용을 음성으로 확인하는 기능까지 구현한다. 이를 통해 시각장애인이 화면 중심 채용포털을 직접 탐색하지 않아도, 공고 탐색·공고 이해·지원자 간 정보 공유를 음성 중심으로 수행할 수 있도록 한다.

6. 화면/음성 흐름 설계

6.1 전체 흐름

서비스 진입
→ 음성 안내 시작
→ 음성으로 공고 검색
→ 검색 결과 음성 안내
→ 공고 선택
→ AI와 공고 대화
→ 공고별 채팅방 이동
→ 채팅 내용 음성 읽기
→ 음성으로 채팅 참여

Web Speech API는 음성 인식과 음성 합성 기능을 제공하므로, 브라우저 기반 MVP에서 음성 입력과 음성 안내를 구현할 수 있다. 다만 SpeechRecognition은 일부 주요 브라우저에서 지원되지 않을 수 있어 텍스트 입력도 함께 제공한다. (MDN 웹 문서)

---

6.2 화면별 흐름

화면	화면 구성	음성 흐름
1. 시작 화면	서비스명, “음성 안내 시작하기” 버튼	사용자가 버튼을 누르면 “원하는 일자리를 말씀해 주세요” 안내
2. 공고 검색 화면	음성 검색 버튼, 텍스트 입력창	사용자가 “서울 사무직 찾아줘”라고 말함
3. 검색 결과 화면	공고 카드 목록	“첫 번째 공고는 OO회사 사무직입니다”처럼 순서대로 안내
4. 공고 상세 화면	공고 정보, AI 질문 버튼	“이 공고에 대해 궁금한 점을 물어보세요” 안내
5. AI 대화 화면	질문 입력창, AI 답변 영역	사용자가 “이 공고 나한테 맞아?”라고 질문하면 AI가 답변
6. 공고별 채팅방	메시지 목록, 입력창, 읽어주기 버튼	“최근 메시지를 읽어드릴까요?” 안내
7. 채팅 입력 화면	음성 입력 버튼, 메시지 전송 버튼	사용자가 말한 내용을 텍스트로 변환해 채팅 전송

---

6.3 상세 사용자 흐름

1) 시작 화면

항목	내용
화면 요소	서비스명, 설명 문구, 음성 안내 시작 버튼
사용자 행동	“음성 안내 시작하기” 버튼 클릭 또는 Enter
음성 안내	“안녕하세요. 이어드림입니다. 원하는 일자리를 말씀해 주세요.”
다음 단계	공고 검색 화면으로 이동

사이트 진입 즉시 자동 음성 재생은 피한다. 자동 재생 음성은 스크린리더 사용자의 탐색을 방해할 수 있고, WCAG도 자동 재생 오디오에 대해 정지·일시정지·볼륨 조절 수단을 요구한다. (W3C)

---

2) 음성 공고 검색 화면

항목	내용
화면 요소	음성 검색 버튼, 텍스트 검색창, 검색 버튼
사용자 음성	“서울에서 사무직 일자리 찾아줘”
시스템 처리	음성 인식 → 텍스트 변환 → 지역/직무/근무형태 추출
화면 출력	추출된 검색 조건 표시
음성 출력	“서울, 사무직 조건으로 공고를 찾아볼게요.”

---

3) 검색 결과 화면

항목	내용
화면 요소	공고 카드 목록
공고 카드 정보	회사명, 직무, 지역, 임금, 고용형태
음성 안내	“검색 결과 3개를 찾았습니다. 첫 번째 공고는 OO회사 사무보조직입니다.”
사용자 명령	“첫 번째 공고 자세히 알려줘”, “다음 공고 읽어줘”
다음 단계	공고 상세 화면

---

4) 공고 상세 + AI 대화 화면

항목	내용
화면 요소	공고 상세 정보, AI에게 질문하기 버튼, 질문 입력창
사용자 질문	“이 공고 나한테 맞아?”, “월급 얼마야?”, “지원 조건 알려줘”
시스템 처리	선택 공고 데이터 + 사용자 질문을 AI에 전달
AI 응답	공고 데이터 기반 답변
음성 출력	AI 답변을 TTS로 읽어줌
예외	공고에 없는 정보는 “공고에 명시되어 있지 않습니다”라고 안내

---

5) 공고별 채팅방 화면

항목	내용
화면 요소	채팅 메시지 목록, 최근 메시지 읽기 버튼, 채팅 입력창
사용자 명령	“지원자 채팅방 읽어줘”
시스템 처리	해당 공고 채팅방의 최근 메시지 조회
음성 출력	“최근 메시지 3개를 읽어드릴게요…”
추가 기능	“채팅방 요약해줘” 요청 시 AI가 대화 요약
다음 단계	음성 채팅 입력

---

6) 음성 채팅 입력 흐름

항목	내용
사용자 음성	“면접 경험 있으신 분 있나요?”
시스템 처리	음성 → 텍스트 변환
화면 출력	변환된 메시지 미리보기
사용자 확인	“전송” 버튼 또는 “보내줘”
결과	채팅방에 메시지 등록
음성 안내	“메시지를 전송했습니다.”

---

6.4 시연용 대표 시나리오

1. 사용자가 이어드림에 접속한다.

2. 사용자가 “음성 안내 시작하기” 버튼을 누른다.

3. 이어드림이 “원하는 일자리를 말씀해 주세요”라고 안내한다.

4. 사용자가 “서울에서 사무직 일자리 찾아줘”라고 말한다.

5. 이어드림이 조건에 맞는 채용공고를 검색한다.

6. 이어드림이 “검색 결과 3개를 찾았습니다. 첫 번째 공고는...”이라고 읽어준다.

7. 사용자가 “첫 번째 공고 자세히 알려줘”라고 말한다.

8. AI가 공고 내용을 쉽게 요약해준다.

9. 사용자가 “이 공고 지원자 채팅방 읽어줘”라고 말한다.

10. 이어드림이 해당 공고 채팅방의 최근 메시지를 음성으로 읽어준다.

11. 사용자가 “면접 경험 있으신 분 있나요? 라고 보내줘”라고 말한다.

12. 이어드림이 음성을 메시지로 변환해 채팅방에 전송한다.

---

6.5 화면/음성 흐름 요약

이어드림의 화면/음성 흐름은 버튼으로 음성 안내를 시작하고, 음성으로 채용공고를 검색한 뒤, AI와 공고에 대해 대화하고, 공고별 채팅방 내용을 음성으로 읽고 참여하는 구조이다. 해커톤 MVP에서는 복잡한 회원가입이나 실제 입사지원 자동화보다, 음성 기반 공고 탐색과 공고별 채팅방 음성 접근을 시연하는 데 집중한다.

7. API / DB / 시스템 구조 설계

해커톤 MVP 기준으로 v0 + React/Vite + FastAPI + SQLite 구조로 간단하게 간다. v0는 React, Tailwind CSS, shadcn/ui 기반 UI 초안을 빠르게 만들 수 있고, FastAPI는 REST API와 WebSocket을 모두 지원하므로 공고 검색·AI 대화·채팅 기능을 한 서버에서 처리할 수 있다. (Vercel)

---

7.1 전체 시스템 구조

[사용자]
  ↓
[v0로 생성한 React/Vite 프론트엔드]
  ├─ 화면 UI
  ├─ STT: 음성 → 텍스트
  └─ TTS: 텍스트 → 음성

  ↓ REST API / WebSocket

[FastAPI 백엔드]
  ├─ 채용공고 검색 API
  ├─ AI 공고 대화 API
  ├─ 공고별 채팅방 API
  ├─ WebSocket 채팅
  └─ DB 저장/조회

  ↓

[외부 API / DB]
  ├─ 한국장애인고용공단 장애인 구인 API
  ├─ LLM API
  └─ SQLite DB

---

7.2 기술 스택

영역	기술	역할
UI 초안	v0	메인 화면, 공고 검색 화면, AI 대화 화면, 채팅방 화면 생성
Frontend	React + Vite	v0에서 만든 UI에 실제 기능 연결
음성 입력	Web Speech API SpeechRecognition	사용자의 음성을 텍스트로 변환
음성 출력	Web Speech API SpeechSynthesis	공고 결과, AI 답변, 채팅 내용을 음성으로 출력
Backend	FastAPI	공고 검색, AI 요청, 채팅방 API 처리
실시간 채팅	FastAPI WebSocket	공고별 채팅 메시지 송수신
DB	SQLite	해커톤 MVP용 공고 캐시, 채팅방, 메시지 저장
외부 공고 API	한국장애인고용공단 장애인 구인 API	장애인 채용공고 데이터 조회
AI	LLM API	공고 요약, 공고 질의응답, 채팅 요약

Web Speech API는 음성 인식과 음성 합성으로 구성되어 웹앱에 음성 기능을 붙일 수 있다. 다만 SpeechRecognition은 일부 브라우저에서 지원이 제한될 수 있으므로 텍스트 입력도 함께 제공한다. (MDN 웹 문서)

---

7.3 외부 API 설계

API	사용 목적	주요 데이터
한국장애인고용공단 장애인 구인 실시간 현황 API	장애인 채용공고 검색	모집기간, 사업장명, 모집직종, 고용형태, 임금, 요구경력, 요구학력, 사업장 주소
LLM API	공고 요약, AI 질의응답, 채팅방 요약	선택 공고 정보, 사용자 질문, 채팅 메시지

한국장애인고용공단 API는 현재 진행 중인 장애인 구인 사업체의 실시간 현황 데이터를 제공하므로, 이어드림 MVP의 공고 검색 데이터로 사용한다. (데이터.go.kr)

---

7.4 내부 API 설계

공고 검색 API

항목	내용
Method	GET
URL	/api/jobs/search
Query	keyword, region, work_type
설명	사용자의 음성 검색 조건으로 채용공고를 조회한다.

{
  "keyword": "사무직",
  "region": "서울",
  "work_type": "재택"
}

공고 상세 조회 API

항목	내용
Method	GET
URL	/api/jobs/{job_id}
설명	선택한 공고의 상세 정보를 조회한다.

AI 공고 대화 API

항목	내용
Method	POST
URL	/api/ai/job-chat
Body	job_id, question
설명	선택한 공고 정보를 바탕으로 AI 답변을 생성한다.

{
  "job_id": 1,
  "question": "이 공고 나한테 맞아?"
}

공고별 채팅방 조회 API

항목	내용
Method	GET
URL	/api/jobs/{job_id}/chatroom
설명	특정 공고의 채팅방을 조회한다. 없으면 생성한다.

채팅 메시지 조회 API

항목	내용
Method	GET
URL	/api/chatrooms/{chatroom_id}/messages
설명	공고별 채팅방의 최근 메시지를 조회한다.

채팅방 요약 API

항목	내용
Method	POST
URL	/api/ai/chat-summary
Body	chatroom_id
설명	채팅방 최근 메시지를 AI가 요약한다.

---

7.5 WebSocket 설계

항목	내용
WebSocket URL	/ws/chat/{chatroom_id}
목적	공고별 채팅방 실시간 메시지 송수신
클라이언트 전송	닉네임, 메시지 내용
서버 처리	메시지 저장 후 같은 채팅방 사용자에게 broadcast
출력	새 메시지 이벤트

{
  "nickname": "익명사용자",
  "content": "이 공고 면접 경험 있으신 분 있나요?"
}

FastAPI는 WebSocket 객체를 통해 클라이언트와 데이터를 주고받을 수 있으므로 공고별 실시간 채팅 구현에 사용할 수 있다. (FastAPI)

---

7.6 DB 설계

해커톤 MVP에서는 회원가입을 제외하고, 익명 닉네임 기반으로 처리한다.

job_posts

컬럼	타입	설명
id	INTEGER PK	내부 공고 ID
external_id	TEXT	외부 API 공고 식별값
company_name	TEXT	사업장명
job_title	TEXT	모집직종
employment_type	TEXT	고용형태
salary	TEXT	임금
experience	TEXT	요구경력
education	TEXT	요구학력
address	TEXT	사업장 주소
recruit_period	TEXT	모집기간
cached_at	DATETIME	캐시 저장 시각

chat_rooms

컬럼	타입	설명
id	INTEGER PK	채팅방 ID
job_post_id	INTEGER FK	공고 ID
title	TEXT	채팅방 이름
created_at	DATETIME	생성 시각

chat_messages

컬럼	타입	설명
id	INTEGER PK	메시지 ID
chat_room_id	INTEGER FK	채팅방 ID
nickname	TEXT	익명 닉네임
content	TEXT	메시지 내용
created_at	DATETIME	작성 시각

ai_conversations

컬럼	타입	설명
id	INTEGER PK	AI 대화 ID
job_post_id	INTEGER FK	공고 ID
question	TEXT	사용자 질문
answer	TEXT	AI 답변
created_at	DATETIME	생성 시각

---

7.7 ERD

erDiagram
    JOB_POSTS ||--|| CHAT_ROOMS : has
    CHAT_ROOMS ||--o{ CHAT_MESSAGES : contains
    JOB_POSTS ||--o{ AI_CONVERSATIONS : referenced_by

    JOB_POSTS {
        integer id PK
        text external_id
        text company_name
        text job_title
        text employment_type
        text salary
        text experience
        text education
        text address
        text recruit_period
        datetime cached_at
    }

    CHAT_ROOMS {
        integer id PK
        integer job_post_id FK
        text title
        datetime created_at
    }

    CHAT_MESSAGES {
        integer id PK
        integer chat_room_id FK
        text nickname
        text content
        datetime created_at
    }

    AI_CONVERSATIONS {
        integer id PK
        integer job_post_id FK
        text question
        text answer
        datetime created_at
    }

Loading

---

7.8 아키텍처 다이어그램

flowchart TD
    User[사용자] --> Browser[v0 기반 React/Vite 화면]

    Browser --> STT[SpeechRecognition<br/>음성 → 텍스트]
    Browser --> TTS[SpeechSynthesis<br/>텍스트 → 음성]

    Browser -->|REST API| FastAPI[FastAPI 서버]
    Browser -->|WebSocket| ChatWS[FastAPI WebSocket]

    FastAPI --> JobAPI[한국장애인고용공단<br/>장애인 구인 API]
    FastAPI --> LLM[LLM API]
    FastAPI --> DB[(SQLite DB)]

    ChatWS --> DB

    DB --> Jobs[job_posts]
    DB --> Rooms[chat_rooms]
    DB --> Messages[chat_messages]
    DB --> AILogs[ai_conversations]

Loading

---

7.9 시퀀스 다이어그램: 음성 공고 검색

sequenceDiagram
    actor User as 사용자
    participant Browser as React Browser
    participant API as FastAPI
    participant JobAPI as 장애인 구인 API
    participant DB as SQLite

    User->>Browser: "서울 사무직 찾아줘" 음성 입력
    Browser->>Browser: SpeechRecognition으로 텍스트 변환
    Browser->>API: GET /api/jobs/search?region=서울&keyword=사무직
    API->>JobAPI: 장애인 구인 공고 조회
    JobAPI-->>API: 공고 목록 반환
    API->>DB: 공고 캐시 저장
    API-->>Browser: 공고 목록 반환
    Browser->>User: SpeechSynthesis로 검색 결과 음성 안내

Loading

---

7.10 시퀀스 다이어그램: AI 공고 대화

sequenceDiagram
    actor User as 사용자
    participant Browser as React Browser
    participant API as FastAPI
    participant DB as SQLite
    participant LLM as LLM API

    User->>Browser: "이 공고 나한테 맞아?" 음성 질문
    Browser->>Browser: SpeechRecognition으로 텍스트 변환
    Browser->>API: POST /api/ai/job-chat
    API->>DB: 선택 공고 정보 조회
    DB-->>API: 공고 상세 정보 반환
    API->>LLM: 공고 정보 + 사용자 질문 전달
    LLM-->>API: AI 답변 반환
    API->>DB: AI 대화 기록 저장
    API-->>Browser: AI 답변 반환
    Browser->>User: SpeechSynthesis로 답변 음성 안내

Loading

---

7.11 시퀀스 다이어그램: 공고별 채팅방

sequenceDiagram
    actor User as 사용자
    participant Browser as React Browser
    participant WS as FastAPI WebSocket
    participant API as FastAPI
    participant DB as SQLite

    User->>Browser: 공고 채팅방 입장
    Browser->>API: GET /api/jobs/{job_id}/chatroom
    API->>DB: 채팅방 조회 또는 생성
    DB-->>API: 채팅방 정보 반환
    API-->>Browser: 채팅방 정보 반환

    Browser->>WS: WebSocket 연결 /ws/chat/{chatroom_id}
    User->>Browser: "면접 경험 있으신 분 있나요?" 음성 입력
    Browser->>Browser: SpeechRecognition으로 메시지 변환
    Browser->>WS: 채팅 메시지 전송
    WS->>DB: 메시지 저장
    WS-->>Browser: 새 메시지 broadcast
    Browser->>User: SpeechSynthesis로 "메시지를 전송했습니다" 안내

Loading

---

7.12 최종 요약

이어드림 MVP는 v0로 생성한 React/Vite 프론트엔드와 FastAPI 백엔드, SQLite DB로 구성한다. 사용자의 음성 입력과 음성 출력은 브라우저의 Web Speech API로 처리하고, FastAPI는 채용공고 검색, AI 공고 대화, 공고별 채팅방, WebSocket 채팅을 담당한다. 채용공고 데이터는 한국장애인고용공단 장애인 구인 API에서 조회하고, 공고 캐시와 채팅 메시지는 SQLite에 저장한다.

8. 개발 과정

8.1 요약

개발과정은 아래처럼 총 3개의 버전으로 나눠서 진행되는 점진적 개발 방식으로 진행한다.

• v1 : 음성으로 채용공고 찾아지는 기능
• v2 : ai 소통
• v3 : 사람들과의 소통