diff --git a/docs/02-interactive-prototype.md b/docs/02-interactive-prototype.md index 880c572..fb8cc57 100644 --- a/docs/02-interactive-prototype.md +++ b/docs/02-interactive-prototype.md @@ -38,8 +38,17 @@ ```text prototype/ +├── public/ +│ └── assets/ # Logo 主视觉与小尺寸品牌标记 ├── src/ -│ ├── App.vue # 原型页面、演示状态和交互流程 +│ ├── App.vue # 双端应用骨架、导航和全局反馈 +│ ├── views/ +│ │ ├── AuthView.vue # 登录、邀请码注册、忘记密码 +│ │ ├── UserConsole.vue # 用户端页面与交互 +│ │ └── AdminConsole.vue # 管理端页面与交互 +│ ├── components/ # 弹窗、详情抽屉等共享组件 +│ ├── data.ts # 原型数据与导航配置 +│ ├── types.ts # 页面数据契约 │ ├── main.ts # Vue 入口 │ ├── styles.css # 设计令牌、响应式布局和视觉样式 │ └── vite-env.d.ts @@ -50,12 +59,13 @@ prototype/ └── README.md ``` -当前为了快速验证端到端体验,演示数据集中在 `App.vue`。进入真实开发时,建议拆为 `layouts`、`views`、`components`、`composables`、`stores` 和 `types`,并将页面数据替换为后端 API。 +原型已经按用户端、管理端和共享组件拆分,避免页面与样式继续集中在单个组件。进入真实开发时,在现有边界上增加 `layouts`、`composables`、`stores` 和 API 客户端,并将 `data.ts` 的演示数据替换为后端 API。 ## 三、原型页面范围 | 页面 | 当前原型覆盖 | 后续真实接口方向 | |---|---|---| +| 登录/注册 | 登录、邀请码注册、邮箱/手机号切换、验证码倒计时、忘记密码 | OAuth/短信或邮件服务、会话、风控、公开注册开关 | | 总览 | 调用趋势、额度、可用性、活动和精选模型 | 工作区概览、用量聚合、实时服务状态 | | 模型广场 | 类型筛选、关键词搜索、模型卡、在线试用 | 模型目录、能力 schema、供应商和版本信息 | | Playground | 模型选择、调用模式、提示词、调用中、成功和异步提交状态 | 真实模型请求、SSE、任务 API、请求 ID 和用量 | @@ -107,10 +117,12 @@ API Keys → 创建 API Key → 填写名称和权限范围 ## 五、视觉与交互原则 - 使用深色导航 + 明亮工作区,形成“平台基础设施 + 开发者工具”的产品气质。 -- 紫色表达平台和核心操作,青色表达连接与安全,橙色表达异步任务和容量状态,绿色表达成功与健康。 +- Logo 的电光青、深蓝和结构紫构成品牌主色;青色表达连接与安全,紫色表达平台和核心操作,橙色表达异步任务和容量状态,绿色表达成功与健康。 +- 可读性优先:页面正文不低于 12px,辅助说明不低于 10px;浅色背景使用更深的中性灰,深色背景使用高亮蓝灰,保证文字与背景有足够对比度。 - 重要操作使用明确动词:探索模型、开始调用、创建 API Key、查看任务、复制 Base URL。 - 状态始终可见:服务健康、调用模式、任务进度、额度、Key 状态和操作结果均有视觉反馈。 -- 桌面端优先,同时在 860px 和 560px 断点下压缩导航、卡片和表格,保证原型可用于移动端评审。 +- 桌面端优先,同时在 900px 和 600px 断点下压缩导航、卡片和表格,保证原型可用于移动端评审。 +- 新版响应式布局采用桌面固定侧栏、平板移动抽屉、手机单列内容;认证页在平板隐藏展示区、在手机压缩品牌主视觉,表格在窄屏保持列宽并允许横向滚动,避免强制压缩造成错位。 - 不绑定具体第三方客户端品牌;接入文档面向 AI 应用、业务系统、开发工具和 SDK/HTTP 的通用方式。 - 用户端和管理端使用独立导航与产品语境;第一阶段共享前端工程和设计系统,管理员可在两端切换。 @@ -119,6 +131,7 @@ API Keys → 创建 API Key → 填写名称和权限范围 - `pnpm install` 后可以启动 `pnpm dev`,并访问 `http://localhost:4173`。 - `vue-tsc --noEmit` 通过,`vite build` 通过。 - 用户可以在总览、模型广场、Playground、Key、任务、用量和文档之间切换。 +- 用户打开原型先进入登录页,可切换登录/注册,使用邀请码完成注册演示,发送验证码并体验忘记密码流程。 - 管理员可以从用户端进入独立管理端,并在管理总览、用户、模型、路由、队列、计费、审计和设置模块间切换。 - 管理端核心列表具备搜索、筛选、开关、抽屉、弹窗、额度发放、邀请创建和设置保存等可演示交互。 - 用户可以从模型卡进入 Playground,完成一次演示调用并看到成功反馈。 diff --git a/prototype/README.md b/prototype/README.md index 27039a3..3c715c8 100644 --- a/prototype/README.md +++ b/prototype/README.md @@ -17,9 +17,10 @@ pnpm dev - 独立的用户端和管理端信息架构,管理员可从用户端进入管理端并返回。 - 管理端覆盖用户额度、模型供应商、路由、并发队列、计费、审计和平台设置的完整页面原型。 - 邀请码内测语境、管理员额度发放、充值入口预留状态。 +- 品牌 Logo 资产、登录/注册、邀请码注册、邮箱/手机号切换、验证码倒计时和忘记密码流程。 - 同步/流式/异步调用的交互状态、Key 创建与一次性展示、任务进度、筛选、复制和 Toast 反馈。 - 面向 AI 应用、开发工具和 SDK/HTTP 的通用接入说明,不绑定某一个具体客户端品牌。 ## 后续复用 -页面数据集中在 `src/App.vue` 的演示状态中;接入后端时可以将其替换为 API composables 或 Pinia store,保留现有页面结构和交互契约。 +原型已按产品边界拆为认证页、用户端、管理端和共享组件:`src/App.vue` 只负责应用骨架与双端切换,页面分别位于 `src/views/`,品牌资产位于 `public/assets/`,演示数据和类型位于 `src/data.ts`、`src/types.ts`。接入后端时可以把页面内状态替换为 API composables 或 Pinia store。 diff --git a/prototype/index.html b/prototype/index.html index 56ae26f..6af8f40 100644 --- a/prototype/index.html +++ b/prototype/index.html @@ -5,6 +5,7 @@ +