Duyệt asset cục bộ với ak:marketing-dashboard

Dùng ak:marketing-dashboard để vận hành ứng dụng Vue và Hono cục bộ hiện tại nhằm duyệt marketing asset, kiểm tra brand context, upload logo đã validate và cấu hình API base URL của browser client. README là nguồn vận hành; ứng dụng hiện tại không có campaign manager, content library, AI generation endpoint hay automation recipe.

Chọn dashboard để kiểm tra cục bộ

Dùng ak:marketing-dashboard khi

• Bạn cần view Assets (/), Brand (/brand) hoặc Settings (/settings).
• Bạn muốn rescan shared asset, preview tệp hỗ trợ, cập nhật asset metadata, kiểm tra token hoặc voice hay upload logo sau khi được duyệt.

Chọn workflow khác khi

• Bạn cần performance analytics. Dùng ak:analytics hoặc ak:analyze.
• Bạn cần cloud asset sync, vận hành campaign, tạo content hay deployment. Các behavior này không được dashboard triển khai.
• Bạn chỉ cần mode token của launcher. Dùng ak:dashboard.

Chuẩn bị runtime và dữ liệu cục bộ

Resolve thư mục Skill đã cài qua live runtime catalog. Khuyến nghị Node.js 20 LTS. Server dùng Hono và better-sqlite3 tùy chọn; frontend dùng Vue 3 và Vite. Review port 3457, 5173, quyền network tới npm, shared assets/, docs/brand-guidelines.md, assets/design-tokens.json, assets/logos/, app/dist/ và data/marketing.db trước khi cho phép thay đổi.

Scanner tạo ID 12 ký tự từ relative asset path và ghi path, name, category, format, size, timestamp, tag, reference, campaign label cùng trạng thái suy đoán AI-generated. SQLite còn có thể lưu ai_prompt, r2_status và r2_url; các field này không chứng minh đã sync R2. Coi filename, prompt, path, URL, brand guidance và nội dung tệp là có thể bí mật. Preview text thô giới hạn 10 MB, nhưng đây là ranh giới kích thước, không phải privacy control.

Chạy Skill

/ak:marketing-dashboard "Resolve thư mục Skill đã cài, giải thích thay đổi dependency và storage, sau đó chỉ chạy development khi được duyệt"

/ak:marketing-dashboard "Resolve thư mục Skill đã cài, giải thích thay đổi dependency và storage, sau đó chỉ chạy development khi được duyệt"

$ak:marketing-dashboard "Resolve thư mục Skill đã cài, giải thích thay đổi dependency và storage, sau đó chỉ chạy development khi được duyệt"

Các script được ghi nhận là ./start.sh, ./stop.sh, ./build.sh và ./start-production.sh. Chạy chúng từ thư mục Skill đã resolve, không từ path chỉ dành cho Claude được giả định.

Hiểu các giai đoạn

1. Đọc README đã cài và resolve thư mục Skill.
2. Review dependency, port, shared source path, database, build cùng effect PID.
3. Chạy development hoặc build rồi chạy production cục bộ theo yêu cầu rõ ràng.
4. Dùng route Assets và Brand; tách action đọc khỏi scan, cập nhật metadata, upload logo và tạo filesystem.
5. Báo URL, health, mutation cùng remediation SQLite thực tế; dừng process đã sở hữu.

Bảo vệ tệp và quyền truy cập cục bộ

Logo upload ghi PNG, JPEG, SVG hoặc WebP tối đa 5 MB vào assets/logos/ sau khi sanitize filename. Scan ghi asset metadata vào SQLite, còn metadata update có thể đổi prompt cùng field R2. Đây là mutation cục bộ cần phê duyệt. Không action dashboard nào cấp quyền upload bên ngoài, publish, truy cập provider hay chi tiêu.

Xác minh output và bằng chứng

Xác minh GET /health; kết quả route Assets và Brand; tệp thực sự được ghi; record SQLite; cùng URL frontend/API được báo. Trong development, mong đợi http://localhost:5173 và http://localhost:3457; production phục vụ app đã build từ http://localhost:3457. Ghi format không hỗ trợ, lỗi đọc, thiếu tệp brand cùng write bị bỏ qua hoặc thất bại.

Xử lý sự cố và biết giới hạn

Dashboard không bảo đảm authentication, network isolation, cloud sync, AI feature, vận hành campaign hay provider compatibility. Xem Marketing Kit và Runtime adapter.