1인 개발자로서 Claude code를 사용하여 2개월 만에 에이전트형 AI 기능이 탑재된 상업용 유지보수 기업용 멀티 테넌트 B2B

안녕하세요 여러분, 저는 4월 16일에 이 프로젝트를 시작했습니다. 간단한 배경을 말씀드리자면, 저는 경영학을 전공했으며 소프트웨어 엔지니어링에 대한 정식 배경은 없습니다. 이 아이디어는 제가 상업용 유지보수 기업의 배차(dispatch) 업무를 담당하면서, 현재 우리가 사용하는 소프트웨어와 도구들이 비효율적이라고 느꼈고, 업무량이 많은 날 여러 개의 WhatsApp 채팅에서 작업 지시서(work order) 상태를 추적하는 것이 어렵다는 점 때문에 떠올리게 되었습니다. 저는 기본적으로 배차 담당자나 유지보수 기업을 위해 단순 반복 업무(grunt work)를 최대한 자동화할 수 있다면, 그런 소프트웨어는 어떤 모습이고 어떤 느낌일지 스스로에게 물었습니다. 그런 생각의 흐름 속에서 저는 여가 시간을 활용해 이 여정을 시작했고, 2개월 후 첫 번째 웹사이트를 만들었습니다. 방금 출시했습니다. 이것은 Claude code를 사용하여 제작되었으며, 아주 짧은 시간 동안 정말 많은 것을 배웠습니다. 이 프로젝트는 3개의 포털을 가진 현장 서비스 관리(field service management) 웹사이트입니다. 하나는 상업용 유지보수 기업용, 하나는 기술자(technician)용, 그리고 하나는 고객용입니다. 테넌트 격리(Tenant isolation)는 Postgres의 행 수준 보안(row level security)을 통해 데이터베이스 계층에서 강제됩니다. 제 웹사이트는 TradelyHQ.com입니다.

작동 방식의 핵심은 다음과 같습니다:

상업용 유지보수 기업의 고객들은 웹사이트에 초대되어 자신의 포털에서 직접 작업 지시서(work order)를 요청합니다.
고객이 작업 지시서를 생성하면 귀하의 (관리자) 포털에 나타나며, 귀하는 명단에 있는 원하는 기술자에게 이를 할당할 수 있습니다. (기술자를 설정하려면, 이메일을 통해 귀하의 조직(org)에 초대하고 급여율과 사용 언어를 설정하면 됩니다.)
기술자들은 자신의 휴대폰으로 직접 작업 지시서를 받고, 완료 보고서를 제출하거나, 작업이 NTE(not-to-exceed limit, 비용 초과 한도)를 초과할 것 같다고 표시하여 관리자인 귀하에게 견적서(quote) 작성을 알릴 수 있습니다.
견적서는 다시 고객에게 전달됩니다. 견적서가 생성되어 전송되면, 고객은 자신의 포털에서 이를 확인하고 서명한 뒤 수락을 클릭합니다.
기술자가 작업 지시서 완료 보고서를 제출하면, 배차 담당자/관리자인 귀하가 이를 검토하고 완료를 승인하면 모든 과정이 끝납니다.

또한 iOS 앱도 제작했으며, 바로 어제 Apple에 제출했기에 향후 며칠 내로 승인되기를 기대하고 있습니다. 이는 Capacitor 앱입니다. 동일한 REACT 웹사이트 코드베이스를 네이티브 iOS 셸(shell)로 감싼 형태입니다.

이 웹사이트의 더 멋진 점은 Claude API를 광범위하게 사용했다는 것입니다. 영어를 사용하지 못하는 기술자들을 위해 작업 지시서 제목, 작업 설명, 앱 내 배차 팀의 코멘트, 그리고 기술자가 배차 담당자에게 제출하는 완료 보고서를 자동으로 번역하도록 Claude를 통합했습니다. 스페인어와 포르투갈어에 대한 i18n(국제화) 지원을 갖추고 있습니다. 또한 웹사이트를 위한 MCP 서버와 API를 구축했기 때문에, 귀하의 Claude 또는 ChatGPT 계정을 연결하여 휴대폰의 Claude 앱에서 음성만으로 작업 지시서, 견적서, 송장을 직접 생성할 수 있는 에이전트(agent)를 만들 수 있습니다. 이제 업무를 위해 포털에 로그인하거나 심지어 컴퓨터 앞에 앉아 있을 필요도 없습니다.

