Files
group_xinghuo_jinrong/web

JinRong Web

React 19 + Vite 8 + Ant Design 6 + Tailwind CSS v4 · HashRouter · 联调本机 FastAPI。

现状(2026-09-09): 「静奢智能」视觉层 + 四角色 Dashboard 首页(真接平台读 API);Chat/SSE、共享行情页、risk 处置 UI 待接。

交接手册(改前端必读): docs/frontend/FRONTEND-HANDOFF.md

启动

# 终端 1:后端(仓库根)
uvicorn app.main:app --reload

# 终端 2:前端
cd web
npm install          # 首次或 package.json 变更后(含 tailwindcss / @tailwindcss/vite)
npm run dev

浏览器:http://127.0.0.1:5173/#/login · 业务路由示例 /#/app/customer/home

验证

npm run build
npm run test    # 14 例 Vitest
npm run lint    # oxlint(现有 hooks Fast Refresh 警告可忽略,见交接手册 §9)

技术要点

项 说明
样式 src/styles/tokens.css 设计令牌 + Tailwind utility;勿在页面硬编码品牌色
分层 pages → hooks/api/utils · components/ui 禁止 import API/auth
代理 Vite /api → http://127.0.0.1:8000
收益色 正收益朱砂红、负值翡翠绿(产品约定,勿反转)

装饰素材

文件 用途
public/assets/brand/logo-mark.svg Header / 登录 Logo
public/assets/illustrations/login-finance.svg 登录页插画
public/assets/illustrations/empty-*.svg Empty / 占位