ADR

Portfolio Home을 만들며 실제로 내린 기술·제품 의사결정 기록입니다.

보안승인2026. 05. 08.
관리자 인증: DB users + RS256 JWT
관리자 인증은 DB users, bcrypt, RS256 JWT, CLI seed 방식으로 시작한다.
결정: DB 사용자 테이블과 RS256 JWT를 사용하고, 관리자 계정은 CLI로만 생성한다.
아키텍처승인2026. 05. 07.
포지셔닝: "AI 운용 백엔드 엔지니어"로 시장 진입
순수 백엔드/순수 ML 대신 "AI 적용 백엔드" 포지셔닝을 선택한다.
결정: "AI 운용 백엔드 엔지니어"로 포트폴리오 포지셔닝을 잡는다.
인프라승인2026. 05. 07.
자가 운영 서버로 MVP 시작, 조건부 클라우드 이전
이미 구축된 자가 서버를 MVP에 우선 사용하고, 명확한 이전 트리거를 둔다.
결정: MVP 구간에는 자가 운영 서버를 사용하고, 장애/트래픽/면접 일정 등 조건이 충족되면 클라우드 이전을 재검토한다.
기술 스택승인2026. 05. 07.
문서화 도구 조합으로 용도별 구분
노션, Mermaid, OpenAPI, Figma를 용도별로 나눠 사용한다.
결정: 텍스트/구조 문서는 Notion, 다이어그램은 Mermaid/Excalidraw, API 명세는 OpenAPI, 화면 설계는 Figma로 관리한다.
UX승인2026. 05. 07.
프로젝트 상세 하단에 관련 ADR 목록 노출
프로젝트 상세 페이지 v1에서는 본문 중간 삽입보다 하단 관련 ADR 목록으로 의사결정 기록을 연결한다.
결정: 프로젝트 상세 페이지 하단에 관련 ADR 목록을 노출한다.
기술 스택승인2026. 05. 07.
Postgres + Redis 기반으로 v1 API 시작
v1 프로젝트 공개 API는 SQLAlchemy async + Alembic + Postgres를 기준으로 시작하고 Redis를 캐시에 사용한다.
결정: v1 API 골격은 Postgres + Redis 기반으로 시작한다.
아키텍처승인2026. 05. 07.
MVP 범위 축소: 1차 공개 골격 우선
RAG/피드백을 1차 공개에서 제외하고, 프로젝트 공개 화면과 관리자 최소 기능을 먼저 배포한다.
결정: 1차 공개 MVP를 채용 담당자가 1분 안에 직무 적합성을 판단하는 공개 골격으로 축소한다.