무빌드 아키텍처와 세 개의 문 — 공개·관리자·API

리뉴얼의 뼈대는 단순함이다. 화려한 스택 대신, 오래 버티는 구조를 골랐다.

무빌드 바닐라

서버는 PHP 8.4 + MySQL 한 쌍이면 끝이다. Composer도, npm도, 빌드 단계도 없다. 요청이 들어오면 프론트 컨트롤러가 받아 라우팅하고, 알맞은 템플릿이 DB 데이터를 HTML로 그린다. 의존성이 없으니 배포는 '파일 올리기'가 전부고, 깨질 일도 거의 없다.

세 개의 문

같은 콘텐츠라도 들어오는 문에 따라 권한이 다르다.

1. 공개 문 — 방문자는 읽기만. 발행된 글, 공개 프로젝트, 공개 캔버스를 본다.
2. 관리자 문 — 세션 로그인. 브라우저에서 직접 쓰고 고치고, 캔버스를 편집한다.
3. API 문 — Bearer 키 인증. AI가 이 문으로 들어와 콘텐츠를 관리한다. 키마다 권한(스코프)을 따로 줄 수 있다.

안전장치

엔진을 AI에게 열어주는 만큼, 가드레일을 분명히 했다.

• 소프트 삭제 — 글·프로젝트는 바로 지워지지 않고 휴지통으로 간다. 되돌릴 수 있다.
• 감사 로그(audit log) — 누가/무엇을/언제 바꿨는지 남는다.
• 레이트 리밋 — API 남용을 막는다.
• 입력 검증 — 슬러그, 상태값 등은 경계에서 걸러진다.

복잡함을 안으로 숨기는 대신, 구조를 단순하게 두고 규칙을 명확히 했다. 덕분에 그 위에 기능을 빠르게 얹을 수 있었다.