Initial commit: AI Video Assistant fullstack platform.

Add pipecat-based backend with WebRTC/WS voice routes, Next.js frontend, and Docker Compose orchestration.

Co-authored-by: Cursor <cursoragent@cursor.com>

docker-compose.yaml

@@ -0,0 +1,127 @@
+# AI Video Assistant 平台 —— docker compose
+#
+# 核心服务(默认起):postgres + api + ui
+#   docker compose up -d postgres api      # 后端 + 库
+#   docker compose up -d                   # 再带上前端 ui
+#
+# 可选服务(用 profile 推迟到需要时):
+#   docker compose --profile data up -d    # + redis / rustfs(后台任务、S3 录音存储)
+#   docker compose --profile remote up -d  # + coturn(WebRTC 公网 TURN 穿透)
+
+services:
+  # ---- 数据库(api 强依赖,默认起) ----
+  postgres:
+    image: pgvector/pgvector:pg17
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: "${POSTGRES_PASSWORD:-postgres}"
+      POSTGRES_DB: postgres
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres"]
+      interval: 3s
+      timeout: 3s
+      retries: 10
+    networks: [app-network]
+
+  # ---- 后端引擎(pipecat:WebRTC + WS 双输出) ----
+  api:
+    build: ./backend
+    # 调试:挂源码 + --reload,改代码即时生效,无需重建镜像
+    command: uvicorn app:app --host 0.0.0.0 --port 8000 --reload
+    volumes:
+      - ./backend:/app
+      - /app/.venv          # 屏蔽宿主机的 venv(容器用镜像内的依赖)
+      - /app/__pycache__
+    env_file:
+      - path: ./backend/.env
+        required: false
+    environment:
+      # 容器内连库:用服务名 postgres,覆盖 .env 里的 localhost
+      DATABASE_URL: "postgresql+asyncpg://postgres:${POSTGRES_PASSWORD:-postgres}@postgres:5432/postgres"
+      CORS_ORIGINS: "http://localhost:3000"
+    ports:
+      - "8000:8000"
+    depends_on:
+      postgres:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python -c \"import urllib.request;urllib.request.urlopen('http://localhost:8000/health')\""]
+      interval: 15s
+      timeout: 5s
+      retries: 5
+      start_period: 40s
+    networks: [app-network]
+
+  # ---- 前端(dev 模式,挂源码带 HMR;发布时再做生产构建) ----
+  ui:
+    image: node:22-slim
+    working_dir: /app
+    command: sh -c "npm install && npm run dev"
+    environment:
+      NEXT_PUBLIC_API_BASE_URL: "http://localhost:8000"
+    volumes:
+      - ./frontend:/app
+      - /app/node_modules
+    ports:
+      - "3000:3000"
+    depends_on:
+      - api
+    networks: [app-network]
+
+  # ---- 可选(profile: data):后台任务 / 录音存储 ----
+  redis:
+    image: redis:7
+    profiles: ["data"]
+    command: ["--requirepass", "redissecret"]
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    networks: [app-network]
+
+  # RustFS:S3 兼容对象存储(MinIO 替代,Rust 实现)
+  # 9000 = S3 API,9001 = Web 控制台。默认账号 rustfsadmin/rustfsadmin。
+  rustfs:
+    image: rustfs/rustfs:latest
+    profiles: ["data"]
+    environment:
+      RUSTFS_VOLUMES: /data                       # 单盘单节点(开发够用)
+      RUSTFS_ADDRESS: 0.0.0.0:9000                # S3 API
+      RUSTFS_CONSOLE_ADDRESS: 0.0.0.0:9001        # 控制台
+      RUSTFS_CONSOLE_ENABLE: "true"
+      RUSTFS_CONSOLE_CORS_ALLOWED_ORIGINS: "*"
+      # 凭证:首次初始化后写入数据卷。改 ak/sk 需先清空 rustfs-data 卷再重起。
+      RUSTFS_ACCESS_KEY: "${S3_ACCESS_KEY:-rustfsadmin}"
+      RUSTFS_SECRET_KEY: "${S3_SECRET_KEY:-rustfsadmin}"
+    ports:
+      - "127.0.0.1:9000:9000"
+      - "127.0.0.1:9001:9001"
+    volumes:
+      - rustfs-data:/data
+    networks: [app-network]
+
+  # ---- 可选(profile: remote):WebRTC 公网穿透 ----
+  coturn:
+    image: coturn/coturn:4.8.0
+    profiles: ["remote"]
+    network_mode: host  # TURN 需直接占用 UDP 端口段
+    command:
+      - -n
+      - --realm=ai-video
+      - --use-auth-secret
+      - --static-auth-secret=${TURN_SECRET:-changeme}
+      - --min-port=49152
+      - --max-port=49200
+
+volumes:
+  postgres_data:
+  redis_data:
+  rustfs-data:
+
+networks:
+  app-network:
+    driver: bridge