Spaces:
Running
Running
File size: 9,573 Bytes
f689c7d | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 | # HƯỚNG DẪN CẤU HÌNH BIẾN MÔI TRƯỜNG & CHUẨN BỊ GIAI ĐOẠN 4 (LIVEKIT VIDEO MEETING)
**Dự án**: TaskPilot - Hệ thống Quản lý Dự án Thông minh tích hợp AI Agent
**Tài liệu tham chiếu**: Đề cương Đồ án 2 & Hướng dẫn Vận hành Hệ thống
**Ngày cập nhật**: 08/10/2026
---
## 1. GIẢI THÍCH SỰ CỐ REDIS NXDOMAIN VÀ CƠ CHẾ SỬA LỖI
### 1.1. Triệu chứng sự cố (Log trên Hugging Face Spaces)
```text
WARN 1 --- [taskpilot-app] [oundedElastic-1] b.d.r.h.DataRedisReactiveHealthIndicator : Redis health check failed
org.springframework.data.redis.RedisConnectionFailureException: Unable to connect to Redis
Caused by: io.lettuce.core.RedisConnectionException: Unable to connect to easy-vervet-91102.upstash.io/<unresolved>:6379
Caused by: io.netty.resolver.dns.DnsResolveContext$SearchDomainUnknownHostException: Failed to resolve 'easy-vervet-91102.upstash.io' [A(1)]
Caused by: io.netty.resolver.dns.DnsErrorCauseException: Query failed with NXDOMAIN
```
### 1.2. Nguyên nhân cốt lõi (Root Cause)
1. **Lỗi DNS NXDOMAIN (Non-Existent Domain)**: Tên miền `easy-vervet-91102.upstash.io` trên nhà cung cấp Upstash Redis đã bị xóa, hết hạn hoặc thay đổi định danh cơ sở dữ liệu. Do đó, hệ thống DNS toàn cầu phản hồi mã `NXDOMAIN` (tên miền không tồn tại).
2. **Cơ chế Health Check của Spring Boot Actuator**: Mặc dù dự án đã cấu hình `JWT_BLOCKLIST_PROVIDER=memory` (sử dụng ConcurrentHashMap trong RAM để lưu trữ token thu hồi, không phụ thuộc Redis), nhưng do dependency `spring-boot-starter-data-redis` có mặt trong classpath, Spring Boot Actuator tự động kích hoạt `DataRedisReactiveHealthIndicator` để kiểm tra kết nối Redis định kỳ. Khi kết nối thất bại, Actuator sẽ ghi nhận cảnh báo và có thể đánh dấu container là `UNHEALTHY` (DOWN).
### 1.3. Giải pháp đã thực hiện (Miễn nhiễm sự cố)
Trong cả `application.yml` và `application-prod.yml`, hệ thống đã cấu hình tắt kiểm tra sức khỏe Redis của Actuator:
```yaml
management:
health:
mail:
enabled: false
redis:
enabled: false
```
Nhờ đó, Spring Boot khởi động mượt mà, Tomcat chạy ổn định trên cổng 7860 mà không bị gián đoạn hay crash container ngay cả khi Redis không khả dụng.
---
## 2. HƯỚNG DẪN CẤU HÌNH CHO GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING
Giai đoạn 4 theo đề cương (21/10/2026 – 03/11/2026) bao gồm:
* Khởi tạo phòng họp video/audio trực tuyến thời gian thực giữa các thành viên dự án.
* Chia sẻ màn hình (Screen sharing), điều khiển mic/camera.
* Ghi hình cuộc họp (Recording qua LiveKit Egress) và tự động lưu trữ vào kho tệp dự án (Project File Storage).
### 2.1. Đăng ký tài khoản LiveKit Cloud (Miễn phí)
1. Truy cập [cloud.livekit.io](https://cloud.livekit.io/) và đăng nhập bằng tài khoản Google hoặc GitHub.
2. Tạo một Project mới (ví dụ đặt tên: `taskpilot-collab`).
3. Sau khi tạo project, điều hướng vào mục **Project Settings** > **Keys**:
* **WebSocket URL**: Dạng `wss://taskpilot-collab-xxxxxx.livekit.cloud`
* **API Key**: Dạng `APIxxxxxxxxxxxx`
* **API Secret**: Dạng `secretxxxxxxxxxxxxxxxxxxxx`
4. Sao chép 3 giá trị trên để chuẩn bị thêm vào `.env`.
### 2.2. Các biến môi trường cần bổ sung cho Giai đoạn 4
Trong file `.env` (cả local và cấu hình Secrets trên Hugging Face Spaces / Production), bổ sung nhóm biến:
```env
# ==============================================================================
# GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING & RECORDING
# ==============================================================================
LIVEKIT_URL=wss://taskpilot-collab-xxxxxx.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
LIVEKIT_EMPTY_TIMEOUT_SECONDS=300
LIVEKIT_MAX_PARTICIPANTS=15
```
### 2.3. Tích hợp Egress Recording lưu vào S3 (Tùy chọn)
Nếu nhóm triển khai tính năng tự động ghi hình cuộc họp, LiveKit Cloud hỗ trợ xuất video trực tiếp vào S3 Storage. Bạn có thể sử dụng trực tiếp Supabase S3 bucket `documents` đã có sẵn:
* **Storage Type**: S3 Compatible
* **Endpoint**: Giá trị của `SUPABASE_S3_ENDPOINT`
* **Access Key**: Giá trị của `SUPABASE_S3_ACCESS_KEY`
* **Secret Key**: Giá trị của `SUPABASE_S3_SECRET_KEY`
* **Bucket**: `documents`
* **Region**: `ap-southeast-1`
---
## 3. FILE MẪU `.env` TOÀN DIỆN CHO DỰ ÁN TASKPILOT (FULL TEMPLATE)
Dưới đây là mẫu file `.env` hoàn chỉnh chứa 100% các biến môi trường của tất cả các phân hệ:
```env
# ==============================================================================
# 1. CƠ SỞ DỮ LIỆU POSTGRESQL (SUPABASE PGVECTOR)
# ==============================================================================
# Lưu ý: Cổng 6543 là Transaction Pooler của Supabase, cần prepareThreshold=0
DB_URL=jdbc:postgresql://aws-1-ap-southeast-1.pooler.supabase.com:6543/postgres?sslmode=require&prepareThreshold=0
DB_USERNAME=postgres.vbuvggybjjnotyxtbtnw
DB_PASSWORD=YOUR_SUPABASE_DB_PASSWORD
# ==============================================================================
# 2. XÁC THỰC BẢO MẬT (JWT & AUTH)
# ==============================================================================
JWT_SECRET=d6f0f991aa2c94368d21776821a88fa305402cbf2cbcecbca0b5dee2f68094e4
JWT_EXPIRATION=86400000
JWT_BLOCKLIST_PROVIDER=memory
PASSWORD_RESET_EXPIRATION=900000
# ==============================================================================
# 3. DỊCH VỤ EMAIL (BREVO SMTP RELAY)
# ==============================================================================
MAIL_HOST=smtp-relay.brevo.com
MAIL_PORT=2525
MAIL_USERNAME=YOUR_BREVO_SMTP_USERNAME
MAIL_PASSWORD=YOUR_BREVO_SMTP_KEY
MAIL_FROM="TaskPilot Support<support.taskpilot@gmail.com>"
# ==============================================================================
# 4. BỘ NHỚ ĐỆM & RATE LIMIT (UPSTASH REDIS)
# ==============================================================================
# Nếu sử dụng Upstash Redis, tạo database mới tại https://console.upstash.com/redis
REDIS_HOST=YOUR_UPSTASH_REDIS_ENDPOINT.upstash.io
REDIS_PASSWORD=YOUR_UPSTASH_REDIS_PASSWORD
REDIS_PORT=6379
REDIS_SSL=true
# ==============================================================================
# 5. KHO LƯU TRỮ TỆP TIN & AVATAR (SUPABASE S3 COMPATIBLE STORAGE)
# ==============================================================================
SUPABASE_S3_ENDPOINT=https://vbuvggybjjnotyxtbtnw.storage.supabase.co/storage/v1/s3
SUPABASE_S3_ACCESS_KEY=YOUR_SUPABASE_S3_ACCESS_KEY
SUPABASE_S3_SECRET_KEY=YOUR_SUPABASE_S3_SECRET_KEY
SUPABASE_S3_REGION=ap-southeast-1
SUPABASE_S3_BUCKET=avatars
SUPABASE_S3_DOCUMENT_BUCKET=documents
SUPABASE_S3_PUBLIC_URL=https://vbuvggybjjnotyxtbtnw.supabase.co/storage/v1/object/public/avatars
# ==============================================================================
# 6. THÔNG BÁO THỜI GIAN THỰC (ONESIGNAL PUSH NOTIFICATIONS)
# ==============================================================================
ONESIGNAL_APP_ID=YOUR_ONESIGNAL_APP_ID
ONESIGNAL_REST_API_KEY=YOUR_ONESIGNAL_REST_API_KEY
# ==============================================================================
# 7. AI LLM GATEWAY (MULTI-KEY ROTATION & FAILOVER)
# ==============================================================================
# Google Gemini (Dùng cho Chat AI, Embedding 768-dim RAG)
GEMINI_API_KEY=YOUR_PRIMARY_GEMINI_API_KEY
GEMINI_API_KEYS=KEY_1,KEY_2
# Groq Fast Inference (Llama 3.3, Llama 4 Scout)
GROQ_API_KEY=YOUR_PRIMARY_GROQ_KEY
GROQ_API_KEYS=KEY_1,KEY_2,KEY_3,KEY_4,KEY_5
AI_GROQ_ENABLED=true
AI_GROQ_GATEKEEPER_MODEL=llama-3.1-8b-instant
# OpenRouter Fallback Models (Free models)
OPENROUTER_API_KEY=YOUR_PRIMARY_OPENROUTER_KEY
OPENROUTER_API_KEYS=KEY_1,KEY_2,KEY_3,KEY_4
AI_OPENROUTER_ENABLED=true
# GitHub Models Token
GITHUB_TOKEN=YOUR_GITHUB_PAT_TOKEN
# ==============================================================================
# 8. MÔI TRƯỜNG WEB & CORS
# ==============================================================================
FE_ORIGIN="https://taskpilot-platform.netlify.app, http://localhost:5173, http://127.0.0.1:5173"
# ==============================================================================
# 9. GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING (CHUẨN BỊ CHO KỲ 21/10)
# ==============================================================================
LIVEKIT_URL=wss://YOUR_PROJECT.livekit.cloud
LIVEKIT_API_KEY=YOUR_LIVEKIT_API_KEY
LIVEKIT_API_SECRET=YOUR_LIVEKIT_API_SECRET
```
---
## 4. BIẾN MÔI TRƯỜNG CHO FRONTEND (`taskpilot-frontend/.env.local`)
Đối với giao diện Frontend:
```env
# Backend API Base URL
VITE_API_BASE_URL=http://localhost:8080/api
# Vite proxy target cho local development
VITE_API_PROXY_TARGET=http://localhost:8080
# Push Notification
VITE_ONESIGNAL_APP_ID=YOUR_ONESIGNAL_APP_ID
# Tùy chọn: URL WebSocket riêng nếu không dùng tự động phân giải
# VITE_WS_URL=ws://localhost:8080/ws/chat
# Chuẩn bị cho Giai đoạn 4: LiveKit Server URL cho frontend WebRTC
# VITE_LIVEKIT_URL=wss://YOUR_PROJECT.livekit.cloud
```
|