wip: oci image management

frontend/README.md

@@ -0,0 +1,77 @@
+# Cluster Frontend
+
+基于 React + TypeScript + Zustand + MUI 的前端项目。
+
+## 技术栈
+
+- **React 18** - UI 框架
+- **TypeScript** - 类型系统
+- **Vite** - 构建工具
+- **Zustand** - 状态管理
+- **Material-UI (MUI)** - UI 组件库
+
+## 开发
+
+### 安装依赖
+
+```bash
+npm install
+# 或
+yarn install
+# 或
+pnpm install
+```
+
+### 启动开发服务器
+
+```bash
+npm run dev
+# 或
+yarn dev
+# 或
+pnpm dev
+```
+
+开发服务器将在 `http://localhost:3000` 启动。
+
+### 构建生产版本
+
+```bash
+npm run build
+# 或
+yarn build
+# 或
+pnpm build
+```
+
+### 预览生产构建
+
+```bash
+npm run preview
+# 或
+yarn preview
+# 或
+pnpm preview
+```
+
+## 项目结构
+
+```
+frontend/
+├── src/
+│   ├── stores/          # Zustand 状态管理
+│   ├── components/       # React 组件
+│   ├── theme.ts         # MUI 主题配置
+│   ├── App.tsx          # 主应用组件
+│   └── main.tsx         # 应用入口
+├── public/              # 静态资源
+├── index.html           # HTML 模板
+├── vite.config.ts       # Vite 配置
+└── tsconfig.json        # TypeScript 配置
+```
+
+## API 代理
+
+开发环境已配置 API 代理，所有 `/api/*` 请求会被代理到 `http://localhost:8080`（Go 后端服务）。
+
+配置位置：`vite.config.ts`