Yuandu AI Frontweb

User-facing Visual Asset Portal & AI Creation Workspace

Live Website: https://www.emoji.icu

1) 定位（Positioning）

本仓库是元都AI用户端前台，承接平台的内容消费与创作转化：

• 视觉资产浏览：合集、单图、专题推荐
• AI 创作工作台：视频转图片任务发起与结果管理
• 个人资产中心：收藏、作品、下载、权益

---

2) 架构总览图（Architecture Overview）

---

3) 平台连接关系（Platform Topology）

flowchart LR
    User[User Browser] --> FW[Frontweb<br/>Next.js App]
    FW --> API[Backend API]
    API --> DB[(PostgreSQL)]
    API --> MQ[(Redis / Asynq)]
    MQ --> WK[Workers]
    WK --> OSS[(Qiniu Storage)]
    FW --> OSS

Loading

---

4) 前端模块关系图（Frontend Modules）

flowchart TD
    AppRouter[App Router] --> PageHome[Home / Explore]
    AppRouter --> PageCreate[Create Workspace]
    AppRouter --> PageMine[Mine / Works / Favorites]
    AppRouter --> PageProfile[Subscription / Compute / Cards]

    PageCreate --> Workbench[Task Explorer + Visual Canvas + AI Console]
    PageMine --> Downloads[Download & Collection Management]

    PageHome --> APIClient[API Client]
    Workbench --> APIClient
    Downloads --> APIClient
    PageProfile --> APIClient

    APIClient --> Backend[Yuandu AI Backend]

Loading

---

5) 路线图目录（Roadmap）

阶段	方向	状态
Phase 1	用户消费链路（浏览/收藏/下载）稳定化	✅ In Progress
Phase 2	创作工作台增强（任务可视化、结果筛选、效率优化）	🚧 In Progress
Phase 3	创作者协作能力（模板化、批量化、团队化）	🗓️ Planned

---

6) Tech Stack

• Next.js 16
• React 19
• TypeScript
• Tailwind CSS 4

---

7) Quick Start

npm install
cp .env.example .env.local
npm run dev

Default: http://localhost:5918

---

8) Environment

NEXT_PUBLIC_API_BASE=/api
NEXT_PUBLIC_QINIU_ROOT_PREFIX=emoji
# NEXT_PUBLIC_QINIU_ALLOWED_ROOT_PREFIXES=emoji,emoji-dev,emoji-prod,emoji-prod-v2

• Local direct backend: http://localhost:5050/api
• Production: recommend Nginx reverse proxy on /api
• NEXT_PUBLIC_QINIU_ROOT_PREFIX: 当前环境主对象存储前缀（如 emoji-dev / emoji-prod-v2）
• NEXT_PUBLIC_QINIU_ALLOWED_ROOT_PREFIXES（可选）: 允许的历史前缀白名单（逗号分隔）

---

9) Build & Run

npm run build
npm run start

---

10) Deployment

See: docs/DEPLOYMENT.md

---

11) License

See LICENSE.