채팅 위젯으로 Laravel 멀티 테넌트 SaaS 관리하기 (v1.3.1)

**멀티 테넌트 Laravel SaaS (multi-tenant Laravel SaaS)**를 운영하고 있다면, 이미 다음과 같은 과정을 잘 알고 계실 것입니다:

• Filament 열기 → 워크스페이스 찾기
• 다른 탭에서 결제 정보 확인하기
• API 문서나 양식을 통해 누군가를 초대하기

작동은 하지만, 이것이 여러분이 자신의 제품을 느끼고 싶은 방식은 아닐 것입니다.

**Laravel Tenant Kit v1.3.1**은 **앱 내 가이드 에이전트 (in-app guided agent)**를 추가합니다. 이는 중앙 도메인에 떠 있는 채팅창으로, 워크스페이스, 사용량, 구독, 팀 초대 등을 단계별로 안내하며, 위험한 작업에 대해서는 확인/취소 절차를 제공합니다.

이 기능의 핵심 브레인은 PyPI에 있는 별도의 Python 패키지인 **api-operator**입니다. Tenant Kit은 PHP 전용으로 유지되며, operator는 사이드카 (sidecar)로 실행됩니다.

가이드 에이전트가 하는 일

흐름 (Flow)	예시
워크스페이스 (Workspaces)	워크스페이스 목록 표시, 생성 (이름 → 서브도메인 → 확인)
...

토큰은 **서버 측 (server-side)**에 유지됩니다. 브라우저는 Laravel (/api-operator/chat)과 통신하고, Laravel은 api-operator와 통신합니다. 프론트엔드에는 Sanctum 토큰이 없습니다.

Docker를 이용한 빠른 시작 (Windows)

git clone https://github.com/mohammedelkarsh/laravel-tenant-kit.git
cd laravel-tenant-kit
.\scripts\docker-setup.ps1

http://laravel-tenant-kit.test:8080/login 을 여세요.

로그인: admin@laravel-tenant-kit.test / password

/dashboard로 이동 → 채팅 버튼(우측 하단)을 클릭하세요.

매일 재시작 시:

.\scripts\docker-up.ps1

또는 CLI 사용 (PyPI의 api-operator)

pip install api-operator==0.10.0
export TENANT_KIT_API_TOKEN="your-sanctum-token"

...

전체 가이드: docs/api-operator.md

최근 릴리스 사항

최근 릴리스 사항

• v1.3.0 — 사용량 기반 청구 미터(api_calls, team_seats)
• v1.2.1 — API 속도 제한(rate limiting), 토큰 권한(token abilities), 워크스페이스 일시 중지(workspace suspend), 팀 초대 API

사용 스택: Laravel 13 · PHP 8.4 · Filament 5 · Stancl Tenancy · Docker · 71 PHPUnit 테스트

링크

• Tenant Kit: https://github.com/mohammedelkarsh/laravel-tenant-kit
• Release v1.3.1: https://github.com/mohammedelkarsh/laravel-tenant-kit/releases/tag/v1.3.1
• api-operator (PyPI): https://pypi.org/project/api-operator/0.10.0/

이것이 시간을 절약해 준다면, GitHub에서 ⭐을 눌러 다른 사람들이 이 글을 찾도록 도와주세요.

이전 글: 10분 만에 멀티 테넌트 Laravel SaaS 구축하기 (v1.2 워크스루).