[TIL] 팀 프로젝트(Zelo) - SA문서 작업 완료

한 줄 요약
어렵고, 막막한데 재미있다!

 

프로젝트: 제로클릭 커머스
날짜: 2026-10-15
오늘의 활동: 회의 / 문서 작업 / 구현 / 리뷰
내 역할: AI 채팅·리뷰 추천

---

1. 오늘 한 일

• API 명세서 작성완료
• 서비스 플로우차트 작성완료
• 개발 협업 플로우 맞추기(진행)

---

2. 논의한 내용과 결정 사항

안건 1. <지라 도입 여부>

• 논의: 지라가 현업에서 많이 쓰인다고 해서 사용을 하기로 했었으나, 그것이 정말 효율적인가
• 결정: 안 쓰기로 결정
• 이유: 백엔드 코드에 관한 부분만 쓴다면 깃허브로만 쓰는 것이 훨씬 더 편안하고 효율적이다.
  지라를 쓸 것이라면 기획, 프론트부터 융합이 잘 되게 사용해야하는데 전반적인 의견은 백엔드에만 집중하자는 쪽이었기 때문이다.
  그리고 지라를 사용하면 외부에 공개가 안 되기 때문에 취업시에 약간의 아쉬움이 있을 수 있다.

안건 2. <API 명세서에 Tool Definition도 함께 작성할 것인가>

• 논의: MVP 기능 개발에서는 API보다는 AI가 보고 작동할 Tool 명세가 더 많을 거 같은데 이걸 따로 문서로 어떻게 정리할 것인가
• 결정: 미정
• 이유: 일반 API와 Tool의 비율을 보고 어떤 식으로 문서화해서 정리할 것인지 추후에 정하기로 했다.

---

3. 내가 기여한 부분

• 깃허브와 동일한 범위까지만 지라를 사용할 것이라면 사용하지 않는 것이 오히려 효율적임을 의견 제시
• 노션과 깃허브 이슈에서 두 번 작업을 할 것이 아니라 깃허브의 이슈 + 칸반 보드를 메인으로 진헹해볼 것을 제시
• 담당한 도메인에 대한 SA 문서 작업

---

4. 배운 점

기술적으로

• AI를 메인으로 하는 프로젝트이다 보니 AI 활용 테스트를 메인 레포지토리가 아니라 테스트용으로 하나 만들어서 작업하는 것이 훨씬 편한 방식이 될 수 있다는 것
• '공통 락 클래스'를 만들어서 중복 코드를 줄일 수 있다는 것

협업하면서

•  

---

5. 막혔던 점과 해결

• 문제: 깃허브의 Projects를 생성했는데 권한이 private으로만 되고, public으로는 변경이 안됌.
• 원인: 사이드 바에 있는 속성?들
• 해결: 오류 메세지를 자세히 보니 어떤 것을 삭제해야 하는지 명시가 되어있어서 그거대로 따라 하니 해결되었다.

---

6. 느낀 점

채팅 기능 개발과 LLM을 활용한 개발 모두 처음인데, 이번 프로젝트에서 두 가지를 담당하게 되어 개발을 앞두고 마음이 조급해졌다. 채팅 기능은 꼭 한번 구현해보고 싶었지만, 다른 기능까지 함께 맡게 될 줄은 몰라 기대와 부담이 동시에 느껴진다. ㅠㅠ

그래도 ‘헤맨 만큼 내 땅이 된다’는 말처럼, 공부하고 시행착오를 겪는 과정이 결국 내 역량으로 남을 것이라 생각한다.

조급한 마음에 휩쓸리기보다 하나씩 배우고 구현하면서, 이번 프로젝트를 개발자로서 한 단계 성장하는 기회로 만들고 싶다.

---

7. 다음에 할 일

• 협업 워크 플로우 맞춰보기
• LLM 테스트용 미니 프로젝트 생성 후 개발 시작하기