refactor(config): split SPICEDB_ENDPOINT into SPICEDB_HOST + SPICEDB_PORT

Eliminates duplication between endpoint string and port mapping in compose.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: ImTotem

.env.example

@@ -40,7 +40,7 @@ MONGO_VOLUME_PATH=/home/ubuntu/bcsd-data/mongo
 
 # === Infrastructure ===
 # SpiceDB (권한 관리)
-SPICEDB_ENDPOINT=spicedb:50051
+SPICEDB_HOST=spicedb
 SPICEDB_PORT=50051
 SPICEDB_TOKEN=bcsd-dev-token
 DOMAIN=api.bcsdlab.com

docs/deploy-guide.md

@@ -126,7 +126,8 @@ bash infra/scripts/deploy.sh
 | `MONGO_PASSWORD` | MongoDB 비밀번호 | 랜덤 문자열 |
 | `MONGO_PORT` | MongoDB 호스트 포트 | `27017` |
 | `MONGO_VOLUME_PATH` | MongoDB 데이터 경로 | `/home/ubuntu/bcsd-data/mongo` |
-| `SPICEDB_ENDPOINT` | SpiceDB gRPC 주소 | `spicedb:50051` |
+| `SPICEDB_HOST` | SpiceDB 호스트 | `spicedb` |
+| `SPICEDB_PORT` | SpiceDB gRPC 포트 | `50051` |
 | `SPICEDB_TOKEN` | SpiceDB 인증 토큰 | 랜덤 문자열 |
 | `DOMAIN` | API 도메인 | `api.bcsdlab.com` |
 | `N8N_DOMAIN` | n8n 도메인 (선택) | `n8n.bcsdlab.com` |

src/bcsd_api/config.py

@@ -13,7 +13,8 @@ class Settings(BaseSettings):
     cors_origins: str = "http://localhost:3000"
     cookie_name: str = "access_token"
     cookie_secure: bool = True
-    spicedb_endpoint: str = "spicedb:50051"
+    spicedb_host: str = "spicedb"
+    spicedb_port: int = 50051
     spicedb_token: str = ""
     slack_bot_token: str = ""
     slack_error_channel: str = ""

src/bcsd_api/dependencies.py

@@ -41,7 +41,8 @@ def _create_authz(endpoint: str, token: str) -> AuthzClient:
 
 
 def get_authz(settings: Settings = Depends(get_settings)) -> AuthzClient:
-    return _create_authz(settings.spicedb_endpoint, settings.spicedb_token)
+    endpoint = f"{settings.spicedb_host}:{settings.spicedb_port}"
+    return _create_authz(endpoint, settings.spicedb_token)
 
 
 def get_member_repo(sheets: SheetsClient = Depends(get_sheets)) -> MemberRepository: