AstroResearch/dashboard

AstroResearch Dashboard / 前端仪表盘控制台

本模块是 AstroResearch 的前端部分，基于 React (TypeScript) + Vite + Tailwind CSS 构建。

---

1. 本地开发与调试 (Setup & Dev)

1.1 安装依赖

确保已安装 Node.js (v18+)，在当前目录下运行：

npm install

1.2 启动开发服务器

npm run dev

开发服务器将默认运行在 http://localhost:5173。Vite 已配置了对 http://localhost:8000 (后端) 的代理转发，跨域请求会自动路由。

---

2. 核心功能及文件结构 (Core Modules)

• src/components/layout/：侧边栏与基本布局组件。
• src/components/CitationGalaxyCanvas.tsx：自研的 Canvas 力导向引文星系图渲染器。
• src/features/search/：统一检索面板，支持跨源搜索与收藏。
• src/features/library/：馆藏管理卡片，提供下载状态实时监测及重新下载操作。
• src/features/reader/：左右对齐的双分栏阅读器，内置划词高亮笔记及 LLM 重新翻译触发。
• src/types.ts：全局 TypeScript 静态类型定义。

---

3. 生产构建 (Build)

若需打包生成生产环境静态文件：

npm run build

打包文件将输出至当前目录下的 dist/，后端 Axum 在编译时会直接将其静态托管。

---

4. 开发规范 (Coding Standards)

• 本模块的详细前端开发约定，请参阅本目录下的 前端开发规范-React篇.md。