# AstroResearch Dashboard / 前端仪表盘控制台

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

---

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

### 1.1 安装依赖
确保已安装 Node.js (v18+)，在当前目录下运行：
```bash
npm install
```

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

---

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

- `src/pages/`：页面级大组件视图（如统一检索、馆藏管理、对照阅读、引文星系、批量同步、智能科研、系统设置）。
- `src/components/`：通用与专有 UI 组件（如力导向引文星系图、文献阅读器子组件、流水线任务终端等）。
- `src/hooks/`：抽取出的全局共享及业务数据逻辑 Hooks（如 `useLibrary`、`useReaderState`、`useSyncState` 等）。
- `src/types/`：全局 TypeScript 静态类型定义（`types/index.ts`）。

---

## 3. 生产构建 (Build)

若需打包生成生产环境静态文件：
```bash
npm run build
```
打包文件将输出至当前目录下的 `dist/`，后端 Axum 在编译时会直接将其静态托管。

---

## 4. 开发规范 (Coding Standards)
- 本模块的详细前端开发约定，请参阅本目录下的 [前端开发规范-React篇.md](前端开发规范-React篇.md)。