← ADR 목록

Postgres + Redis 기반으로 v1 API 시작

v1 프로젝트 공개 API는 SQLAlchemy async + Alembic + Postgres를 기준으로 시작하고 Redis를 캐시에 사용한다.

기술 스택승인결정일 2026년 5월 7일

배경

프로젝트 콘텐츠 모델 v1이 확정되었고, 이후 RAG에서는 pgvector 확장이 필요하다.

결정

v1 API 골격은 Postgres + Redis 기반으로 시작한다.

근거

Postgres는 프로젝트/ADR 관계 모델과 이후 pgvector 확장에 적합하고, Redis는 조회수 중복 방지 TTL과 짧은 프로젝트 캐시에 적합하다.

결과

프로젝트 목록/상세 캐시와 조회수 중복 방지에 Redis를 사용한다.

상세 기록

맥락

프로젝트 콘텐츠 모델 v1이 확정되었고, 이후 RAG에서는 pgvector 확장이 필요하다. 또한 조회수 기능과 공개 프로젝트 목록/상세 캐시가 필요했다.

결정

v1 API 골격은 Postgres + Redis 기반으로 시작한다.

근거

Postgres는 프로젝트/ADR 관계 모델과 이후 pgvector 확장에 적합하다. Redis는 동일 방문자 조회수 중복 방지 TTL과 짧은 프로젝트 캐시에 적합하다.

결과

프로젝트 목록/상세 캐시와 조회수 중복 방지 키를 Redis에 둔다.