commit 4cfaf21b2299cbfef83e4d11bcece83ac1c4f702
Author: hangyu.tao <hangyu.tao@d-robotics.cc>
Date:   Wed May 6 19:43:57 2026 +0800

    first commit

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..af56077
--- /dev/null
+++ b/README.md
@@ -0,0 +1,83 @@
+# QuantumTest 测试用例管理平台
+
+## 项目目录结构
+
+```
+用例管理平台/
+├── backend/                     # Python 后端 (FastAPI + SQLite)
+│   ├── database.py              # 数据库连接配置（SQLite/MySQL 可切换）
+│   ├── models.py                # SQLAlchemy ORM 数据模型
+│   ├── main.py                  # FastAPI 路由 & 应用入口
+│   ├── seed.py                  # 初始化种子数据脚本
+│   └── quantum_test.db          # 本地 SQLite 数据库文件
+│
+├── src/                         # 前端 (React + TypeScript + Vite)
+│   ├── main.tsx                 # 应用入口
+│   ├── App.tsx                  # 根组件，路由/视图切换
+│   ├── App.css / index.css      # 全局样式
+│   ├── user.json                # 用户名 & 飞书 OpenID 映射表
+│   │
+│   ├── store/
+│   │   └── useStore.ts          # Zustand 全局状态（含 localStorage 持久化）
+│   │
+│   └── components/
+│       ├── auth/                # 认证模块
+│       │   └── LoginPage.tsx    # 登录页（用户名/密码校验）
+│       │
+│       ├── layout/              # 布局 & 导航
+│       │   ├── Sidebar.tsx      # 左侧导航栏
+│       │   └── Toast.tsx        # 全局消息通知
+│       │
+│       ├── editor/              # 核心用例编辑器
+│       │   ├── TableView.tsx    # 用例列表视图（表格 + 脑图双模式）
+│       │   ├── MindMapView.tsx  # 脑图视图（ReactFlow）
+│       │   ├── PropertyPanel.tsx # 右侧属性面板（详情/步骤编辑）
+│       │   ├── UserMentionInput.tsx # @提及用户输入组件
+│       │   └── ImportModal.tsx  # AI 智能图片解析导入弹窗
+│       │
+│       ├── plans/               # 测试计划 & 执行
+│       │   ├── PlanListView.tsx # 测试计划列表（创建/筛选/查看）
+│       │   └── TaskExecutionView.tsx # 测试任务执行视图（列表/脑图双模式）
+│       │
+│       └── shared/              # 跨域通用视图
+│           ├── DashboardView.tsx # 数据概览仪表盘
+│           └── BugView.tsx      # 缺陷列表
+│
+├── public/                      # 静态资源
+├── index.html                   # HTML 入口
+├── package.json
+├── vite.config.ts
+└── tsconfig.json
+```
+
+## 技术栈
+
+| 层级 | 技术 |
+|------|------|
+| 前端框架 | React 18 + TypeScript |
+| 构建工具 | Vite |
+| 状态管理 | Zustand（with localStorage persist） |
+| 脑图渲染 | ReactFlow |
+| 图标库 | lucide-react |
+| 后端框架 | FastAPI |
+| 数据库 | SQLite（可切换 MySQL） |
+| ORM | SQLAlchemy |
+
+## 快速启动
+
+```bash
+# 前端
+npm install
+npm run dev
+
+# 后端（可选）
+cd backend
+pip install -r requirements.txt
+uvicorn main:app --reload
+```
+
+## 账号体系
+
+- 账号来源：`src/user.json`（姓名 → 飞书 OpenID 映射）
+- 默认密码：`admin123`
+- 登录状态通过 localStorage 持久化，刷新免登录
\ No newline at end of file