공공API 활용 포털 서비스: Saver

Python 환경 준비

uv venv --python 3.12
source .venv/bin/activate
uv pip install -r requirements.txt

검색 데이터베이스 실행

Docker Desktop을 실행한 다음 PostgreSQL을 시작합니다.

docker compose up -d --build
docker compose ps

로컬 접속 정보:

• 호스트: 127.0.0.1
• 포트: 15432
• 데이터베이스: saver_search
• 사용자: saver
• 비밀번호: saver_local_password

개발 기본값을 변경하려면 Git에 포함되지 않는 .env 파일에 다음 값을 지정합니다.

POSTGRES_DB=saver_search
POSTGRES_USER=saver
POSTGRES_PASSWORD=변경할_비밀번호
POSTGRES_PORT=15432

확장과 테이블을 확인합니다.

docker compose exec postgres psql -U saver -d saver_search -c "\dx"
docker compose exec postgres psql -U saver -d saver_search -c "\dt"

데이터베이스를 중지합니다.

docker compose down

docker compose down -v는 PostgreSQL 데이터를 삭제하므로 초기화할 때만 사용합니다.

SQLite 데이터 적재

원본 SQLite를 읽기 전용으로 검사하고 PostgreSQL 변경 내용을 미리 확인합니다.

python src/import_sqlite.py --dry-run

검사 결과에 문제가 없으면 실제로 동기화합니다.

python src/import_sqlite.py

프로그램은 (source_type, source_id)를 기준으로 새 문서를 추가하고, 해시가 변경된 문서를 갱신하며, 원본에서 사라진 문서를 삭제합니다. 같은 원본을 다시 실행하면 추가·수정·삭제가 모두 0건이어야 합니다.