사회적추모 데이터 저장 관리

사회적추모 (online-memorial.codefor.kr) 서비스 백엔드입니다.

사회적 추모 게시글을 관리하고 산업재해 통계를 제공하는 Rails 기반 API 서버입니다.

기술 스택

• Ruby: 3.2.2
• Rails: 7.0.3
• 데이터베이스: PostgreSQL
• 서버: Puma (~> 5.0)
• API 문서: Swagger (Rswag)
• 관리자 페이지: Administrate

설치 및 실행

1. 저장소 클론

git clone <repository-url>
cd candlelight

2. 의존성 설치

bundle install

3. 데이터베이스 설정

rails db:create
rails db:migrate

4. 환경 변수 설정 프로덕션 환경에서는 다음 환경 변수가 필요합니다:

• RDS_DB_NAME
• RDS_USERNAME
• RDS_PASSWORD
• RDS_HOSTNAME
• RDS_PORT

개발/테스트 환경에서는 database.yml의 기본 설정을 사용하거나, 필요에 따라 환경 변수를 수정하세요.

5. 서버 실행

rails server

서버 실행하면 http://localhost:3000 으로 접속합니다.

API 문서

Swagger API

• 로컬: http://localhost:3000/api-docs
• 프로덕션: https://candle-c4k.herokuapp.com/api-docs (서버 이전 설치 진행중)

주요 API

메서드	경로	설명
GET	/health	서버 상태 확인
GET	/stats/year/:year	연도별 통계 조회
GET	/posts	게시글 목록 (페이지네이션 지원)
GET	/posts/:id	게시글 상세 조회
POST	/posts	게시글 작성
GET	/disasters	재난 정보 목록 (페이지네이션 지원)
GET	/disasters/:id	재난 정보 상세 조회
GET	/stories	이야기 목록
GET	/stories/:id	이야기 상세 조회

관리자 페이지

/admin 경로에서 관리자 대시보드에 접속할 수 있습니다.

• /admin/stories - 이야기 관리
• /admin/posts - 게시글 관리
• /admin/stats - 통계 관리
• /admin/disasters - 재난 정보 관리