이를 가능하게 하기 위해, 저는 작업 지시서 생성, 고객 또는 기술자에게 코멘트 전송, 견적서 생성 등 웹사이트의 모든 실행 가능한 인터페이스를 AI 에이전트가 데이터를 읽고 쓸 수 있도록 "동사(verbs)"로 매핑해야 했습니다. 동사는 기본적으로 에이전트가 MCP 서버와 API를 통해 귀하의 웹사이트와 상호 작용할 때 사용할 수 있는 "손"과 같습니다.

이 프로젝트를 시작한 지 약 한 달 정도 되었을 때, 제가 이 결과물을 보여준 한 시니어 엔지니어와 연결되었습니다. 그는 이를 살펴보고, 이 분야의 초보자라는 점을 고려할 때 꽤 잘 만들어졌다고 생각했습니다. 그 이후로 그는 저를 멘토링하며 소프트웨어 엔지니어링에 올바르게 접근하는 방법을 알려주고 있습니다. 그는 nWave라는 하네스(harness)에 대해 알려주었고, 제가 그것을 사용하기 시작하자마자 제 코드와 기능의 품질 및 깊이가 급격히 향상되었습니다. 제가 배운 가장 중요한 교훈은 Claude에게 끊임없이 질문을 던지는 것, 그리고 사용 중인 어떤 코딩 LLM이든 새로운 기능이나 코드 변경 사항에 대해 보안 결함, 버그 또는 비즈니스 로직의 공백을 확인하기 위해 적대적 검토(adversarial reviews)를 수행하도록 하는 것입니다.

저는 직관적으로 보안에 대한 편집증을 가지고 있었다고 말하고 싶습니다. 그래서 처음에는 그것이 정확히 무엇을 의미하는지 잘 이해하지 못했더라도 첫날부터 보안을 신경 썼습니다. 또한, 항상 직접 스모크 테스트 (smoke test)를 수행하세요. 왜냐하면 현재로서는 AI가 모든 것을 잡아내지는 못하기 때문입니다.

이 분야에 처음 입문한 사람으로서, 제가 구축한 결과물이 매우 자랑스럽습니다. 여가 시간에 이것을 만드는 단계에서 벗어나, 이제는 이 서비스를 마케팅하고 판매할 수 있게 되어 더욱 설렙니다. 제가 이곳에 글을 올리는 이유는 다른 사람들에게 무엇이 가능한지를 보여주고 싶기 때문이며, 어떤 형태든 피드백을 기다리고 있습니다. 긍정적이든 부정적이든 무엇이든 좋습니다. 사람들이 이것에 대해 어떻게 생각하는지, 마케팅 페이지가 괜찮아 보이는지, 서비스에 대해 어떻게 생각하는지 알고 싶을 뿐입니다. 만약 당신이 미국에서 상업용 유지보수 기업의 배차 (dispatch) 업무를 담당하고 있고 이것을 사용해보고 싶다면, 꼭 알려주세요! 현장의 다른 사용자가 어떻게 생각할지 알고 싶습니다. 30일 무료 체험이 가능하며, 신용카드 정보는 필요하지 않습니다. 만약 누군가 B2B SaaS를 마케팅하거나 판매하는 것에 대한 팁이 있다면 정말 감사하겠습니다!

제 통합 기능 (integrations)은 다음과 같습니다:

• 인보이스 (invoicing)를 위한 양방향 동기화 기능이 포함된 QBO.
• 웹사이트 내의 이벤트에 의해 트리거될 때, 해당 브레인이 규칙에 따라 작동하도록 설정할 수 있는 Claude API 배차 브레인 (dispatch brain).
• Zapier 또는 커스텀 통합을 위한 공개 REST API + OpenAPI 사양 (spec).

제출자: /u/Dry-Operation6112
[link] [comments]