Overview
글을 쓰는 도구는 익숙하게, 읽는 경험은 편안하게. 개인 기술 블로그의 첫 단계는 별도의 관리 화면 없이 MDX와 Git으로 콘텐츠를 관리하는 프론트엔드입니다.
기록이 연결되는 과정
index.mdx
작은 기록이 쌓이면,
01---
02title: "오늘 이해한 것"
03status: "published"
04---
작은 기록이 쌓이면,
나만의 지식이 된다.
✳ THOUGHTS INTO WORDS
01 — WRITE
생각이 사라지기 전에, 한 편의 기록으로.
에디터에서 Markdown으로 글을 쓰고, 같은 폴더에 이미지를 담아요. 기록에만 집중할 수 있도록 작성 흐름은 단순하게.
02 — CONNECT
작은 커밋 하나가 새로운 이야기가 되도록.
글과 이미지의 변경 이력을 Git으로 함께 관리해요. 커밋에서 배포까지 자연스럽게 이어지는 블로그를 설계합니다.
03 — DISCOVER
쌓인 기록에서 다음 생각을 발견해요.
주제와 시리즈로 기록을 연결하고, 검색으로 다시 찾아요. 앞으로는 내 기록에 질문하고 답을 얻는 공간으로 확장합니다.
Architecture
MDX + local images
↓
Content reader → Server-rendered pages
↓
SearchService / ChatService
↓
HTTP adapters → Next.js proxy → Spring Boot
↓
PostgreSQL metadata index + daily views본문 렌더링과 상호작용을 분리하고, 검색과 대화 UI는 서비스 인터페이스를 통해 데이터를 받습니다. 검색과 조회수는 HTTP 어댑터를 통해 Spring Boot에 연결하며, 대화 화면은 데모 어댑터를 유지합니다. 응답과 이벤트 타입은 명세에 맞췄습니다.
선택과 이유
| 선택 | 이유 |
|---|---|
| 글 단위 디렉터리 | 원본과 이미지를 함께 관리 |
| MDX | 코드와 그림이 포함된 기술 기록 |
| 서버 렌더링 | 읽기 중심의 페이지 구성 |
| 서비스 인터페이스 | UI와 데이터 공급 방식 분리 |
현재 구현 범위
글 목록과 상세, 주제별 탐색, 정글 아카이브, 프로젝트 소개, 실제 검색과 조회수, 대화 목업을 제공합니다. Spring Boot와 PostgreSQL이 공개 글의 메타데이터와 일별 조회수를 관리합니다. 실제 AI 응답과 공개 배포 연결은 후속 단계입니다.