feat: 初始化 AstroResearch 核心系统代码及重构技术文档

dashboard/README.md

@@ -0,0 +1,45 @@
+# 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/components/layout/`：侧边栏与基本布局组件。
+- `src/components/CitationGalaxyCanvas.tsx`：自研的 Canvas 力导向引文星系图渲染器。
+- `src/features/search/`：统一检索面板，支持跨源搜索与收藏。
+- `src/features/library/`：馆藏管理卡片，提供下载状态实时监测及重新下载操作。
+- `src/features/reader/`：左右对齐的双分栏阅读器，内置划词高亮笔记及 LLM 重新翻译触发。
+- `src/types.ts`：全局 TypeScript 静态类型定义。
+
+---
+
+## 3. 生产构建 (Build)
+
+若需打包生成生产环境静态文件：
+```bash
+npm run build
+```
+打包文件将输出至当前目录下的 `dist/`，后端 Axum 在编译时会直接将其静态托管。
+
+---
+
+## 4. 开发规范 (Coding Standards)
+- 本模块的详细前端开发约定，请参阅本目录下的 [前端开发规范-React篇.md](前端开发规范-React篇.md)。