소개
안녕하세요, 저는 WcaleNieWolny - Capgo의 리드 소프트웨어 엔지니어입니다.
지난 8개월간 개발해 온 조직 시스템, 그리고 4월 14일부로 시스템 구축이 완료되었음을 기쁘게 알려드립니다 🎉 🎊
드디어 8개월 만에 Capgo의 모든 부분이 조직 멤버에게 공개되었습니다. 포함되는 항목은 다음과 같습니다:
- 앱
- 통계
- 결제
- 완전한 CLI 지원
- 그리고 더 많은 것들!
여기까지 오는 과정은 쉽지 않았습니다. 시스템은 3차례나 크게 수정되었습니다.
Organizations v1
시작은 험난했습니다… 프로젝트에 합류한 지 2주 후에 이 작업을 시작했습니다. 당시 저는 코드베이스에 대해 거의 알지 못했고, 이를 구현하는 큰 그림도 없었습니다.
결국 앱, 채널, 버전 접근만 지원하는 가장 해킹적인(hacky) 솔루션을 구현하게 되었습니다. 초대된 사용자가 통계에 접근하는 것조차 허용되지 않았습니다.
그 후 Martin의 리뷰를 기다렸습니다. 기다리고 또 기다렸지만, 아무 일도 일어나지 않았습니다. 3개월 후, 저는 이 작업에 다시 돌아와 모든 merge conflicts를 해결하기로 결정했습니다. 또한 테스트를 진행하기로 했는데, 이는 훌륭한 결정이었습니다. 예상대로, 그 해킹적인 솔루션은 완전히 실패했습니다. 그 순간 저는 모든 버그를 수정하고 방대한 E2E 테스트를 작성하기로 결심했습니다. 매우 깨진 code와 과거의 제가 내린 잘못된 결정들과 씨름해야 했지만, 힘든 2주 끝에 마침내 기능을 작동시켰습니다.
하지만 그것이 완벽했다는 뜻은 아닙니다. 조직 소유자는 초대된 최고 권한 사용자보다도 훨씬 더 많은 접근 권한을 가지고 있었습니다. 사용자 경험도 상당히 부족했습니다. 초대된 사용자는 애플리케이션 통계를 볼 수도, 결제를 관리할 수도 없었고, CLI는 업로드만 가능하도록 제한되어 있었습니다.
이러한 모든 어려움에도 불구하고 Martin이 PR을 리뷰했고, 일주일 후 프로덕션에 푸시됐습니다.
Organizations v2
모든 어려움에도 불구하고 조직 시스템은 상당히 잘 작동했습니다. 사용자들이 이를 사용하고 있었고, 프로젝트 전체를 정말 크게 앞당겼습니다. 하지만 여전히 해야 할 일이 있었습니다:
- 에서 발생한 문제를 수정 행 단위 보안
- CLI 전체 지원 추가
- 관리자 사용자가 소유자와 동일한 접근 권한을 갖도록 보장
로컬에서 많은 논의 Martin과 논의 끝에, 보안 규칙을 전면 재작성하고 모든 리소스 소유권을 사용자가 아닌 조직(organization) 단위로 이전하는 것이 최선이라는 결론을 내렸습니다. 이렇게 하면 새로운 조직 시스템과 더 쉽게 통합할 수 있고, 레거시 code도 상당 부분 제거할 수 있기 때문입니다.
새로운 RLS code를 작성하는 작업은 무척 지루했지만, 일주일 반 만에 마이그레이션 전체를 마칠 수 있었습니다.
하지만 이번에는 E2E 테스트를 작성하지 않기로 했고, 결국 수동으로 테스트해야 했습니다. Martin과 아주 긴 통화를 세 차례나 한 끝에, 우리는 프로덕션에 배포하고 잘 되길 바라는 수밖에 없었습니다 🙏
하지만 잘 되지 않았습니다... 알고 보니 제가 사용자 등록 기능을 망가뜨려서 신규 사용자가 계정을 만들 수 없는 상태였습니다 😅
급하게 패닉 통화를 한 뒤, 서둘러 수정 사항을 prod에 push하고 잠자리에 들었습니다. 불행히도 제 수정은 문제만 더 키웠습니다 😰
자고 일어나 보니 사용자들에게 빈 조직이 잔뜩 생겨 있었습니다. 사용자당 조직은 하나만 허용되어야 하니 절대 일어나서는 안 될 일이었습니다. 중복된 빈 조직을 모두 제거하려면 한참 머리를 맞대야 했지만, 그 외의 변경 사항은 대체로 순조롭게 진행되었습니다.
Organizations v3
이것만으로는 부족했습니다. 여전히 거대한 조각 하나가 빠져 있었으니까요. 바로 billing입니다.
지금까지는 오너만 결제(billing)를 관리할 수 있었습니다. 이로 인해 사용자가 조직용이라고 생각하며 플랜을 구매했지만 실제로는 개인 계정으로 처리되는 등 몇 가지 흥미로운 문제가 발생했습니다. 우리는 이 문제를 수동으로 빠르게 수정했고, 이때 이 문제가 더 이상 용인될 수 없다는 결론을 내렸습니다.
마이그레이션은 꽤 순조롭게 진행되었습니다. 일주일의 작업이 필요했지만, V1과 V2에 비하면 정말 어렵지 않았습니다 🚀
Organizations v4 - 미래
이 모든 힘든 작업을 마친 후, 지금은 다른 것에 집중할 때라고 생각합니다 😎
쉽지는 않았지만 많은 것을 배웠고, capgo에 매우 훌륭하고 중요한 기능이 추가되었습니다. 레거시 함수를 비활성화하고, 웹앱 사용자 경험을 개선하며, 버그를 모니터링해야 하지만 이 시스템에 큰 변화는 없을 것입니다.
읽어주셔서 감사합니다 🚀
A brand new organization system에서 계속하기
사용 중이라면 완전히 새로운 조직 시스템 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 구현 세부 사항은 API 키에서 기기 구현 세부 사항은 기기에서, 그리고 번들 Bundles의 구현 세부 사항은