Files

lethdat a0ae2b681a feat: Implement video workflow repository and related services

- Added videoWorkflowRepository with methods to manage video and user interactions.
- Introduced catalog_mapper for converting database models to protobuf representations.
- Created domain_helpers for normalizing domain and ad format values.
- Defined service interfaces for payment, account, notification, domain, ad template, player config, video, and user management.
- Implemented OAuth helpers for generating state and caching keys.
- Developed payment_proto_helpers for mapping payment-related models to protobuf.
- Added service policy helpers to enforce plan requirements and user permissions.
- Created user_mapper for converting user payloads to protobuf format.
- Implemented value_helpers for handling various value conversions and nil checks.
- Developed video_helpers for normalizing video statuses and managing storage types.
- Created video_mapper for mapping video models to protobuf format.
- Implemented render workflow for managing video creation and job processing.

2026-03-26 18:38:47 +07:00

2.9 KiB

Raw Blame History

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Quick Commands

# Run server
go run ./cmd/server

# Build server
go build ./cmd/server

# Run all tests
go test ./...

# Run service/middleware tests only
go test ./internal/service/... ./internal/middleware/...

# Regenerate GORM models and queries (after DB schema changes)
go run ./cmd/gendb

# Lint protobufs
buf lint

# Generate protobuf code (Go + TypeScript)
buf generate

# Run DB migrations
./run_migration.sh

Architecture Overview

Module: stream.api (Go 1.25.6)

This is a gRPC-first backend for a video streaming platform with agent/render orchestration.

Layer Structure

cmd/              → Entrypoints (server, gendb, worker stub)
internal/
  transport/grpc  → gRPC server, agent runtime, streaming, auth
  service         → Business logic, composed via appServices struct
  repository      → Database access layer (transactions, GORM abstraction)
  database/
    model/        → Generated GORM models (*.gen.go)
    query/        → Generated GORM query builders (*.gen.go)
  adapters/redis  → Redis queue, pub/sub for jobs/agents
  middleware      → gRPC metadata-based internal auth
  dto             → Data transfer objects
  api/proto       → Generated protobuf Go code
proto/            → Source .proto files (app/v1, agent/v1)
pkg/              → Shared utilities (database, logger, storage, auth)

Key Patterns

Service composition: internal/service/service_core.go defines appServices struct holding all dependencies; typed services (authAppService, paymentsAppService, etc.) embed it
Repository abstraction: Services depend on repository interfaces, not raw GORM
Generated DB layer: cmd/gendb/main.go reads schema and generates models/queries
Internal auth: gRPC metadata (x-stream-internal-auth, x-stream-actor-*) for service-to-service auth
Transaction boundaries: Repositories handle transactions for multi-entity operations (payments, account deletion, subscription updates)
Job/render subsystem: Jobs in DB + Redis sorted set queue + pub/sub for logs/cancels/updates + MQTT for agent events

Test Patterns

In-memory SQLite for service tests (internal/service/__test__/testdb_setup_test.go)
bufconn for gRPC test servers
Tests isolated and fast, no external Postgres required

Important Caveats

Stale paths in docs/scripts: MIGRATION_GUIDE.md and some scripts reference cmd/api or cmd/grpc — the actual entrypoint is cmd/server
Dockerfile: References ./cmd/grpc which doesn't exist; likely needs updating to ./cmd/server
Proto path mismatch: proto/app/v1/admin.proto declares go_package as internal/gen/proto/... but generated code lands in internal/api/proto/...

Notification Settings

Email: disabled
Notifications: disabled

2.9 KiB Raw Blame History