# OPS 资源中心

一个现代化的内部资源管理门户，用于集中管理运维命令、文档、链接和文件。

## 功能特性

### 门户展示
- 🎨 现代化响应式设计
- 🔍 全局搜索功能，支持按 `/` 快捷键搜索
- 🏷️ 多维度分类筛选
- 📋 资源卡片展示，支持一键复制命令
- 🔗 右侧快捷链接栏

### 管理后台
- 📊 数据仪表盘
- 📁 分类管理（支持排序、分面选项）
- 📄 资源管理（支持 4 种类型：命令/链接/文档/文件）
- 📎 文件上传功能
- 🔗 侧栏链接管理
- ⚙️ 站点设置（标题、副标题、公告等）
- 👥 用户管理（创建、重置密码、删除）

## 技术栈

### 后端
- **Flask** - Web 框架
- **Flask-SQLAlchemy** - ORM
- **SQLite** - 数据库
- **JWT** - 身份认证
- **bcrypt** - 密码加密

### 前端
- **Vue 3** - 前端框架
- **Element Plus** - UI 组件库
- **Vite** - 构建工具
- **Axios** - HTTP 客户端

## 快速开始

### 环境要求
- Python 3.8+
- Node.js 16+

### 后端启动

```bash
cd backend

# 安装依赖
pip install -r requirements.txt

# 启动服务（开发模式）
python app.py
```

服务将在 `http://localhost:8090` 启动

### 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建生产版本
npm run build
```

## 默认账号

- 用户名: `admin`
- 密码: `admin123`

## 项目结构

```
ops-manager/
├── backend/                 # 后端服务
│   ├── app.py              # 应用入口
│   ├── config.py           # 配置文件
│   ├── models.py           # 数据模型
│   ├── auth.py             # 认证相关
│   ├── routes/             # API 路由
│   │   ├── portal.py       # 门户公开 API
│   │   ├── admin.py        # 管理后台 API
│   │   └── auth.py         # 认证 API
│   ├── instance/           # 数据库文件（自动创建）
│   ├── uploads/            # 上传文件目录（自动创建）
│   └── requirements.txt    # Python 依赖
└── frontend/               # 前端应用
    ├── src/
    │   ├── views/          # 页面组件
    │   │   ├── Portal.vue  # 门户首页
    │   │   └── admin/      # 管理后台页面
    │   ├── api/index.js    # API 封装
    │   ├── router/         # 路由配置
    │   └── styles/         # 样式文件
    ├── dist/               # 构建产物（自动创建）
    └── package.json
```

## 资源类型

1. **命令 (command)** - 可一键复制的 Shell 命令
2. **链接 (link)** - 内部/外部链接跳转
3. **文档 (text)** - 富文本说明文档
4. **文件 (file)** - 可下载的文件资源

## 环境变量

| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| `OPS_SECRET_KEY` | JWT 加密密钥 | `ops-portal-dev-secret-change-me-32b!` |
| `OPS_DATABASE_URL` | 数据库连接字符串 | `sqlite:///instance/ops_portal.db` |
| `OPS_JWT_EXPIRE_HOURS` | JWT 过期时间（小时） | `12` |
| `OPS_UPLOAD_DIR` | 文件上传目录 | `backend/uploads` |
| `OPS_UPLOAD_URL_PREFIX` | 文件访问 URL 前缀 | `/uploads` |

## 部署建议

1. **生产环境**使用 Gunicorn 或 uWSGI 部署后端
2. 使用 Nginx 反向代理前端静态文件和 API
3. 配置环境变量 `OPS_SECRET_KEY` 为强随机字符串
4. 定期备份 SQLite 数据库文件

## 开发

### 添加新的资源类型

1. 在 `backend/models.py` 中更新 `Resource` 模型（如果需要）
2. 在 `backend/routes/admin.py` 中更新 `RESOURCE_TYPES` 和验证逻辑
3. 在前端 `Resources.vue` 中添加对应展示样式
4. 在门户 `Portal.vue` 中添加 badge 样式

### 自定义主题

主要样式变量定义在 `frontend/src/styles/portal.css` 的 `:root` 块中：

```css
:root {
  --ink: #0a1424;        /* 主深色 */
  --cyan: #2dd9f0;       /* 主青色 */
  --red: #e5484d;        /* 主红色 */
  --paper: #f2f5f9;      /* 背景色 */
  /* ... */
}
```

## License

MIT