Changelog — CRELALA
All notable changes to CRELALA are documented here.
Format phiên bản: `YY:MM:NN` — năm · tháng · build thứ tự (reset về 00 mỗi tháng mới).
[26:07:66] — 2026-07-14 · "Pricing Policy Go-Live (GĐ1) + Real Google SSO"
Áp dụng chính sách giá 2026 (docs/Crelala_Chinh_Sach_Gia_2026.md v2.1): bỏ gói Free, không bán lỗ ở bất kỳ model nào, catalog model chính hãng với ID thật của BytePlus. Kèm các thay đổi auth/SSO đã deploy trong các build 26:07:54–65.
Billing core (mới trong build này)
- Pricing engine (
backend/app/core/pricing.py— file mới, nguồn sự thật duy nhất):- Giá video theo model × resolution × duration — 6 model Seedance thật (flagship 2.0 gồm 4K, Fast, Mini, 1.5 Pro, 1.0 Pro, 1.0 Pro Fast); từ chối resolution model không hỗ trợ thay vì âm thầm tính giá tier rẻ
- TTS đổi từ phí cố định 5 credit/lượt sang 15 credit/1,000 ký tự (phí cố định cũ lỗ từ ~633 ký tự)
PLAN_INFOmới:pending(0 credit) / Pro $19 → 6,500 credit / Pro+ $49 → 17,000 credit (bỏ "unlimited" 99,999) — trần theo margin sàn 30% (price × 350)
- Catalog sync (
seed.py::_sync_model_catalog, chạy mỗi startup): thay toàn bộexternal_model_idbịa (seedance-video-2.0...) bằng Model ID thật của BytePlus (dreamina-seedance-2-0-260128...), tên hiển thị trung thực theo đúng model được gọi; vô hiệu hoá vĩnh viễn 3 ID giả cũ - Bỏ gói Free: đăng ký mới (email + Google SSO) →
plan="pending", 0 credit; welcome bonus 500 credit chuyển sang lần thanh toán đầu tiên;require_plantrả message hướng dẫn kích hoạt riêng cho tài khoản pending - Frame to Video (
/api/generate): yêu cầu gói trả phí; chặn 4K với non-Pro+; giá động theo resolution/duration - DramaC+: TTS trừ credit theo độ dài thoại thực tế;
generate-script/producegate gói trả phí - Payments: endpoint mới
POST /api/payments/subscribe(Stripe Checkout cho gói Pro/Pro+, monthly/annual); webhook kích hoạt gói — set plan + hạn, cấp credit tháng + welcome bonus lần đầu, idempotent chống replay - Frontend
TopBar: đồng bộ nhãn/trần credit gói mới, sửa bug chia-cho-0 khi maxCredits=0
Auth & SSO (các build 26:07:54–65, gộp ghi nhận)
- Bắt buộc đăng nhập (Google SSO hoặc API key) cho toàn bộ User Portal: guard ở
(user)/layout.tsx, bỏ auto-fallback dev-token, từ chối session cũ không có cờ auth-method; 401 → logout + redirect/login - API key login:
POST /api/auth/api-key-login+ backend chấp nhận Bearercrl_sk_*thay JWT; form đăng nhập API key trên trang login - Google SSO thật: wiring
GOOGLE_CLIENT_IDqua docker-compose vào backend (validate audience, từ chối khi thiếu cấu hình ở production) + frontend build; nút Google chính thức (theme tối/pill — bản custom ẩn bị Google chặn anti-clickjacking) - Sidebar: thêm nút logout (TopBar bị ẩn ở hầu hết trang), hiển thị đúng user đang đăng nhập thay vì hard-code
- Reset password demo admin; deploy.sh build thêm
frontend-admin
Tài liệu
docs/Crelala_Chinh_Sach_Gia_2026.md(v2.1): chính sách giá đầy đủ — COGS BytePlus xác nhận chính thức (Video/Image/LLM/TTS/Voice Replication/ASR/Advanced Creation Rights $14,000/năm đã mua), benchmark 5 đối thủ, 7 quyết định kinh doanh đã chốt, phân tích margin từng modeldocs/Bao_Cao_Trien_Khai_Ky_Thuat_Chinh_Sach_Gia.md: báo cáo triển khai GĐ1 + roadmap GĐ2 (UI onboarding, Stripe production, gia hạn gói, Real-human Portrait)
⚠️ Điểm chặn go-live còn lại: UI onboarding chọn gói + Stripe production key (subscribe trả 503 tới khi cấu hình). Tài khoản
plan="free"cũ sẽ bị khoá generate như thiết kế.
[26:07:50] — 2026-07-12 · "RBAC Overhaul & Admin Portal Split"
Tách Admin Portal khỏi User Portal thành 2 ứng dụng/cổng riêng biệt, chuyển từ gate admin thô sang phân quyền chi tiết theo module, thêm audit log và gating theo gói (plan).
GĐ0 — Vá lỗ hổng bảo mật nền tảng
dev-token/dev-admin-token(/api/auth/*): trước đây là endpoint public không xác thực có thể mint JWT admin cho bất kỳ ai — nay bị chặn khiENV=production(helper_require_dev_env())- CORS: bỏ wildcard
*, chuyển sang allowlist quaCORS_ORIGINS(đã thêm origin cho port 3002/3003) users.role/users.status: thêm PostgresCHECKconstraint (idempotent qua migration), tránh giá trị rác
GĐ1 — RBAC theo module + Audit Log
backend/app/core/security.py:ROLE_PERMISSIONS(4 role:user/moderator/admin/super_admin) +require_permission(*perms)— đọc role trực tiếp từ DB mỗi request (không tin JWT cache) → thu hồi quyền tức thì- Toàn bộ
backend/app/routers/admin.pychuyển từrequire_adminsang permission cụ thể:stats.read,users.read/write,moderation.read/write,models.read/write,packages.read/write,providers.read/write,audit.read - Bảng
admin_actionsmới — ghi lại mọi hành động ghi (write) của admin: ai, role gì, làm gì, trên đối tượng nào GET /api/admin/audit-log— trang Audit Log mới trong Admin Console
GĐ2 — Tách Admin Portal ra ứng dụng/cổng riêng
- Ứng dụng Next.js mới
frontend-admin/— độc lập hoàn toàn vớifrontend/(package.json, Dockerfile, port riêng), chỉ dùng chung backend API - Xoá
frontend/src/app/admin/(7 trang) vàfrontend/src/proxy.tskhỏi User Portal - Docker Compose: service
frontend-adminmới, expose port 3002 - Sửa 2 lỗi tiềm ẩn phát hiện trong lúc tách: role check hard-code
"admin"khoá luôn moderator/super_admin khỏi Admin Console;Promise.alltrong trang AI Models bị fail toàn bộ chỉ vì 1 API con 403
GĐ3 — Gating theo gói (Free / Pro / Pro+)
require_plan(*plans)— tương tựrequire_permission, đọc plan trực tiếp từ DB, staff role (moderator/admin/super_admin) luôn bypass, trả 402 khi không đủ gói (phân biệt với 401 = chưa đăng nhập, 403 = không đủ quyền)- AI Studio (toàn bộ router), Storyboard (
breakdown/enhance-prompt/stitch), Flows (run-node/run) — gatedpro/pro_plus; Flows giữ nguyên route public/shared/{token}không bị gate - Frontend:
ApiErrorclass mới (frontend/src/lib/api.ts) mang theo.status→ tất cả catch block liên quan hiển thị toast 🔒 rõ ràng khi bị chặn vì gói, thay vì lỗi chung chung hoặc im lặng
GĐ4 — Hợp nhất kiểm duyệt nội dung (Generations)
generation_tasksthêm cộtsource(frame-to-video / storyboard / studio / flows / dramac) — gắn tại mọi điểm tạo taskGET /api/admin/generations(filter theo module/status/email, phân trang) +DELETE /api/admin/generations/{id}— cho phép admin xem và gỡ nội dung thật từ cả 5 module trong một màn hình duy nhất- Trang Generations mới trong Admin Console — thay thế vai trò thực tế của trang Moderation cũ (vốn chỉ thao tác trên dữ liệu demo, không liên kết với nội dung sinh thật)
Không đổi: luồng đăng ký/đăng nhập Google SSO không bị ảnh hưởng bởi bất kỳ thay đổi nào ở trên.
Việc còn để ngỏ (đã ghi nhận, chưa xử lý): trang Moderation cũ có sai lệch kiểu dữ liệu giữa frontend và backend (lỗi tồn tại từ trước, không thuộc phạm vi đợt này); DramaC+ và badge "Beta" của Storyboard chưa được xác nhận có nên gate theo gói hay không.
[26:07:24] — 2026-07-07 · "AI Model Card Redesign"
Thiết kế lại card AI model — pill badges, icon-only actions, layout đa hàng.
Settings — AI Models tab
- Multi-row card layout: tách nội dung thành 2 hàng riêng biệt thay vì nhét vào một hàng duy nhất
- Hàng 1: icon gradient + tên model + badges + action buttons
- Hàng 2:
usedInchips (Frame to Video / Flows / DramaC+ / AI Studio) + "Your key" indicator
- Icon redesign: tăng lên 40×40px với
boxShadowglow theo màu badge - Pill badges:
rounded-fullcho type badge (VIDEO / IMAGE / VOICE / ENHANCE) và "edited" badge - "edited" badge: nhỏ gọn hơn —
editicon 9px + text, opacity thấp hơn - Action buttons: icon-only (không có text label), không có divider dọc phân tách
edit→ hover white glowhide/delete→ hover amber/red glow theo contextkeyboard_arrow_down→ expand/collapse code panel
- usedIn chips: pill style
rounded-full, màu rất subtle (rgba(255,255,255,0.04)) - "Your key" indicator: green dot với CSS
boxShadowglow effect, căn phải tự động (ml-auto) - Custom models đồng bộ thiết kế với default models
- TypeScript: pass clean
[26:07:22] — 2026-07-07 · "Full Model CRUD"
CRUD hoàn chỉnh cho cả default models lẫn custom models + layout mở rộng đa hàng.
Backend
update_model(PUT /api/me/ai-config/models/{slug}): nếu slug trong__models__→ update custom; nếu không → lưu vào__overrides__delete_model(DELETE /api/me/ai-config/models/{slug}): nếu custom → xóa vĩnh viễn; nếu default → thêm vào__hidden__restore_model(POST /api/me/ai-config/models/{slug}/restore): xóa khỏi__hidden__và__overrides__get_ai_config: trả riêngcustom_models,hidden_slugs,model_overrides— không mix vàomodel_configs
Frontend
- Default model cards: thêm "Sửa" + "Ẩn" buttons luôn hiển thị
- Edit form trên default models: pre-fill từ catalog + overrides, lưu vào
modelOverridesstate - "Ẩn" confirm dialog: phân biệt hide (amber,
visibility_off) vs delete (red,warning) - Section "Models đã ẩn": hiển thị ở cuối khi có model bị ẩn, nút "Khôi phục" từng cái
- `isDefaultModel(slug)`: kiểm tra
MODEL_CATALOG - `submitEditModel`: routing đúng — default dùng
updateCustomModel()(PUT__overrides__); custom update trực tiếp api.ts: thêmrestoreModel(slug)→POST /api/me/ai-config/models/{slug}/restore
[26:07:21] — 2026-07-07 · "usedIn Chips"
Render `usedIn` chips trên model cards + layout 2 hàng ban đầu.
usedInfield trongMODEL_CATALOG(đã định nghĩa nhưng chưa render) → hiển thị dưới dạng chips- Layout outer
divtách thành 2 rows: row icon/name/actions + row chips/key status - "Your key" indicator: green dot với
ml-autocăn phải
[26:07:20] — 2026-07-06
Rebuild production cho v26:07:19–20 với CRUD custom models và layout fixes.
- Deployed CRUD custom models lên production port 3000
- Fix "edited" badge: thay thế badge lớn "ĐÃ TUỲ CHỈNH" bằng small inline indicator (
edit_noteicon + "edited") - Fix Delete button không hiển thị trên default model cards
[26:07:19] — 2026-07-06 · "Custom Model CRUD"
CRUD cho custom AI models trong Settings.
Backend
CustomModelBodyPydantic model:slug, name, badge, external_id, endpoint, descPOST /api/me/ai-config/models: thêm model vào__models__arrayPUT /api/me/ai-config/models/{slug}: cập nhật model (kể cả đổi slug — migration key trongmodel_configs)DELETE /api/me/ai-config/models/{slug}: xóa model vĩnh viễn- Helper
_load_configs()và_save_configs()tái sử dụng xuyên suốt
Frontend
BADGE_META: mapping type → color/gradient/icon cho VIDEO/IMAGE/VOICE/ENHANCECustomModeltype +BLANK_FORM+makeDefaultCode(externalId, endpoint)tự sinh curl/python template- States:
customModels,showAddForm,addForm,addingModel,editingSlug,editForm,updatingModel,confirmDeleteSlug,deletingModel - Add form inline: name, slug, badge, external_id, endpoint, desc
- Edit form inline per custom model card
- Confirm dialog trước khi xóa
- Custom model badge "Custom" màu tím nhạt
api.ts:addCustomModel(),updateCustomModel(),deleteCustomModel()
[26:07:18] — 2026-07-05 · "Editable Sample Code"
Cho phép chỉnh sửa trực tiếp sample code (curl/python) cho từng AI model.
Backend
PUT /api/me/ai-config/model-code: lưu{ slug, lang, code }vàomodel_configs[slug][lang]DELETE /api/me/ai-config/model-code/{slug}/{lang}: reset về default (xóa key)
Frontend — Settings AI Models tab
<pre><code>→<textarea>editable, font-mono, resize manual- Toolbar bên dưới mỗi code block: Copy · Reset · Save
- Copy: clipboard API với animation "Copied!" 2 giây
- Reset: khôi phục về default code (catalog default hoặc
makeDefaultCode()) - Save: gọi
api.me.saveModelCode(), badge "Đã lưu!" màu emerald 2 giây isCustomCode(slug, lang): so sánh với default để detect thay đổi- "● Đã chỉnh sửa" indicator trong toolbar khi code khác default
editedCodestate: lưu local changes trước khi saveapi.ts:saveModelCode(slug, lang, code),deleteModelCode(slug, lang)
[26:07:16] — 2026-07-04
Unify background thuần đen trên tất cả layout surfaces.
- Tất cả
bg-[#0a0a0a],bg-[#080808],bg-neutral-950→bg-black/#000 - Layout
(user)/layout.tsx, Sidebar, các workspace pages: đồng bộ màu nền - Loại bỏ gradient backgrounds không nhất quán
[26:07:12] — 2026-07-03 · "AI Model Integration Tab"
Tab "AI Models" trong User Settings — BYOK + catalog + code samples.
Backend
UserAiConfigORM model:user_id,kairouter_key,model_configs(TEXT/JSON)GET /api/me/ai-config: trảhas_own_key,key_prefix,model_configsPUT /api/me/ai-config: lưu/thaykairouter_keyDELETE /api/me/ai-config: xóa key
Frontend — Settings tab mới "AI Models"
- KaiRouter Gateway card: hiển thị key prefix + masked key, "YOUR KEY" / "PLATFORM KEY" badge
- Buttons: "Nhập key" / "Thay key" / "Xoá key" với confirm
- MODEL_CATALOG: hardcoded catalog 8 models với metadata đầy đủ (slug, name, badge, gradient, externalId, endpoint, usedIn, curl, python)
- Model cards collapsible: header + code panel (curl/Python tabs, syntax highlight, copy button)
- Endpoint + model ID hiển thị trong code panel header
- `api.ts`:
getAiConfig(),saveAiConfig(),deleteAiConfig()
Model Catalog changes
- Xóa: Seedream 3.0
- Thêm mới:
Dola-Seedream 5.0 Lite(IMAGE)ByteDance-Seedream 4.5(IMAGE)ByteDance-Seedream 4.0(IMAGE)
[26:07:08] — 2026-07-06 · "Phase II — KaiRouter AI Integration"
Kết nối toàn bộ workspace tools vào AI thực qua KaiRouter gateway (S1–S6).
S1 — AI Provider Config
- DB model
AiProvider+AiModel(slug,base_url,api_key_enc,external_model_id,model_type,cost_per_gen) - Admin UI: quản lý provider & model, toggle active/default, cost config
- Seed: Seedance 2.0 (video), Kling 1.6 (video), FLUX 1.1 (image), Seed TTS 2.0 (voice), Claude Haiku 4.5 (llm)
S2 — KaiRouter Client + Frame-to-Video
backend/app/services/kairouter.py: OpenAI-compatible client tớihttps://kairouter.com/v1/video_generate(),chat_complete(),tts_generate(),image_generate()- Background
poll_kairouter_video(): async polling task
- Frame-to-Video: image upload (
POST /api/upload/image) → real KaiRouter video generation → mock fallback nếu chưa cấu hình
S3 — Storyboard AI
POST /api/storyboard/breakdown: LLM phân cảnh synopsis → N scenes (title, prompt, shot_type, camera_motion, duration)POST /api/storyboard/enhance-prompt: LLM rewrite scene prompt theo cinematic styleuseStoryboard.ts:aiBreakdown()+aiEnhanceScene()gọi backend thực; fallback deterministic mock
S4 — Flows Executor
POST /api/flows/run-node: single node execution (textToVideo / imageToVideo / voiceGen)POST /api/flows/run: topological sort (Kahn's algorithm) → pipe outputs giữa nodes- UI Flows: "Run Flow" button wired với real polling; spinner + status updates per node
S5 — DramaC+ Pipeline
POST /api/drama/generate-script: LLM viết kịch bản tiếng Việt từ cốt truyện + nhân vậtPOST /api/drama/produce: LLM storyboard breakdown → submit video job mỗi scene → trảtask_id[]để poll- Drama UI:
ScriptReviewPanelnhận script từ API; "Bắt đầu sản xuất" poll real task IDs;ProductionModalshow tiến độ từng scene
S6 — AI Studio Timeline
runAiTool()thay mock timeout bằng API thực:- AI Voice:
flows/run-node(voiceGenNode) → Seed TTS 2.0 → audio clip vào A1 Voice track - Smart Edit:
flows/run-node(textToVideoNode) → Seedance 2.0 → video clip vào V1 track - Các tool khác (captions, beat-sync, scene-detect): client-side toast feedback
- AI Voice:
AIToolsPaneltruyền{ aiPrompt, voiceId, voiceSpeed }vàoonRunđể dispatch đúng API
[26:06:44] — 2026-06-29 · "Mobile Responsive"
Mobile responsive cho Docs, Flows, Explore price filter.
- Docs page: sidebar collapse trên mobile, single-column layout
- Flows: touch-friendly node canvas, mobile panel
- Explore: price range filter responsive
[26:06:16] — 2026-06-28
Merge branch KaisarNetworkAI → main.
- Resolve conflicts: Sidebar nav keys, i18n locale dictionaries, landing page copy
- Tất cả features từ v26:06:05 → v26:06:15 lên main branch
[26:06:15] — 2026-06-28 · "DramaC+"
Module DramaC+, AI Studio, AUTOMATION nav, PageHeader/Footer toàn bộ modules.
Modules mới
- DramaC+ (
/workspace/drama-c):- Section A: cốt truyện + genre presets (Romance / Thriller / Sci-Fi / Historical)
- Section B: character grid (tối đa 6), upload avatar, Face SDK
- Section B2:
ScriptReviewPanel— 3 tabs (Kịch bản / Nhân vật / Ghi chú) + gate "Phê duyệt kịch bản" - Section C: config resolution/style/duration — locked cho đến khi script được phê duyệt
ProductionModal: 5 bước animated + real log + "Xem Drama" / "Tải xuống"
- `/workspace/super-drama` → redirect sang
/workspace/drama-c
Đổi tên nav
| Cũ | Mới |
|---|---|
| SuperDrama+ | DramaC+ |
| Pro+ Studio | AI Studio |
| PINNED TOOLS | AUTOMATION (Pro+) |
Shared components
- `PageHeader`: module icon + tên + badge + tagline + quick actions
- `PageFooter`:
CRELALA vXX:XX:XX · Module+ "View Docs →" - Áp dụng vào 7 pages: Frame to Video, Storyboard, AI Studio, DramaC+, Flows, Library, Explore
[26:06:13] — 2026-06-27 · "Creator Economy"
4 ngôn ngữ mới + Creator Economy section.
i18n — 8 ngôn ngữ (+ 4 mới)
Thêm: Français (fr), Español (es), Português (pt), 日本語 (ja).
Landing — Creator Economy section
- 3-col value props: Creator Marketplace (80% revenue share), Remix & Royalties, Creator Fund
- Community feed mockup với earnings overlay
- "How it works" 3 bước + CTA
[26:06:11] — 2026-06-26 · "Collapsible Sidebar"
Sidebar thu gọn với icon-only mode.
- Width toggle: 256px (expanded) ↔ 64px (collapsed)
- Trạng thái persist vào
localStoragekeycrelala_sidebar_collapsed - Collapsed: tooltips thay labels, language picker popup, avatar thay user block
- Toggle button:
chevron_left/chevron_right
[26:06:09] — 2026-06-26 · "Blueprint"
AI Studio: import media files từ thiết bị.
- Drag & drop / click upload video, audio, image vào Media Bin
- Formats: MP4, MOV, WebM, MP3, WAV, M4A, JPG, PNG, WebP
FileReader→ dataURL; track type auto-assign (video/audio/image)
[26:06:01] — 2026-06-25 · "Project Management"
Hệ thống project management thống nhất trên tất cả 4 modules.
useProjects<T> hook
- Generic project manager lưu localStorage theo
moduleKey - CRUD đầy đủ: create, open, save, rename, duplicate, delete
- Track
isDirty,lastSaved, auto-restore on mount
ProjectMenuButton component
- Dropdown tại header: New (⌘N), Open (⌘O), Rename, Save
- Save indicator real-time (dot xanh khi có thay đổi chưa lưu)
ProjectsGallery component
- Modal 3-col grid — thumbnail, relative time, search
- Context menu: Open, Rename, Duplicate, Delete
Tích hợp
| Module | State được lưu |
|---|---|
| Frame to Video | prompt, model, duration, aspectRatio, camera, mode |
| Storyboard | scenes, genre, synopsis, generateMode |
| AI Studio | tracks state |
| Flows | nodes + edges JSON |
[26:06:00] — 2026-06-24 · "Aurora"
First release — CRELALA AI Video Studio.
Platform
- Khởi tạo standalone project
crelala(tách từ monorepoxDrama) - Docker Compose:
frontend(Next.js 16 standalone) +backend(FastAPI) +postgres
Frontend
- Landing page: 10 sections (Hero, Gallery, Bento, Social proof, How it works, Testimonials, Pricing, FAQ, Creator Economy, Footer)
- Arc Nucleus logo: SVG gradient fuchsia→violet
- User portal: sidebar layout + 4 workspace modules + library/explore/docs/settings/history
- Workspace modules:
- Frame to Video: 2-panel; modes: start-end / single / text-ref; 10 camera presets; 4 models
- Storyboard: script editor + grid/filmstrip view + scene director panel
- AI Studio: multi-track timeline (VIDEO/AUDIO/VFX/TEXT/B-ROLL/MUSIC) + AI tools panel + media bin
- Flows: ReactFlow canvas, 8 node types, edge connections, JSON/Markdown export
- Admin Console: Dashboard KPIs, Users & Credits, Content moderation, AI Models, Credit packages
- Settings: 6 tabs — Profile, Plan & Credits, API Keys, Security, Notifications, Appearance
Backend
- FastAPI + SQLAlchemy + PostgreSQL
- Video generation:
/api/generate,/api/status/{task_id} - Admin CRUD, auth, health, version endpoints
- Mock mode:
KAIROUTER_API_KEYkhông bắt buộc cho dev
Version Management
- Format
YY:MM:NN, fileVERSIONtại root - Pre-commit hook tự động bump mỗi
git commit scripts/bump-version.sh+scripts/deploy.sh
Upcoming
[26:08:00] — Planned
- [ ] WebSocket real-time generation progress
- [ ] Stripe payment integration
- [ ] CDN video output (CloudFront / BOS)
- [ ] Multi-user collaboration on projects
- [ ] Template marketplace (Flows templates, drama presets)
- [ ] GitHub Actions CI/CD pipeline
- [ ] Creator analytics dashboard
[26:09:00] — Planned
- [ ] Mobile app (React Native)
- [ ] DramaC+ batch export
- [ ] KLING V2 model integration
- [ ] Plugin system for custom node types in Flows
