🐰 [Flowbit] #1. 개발 환경 세팅부터 첫 API까지 (Spring Boot + Docker)

☘️ 1. 왜 flowbit을 만들었나

기존 작업 관리 시스템을 사용하면서 한 가지 아쉬움이 있었다.

현재 상태는 보이는데,
그 상태가 어떻게 만들어졌는지는 잘 보이지 않는다.

→ 이게 생각보다 큰 문제였다.

예를 들어:

• 이 작업이 언제 시작됐는지
• 누가 상태를 변경했는지
• 왜 중간에 멈췄는지

이런 정보는 로그를 따로 뒤지거나, 아예 남아있지 않은 경우도 많았다.

그러다 보니 자연스럽게 이런 의문이 들었다.

현재 상태만으로는 작업의 흐름을 설명하기 어렵지 않을까?

그래서 구조를 이렇게 바꿔보기로 했다.

Task → 현재 상태 (조회용)
TaskEvent → 상태 변화 이력 (기록용)

즉,
상태 중심이 아니라 이벤트 중심으로 흐름을 남기는 구조

이 프로젝트는
상태를 저장하는 게 아니라, 상태를 만들어낸 과정을 기록하는 시스템을 목표로 한다.

결국,

현재 상태를 보는 것이 아니라
상태가 만들어진 흐름을 다루는 시스템이 필요하다고 느꼈다

---

☘️ 2. 오늘 한 것

오늘은 단순 세팅이 아니라
실제로 동작하는 최소 단위(MVP)을 만드는 것을 목표로 했다.

• Spring Boot 프로젝트 생성
• Docker 기반 PostgreSQL / Redis 구성
• GitHub 레포 생성 및 히스토리 관리
• Task 도메인 설계
• Task 생성 API (POST /tasks)
• Task 조회 API (GET /tasks, GET /tasks/{id})
• test.http 기반 API 테스트 환경 구성

단순히 만들었다기보다
데이터를 생성하고 조회하는 흐름이 실제로 동작하는 상태까지 만든 것에 의미가 있다.

결국 오늘은

이후 이벤트 기반 구조로 확장할 수 있는 기반을 만든 단계였다

---

☘️ 3. 개발 환경 세팅

Spring Boot + Docker로 개발 환경을 구성했다.

로컬에 DB를 직접 설치하지 않고
Docker로 PostgreSQL과 Redis를 올렸다.

PostgreSQL → 데이터 저장
Redis → 이후 캐싱/확장 고려

docker-compose로 전체 환경을 관리

💡 선택 이유

환경을 쉽게 재현할 수 있고
로컬 환경을 깔끔하게 유지할 수 있고
설정 자체를 코드로 관리할 수 있다

개발 환경도 결국 프로젝트의 일부라고 생각했다.

현재 컨테이너 실행 상태 (PostgreSQL, Redis)

이후 확장과 성능 개선까지 고려한 기반을 미리 잡아둔 셈이다

---

☘️ 4. 도메인 설계 (Task)

가장 먼저 Task 엔티티를 설계했다.

@Entity
public class Task {
    private Long id;
    private String title;
    private String description;
    private TaskStatus status;
    private LocalDateTime createdAt;
}

이 구조는 단순 CRUD용이 아니다.

이후 TaskEvent 기반 구조로 확장하기 위한
현재 상태 스냅샷 역할이다.

---

☘️ 5. API 구현

🟢 CREATE

POST /tasks

🔵 READ

GET /tasks
GET /tasks/{id}

💡 구현 포인트

단순 CRUD 구현이 아니라
데이터 흐름이 제대로 이어지는지 확인하는 단계

생성 → 저장 → 조회
이 흐름이 끊기지 않는지 확인

→ 실제 DB에 데이터가 저장된 상태

→ 여러 Task의 현재 상태 스냅샷을 반환

→ 특정 Task의 현재 상태를 조회

---

☘️ 6. test.http로 API 테스트

Postman 대신 test.http를 사용했다.

POST http://localhost:8080/tasks
GET http://localhost:8080/tasks
GET http://localhost:8080/tasks/1

💡 선택 이유

코드와 함께 관리할 수 있고
실행 가능한 문서 역할을 하고
협업 시 공유하기 쉽다

단순 테스트 파일이 아니라
API 명세를 같이 관리하는 방식으로 사용했다.

---

☘️ 7. 삽질 포인트

오늘 겪은 이슈들:

• Spring Security 기본 설정으로 /login 페이지 노출
• Docker 실행 안 해서 DB 연결 실패
• Git 히스토리 수정하면서 force push 경험
• Controller 매핑 오류 (404)

대부분
코드 문제라기보다 환경/설정 문제였다

---

☘️ 8. 오늘 배운 핵심

• Entity와 API 응답은 분리해야 한다
• JPA는 편하지만 구조 이해가 더 중요하다
• test.http는 테스트 + 문서 역할을 동시에 한다

결국,

단순 기능 구현보다
구조를 어떻게 가져갈지 고민하는 게 더 중요하다는 걸 느꼈다

---

☘️ 9. 현재 상태

CREATE ✔️
READ ✔️

기본 흐름은 완성

---

☘️ 10. 다음 목표

Response DTO 적용
API 구조 개선
TaskEvent 도메인 설계

상태 중심 구조에서
이벤트 기반 구조로 넘어간다