Audisay

---

Audisay는 시각장애인을 위한 AI 기반 접근성 도서 지원 서비스입니다.

우리 서비스는 시각장애인이 쉽게 접근할 수 있는 도서 자료를 자동으로 제작하고, 사용자 친화적인 인터페이스를 제공하여 시각장애인 독서의 불편함을 해소하고자 합니다.

이예림	강동완	강상찬	김아름	안치숙	이지혜
팀장 & Backend	Frontend	Frontend	Backend	Backend	Backend
GitHub	GitHub	GitHub	GitHub	GitHub	GitHub

---

목차

---

1. 프로젝트 소개

• 🔍 프로젝트 개요

• 🏹 서비스 주제 및 목표

• 🎬 기획 배경

• 🎁 기대 효과

2. 프로젝트 결과물

• 🔮 주요 기능

3. 프로젝트 정보

• 🏡 개발 스택

• 🧩 아키텍처

• 🎨 API 명세서

• 📚 ERD 설계

• 📝 컨벤션

• 🥰 팀원 소개

• 📽️ UCC

---

1. 프로젝트 소개

🔍 프로젝트 개요

삼성 청년 SW 아카데미(SSAFY) 자율 프로젝트

주제: 시각장애인을 위한 AI 기반 접근성 도서 지원 서비스

진행 기간: 2024-10-14 ~ 2024-11-19 (약 5주)

팀 명 / 진행 인원: 팔자좋조 / 6인

---

🏹 서비스 주제 및 목표

시각장애인을 위한 AI 기반 접근성 도서 지원 서비스

✨ 우리의 목표

AI 기술을 활용하여 시각장애인을 위한 대체자료를 자동으로 제작하고, 이를 기반으로 접근성 중심의 독서 앱을 개발하는 것

✨ Audisay

Audio와 Say를 결합했습니다. TTS 기반 도서 뷰어를 제공하는 우리 서비스를 나타내고자 했습니다.

---

🎬 기획 배경

현재 시각장애인을 위한 접근성 도서의 수는 부족하고 도서 제작 과정도 수작업으로 진행되고 있기 때문에, 이 과정을 자동화하고자 합니다.

---

🎁 기대 효과

---

2. 프로젝트 결과물

---

🔮 주요 기능

도서 등록

• 다양한 파일 형식 업로드 지원(pdf, epub, jpeg, jpg)
• 자동으로 접근성 적용된 EPUB 파일로 변환
• 실시간 변환 진행 상황 확인 가능

도서 뷰어

- TTS 배속 조절 기능 - 이미지 설명 TTS 지원 - 본문 내 키워드 검색 - 문장 저장을 통한 독서노트 생성

도서 검색

• 제목, 작가, 출판사 검색
• 정확하지 않은 단어로도 원하는 도서 결과 확인 가능
• 최신순, 가나다순으로 원하는 방식으로 정렬

리뷰, 도서 담기, 좋아요

• 리뷰 작성 및 다른 독자들의 리뷰와 평점 분포 확인
• 관심 있는 도서 담기 기능
• 좋아요로 도서에 대한 선호도 표현
• 마이페이지에서 담은 도서, 좋아요한 도서 검색 가능

도서 추천

• 사용자 성향 및 정보에 기반한 개인 맞춤형 도서 추천
• 리뷰, 책장, 좋아요를 반영한 인기 도서 추천

---

3. 프로젝트 정보

---

🏡 개발 스택

Back-End

자세히 보기

항목	버전 및 상세 정보
Java	Liberica JDK 21.0.5+11 2024-10-15 LTS (BellSoft)
Spring Boot	3.3.5
MySQL	8.0.32
MongoDB	8.0.3
Redis	7.4.1
ElasticSearch	8.15.3
Logstash	8.15.3
Kibana	8.15.3
JPA (Hibernate)	6.5.3.Final
QueryDSL	5.0.0
Swagger	2.2.0
Python	3.12
FastAPI	0.115.4
Django	5.1.2
YOLO	DocLayout-YOLO
IntelliJ IDEA	IDE IntelliJ IDEA 2024.1.4

Front-End

자세히 보기

항목	버전 및 상세 정보
React-Native React	18.3.1
Node.js	>=18
TypeScript	5.0.4
Android Build Tools	35.0.0
Min SDK	24
Compile SDK	35
Target SDK	34
NDK	26.1.10909125
Visual Studio Code	1.92.2

Infra, CI/CD

자세히 보기

항목	버전 및 상세 정보
AWS EC2	Ubuntu 20.04.6 LTS (GNU/Linux 5.15.0-1063-aws x86_64)
Docker	27.2.0
Jenkins	2.475
Nginx	1.27.2

협업 툴

자세히 보기

항목	사용 도구
이슈 관리	JIRA
형상 관리	GitLab
커뮤니케이션	Notion, Mattermost
디자인	Figma
UCC 제작	모바비, 타임캐스트
CI/CD	Jenkins
일정 관리	구글 스프레드시트 (간트차트)

---

🧩 아키텍처

---

🎨 API 명세서

회원 관리

출판도서 관리

도서 등록

리뷰 관리

독서노트

---

📚 ERD 설계

MySQL

MongoDB

---

📝 컨벤션

🔔 MR 알림 채널 구축

GitLab의 Merge Request(MR) 이벤트 발생 시, 해당 정보를 Mattermost 채널에 자동으로 전달하는 Jenkins 기반의 자동화 스크립트 구축

동작 흐름

1. Merge Request 작성: GitLab에서 새로운 MR이 생성됩니다.
2. Webhook 트리거: MR 이벤트를 GitLab Webhook이 감지하고 Jenkins로 데이터를 전달합니다.
3. 파이프라인 실행: Jenkins 스크립트가 실행되어 MR 데이터를 기반으로 메시지를 생성합니다.
4. Mattermost 알림 전송: MR 상태(opened, merged) 및 라벨 정보를 반영한 알림 메시지가 Mattermost에 전달됩니다.

주요 기능

• MR 상태에 따라 알림 메시지 구성 (opened, merged 등).
• MR 라벨에 따라 알림 색상을 다르게 설정.
• GitLab, Jenkins, Mattermost 간 자동화된 연동.

---

🥰 팀원 소개

---

📽️ UCC

전체 UCC : https://youtu.be/8yqzWUyeM1c

talkback 영상 : https://youtu.be/oGoeeEfu8DU

---