logo
0
0
WeChat Login

资源管理工具

一个多分类资源管理平台,支持本地文件和外部链接的管理、分类和访问。

功能特点

  • 多级分类管理
  • 支持本地文件和外部链接
  • 资源预览功能
  • 便捷的资源访问方式
  • 响应式界面设计

技术栈

前端

  • Vue 3 + Composition API
  • Element Plus UI组件库
  • Vue Router 路由管理
  • Pinia 状态管理
  • Axios HTTP客户端

后端

  • FastAPI Python框架
  • SQLite 轻量级数据库
  • SQLAlchemy ORM (可选)
  • Uvicorn ASGI服务器

项目结构

resource-manager/
├── frontend/           # Vue前端项目
│   ├── public/         # 静态资源
│   ├── src/            # 源代码
│   │   ├── assets/     # 资源文件
│   │   ├── components/ # 组件
│   │   ├── router/     # 路由配置
│   │   ├── stores/     # Pinia状态管理
│   │   ├── views/      # 视图组件
│   │   ├── App.vue     # 根组件
│   │   └── main.js     # 入口文件
│   └── package.json    # 依赖配置
├── backend/            # FastAPI后端项目
│   ├── app/            # 应用代码
│   │   ├── core/       # 核心配置
│   │   ├── db/         # 数据库相关
│   │   ├── models/     # 数据模型
│   │   ├── routes/     # API路由
│   │   ├── schemas/    # Pydantic模型
│   │   └── main.py     # 应用入口
│   ├── static/         # 静态文件
│   └── requirements.txt # Python依赖
└── README.md           # 项目文档

安装与运行

前提条件

  • Node.js 16+
  • Python 3.8+
  • npm 或 yarn

后端设置

  1. 创建并激活Python虚拟环境(可选但推荐)
# Windows
python -m venv venv
venv\Scripts\activate

# macOS/Linux
python3 -m venv venv
source venv/bin/activate
  1. 安装Python依赖
cd backend
pip install -r requirements.txt
  1. 运行后端服务
cd backend
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

后端API将在 http://localhost:8000 上运行,API文档可在 http://localhost:8000/docs 访问。

前端设置

  1. 安装Node.js依赖
cd frontend
npm install
# 或
yarn install
  1. 运行开发服务器
npm run dev
# 或
yarn dev

前端应用将在 http://localhost:5173 上运行。

生产构建

  1. 构建前端
cd frontend
npm run build
# 或
yarn build
  1. 部署后端
cd backend
uvicorn app.main:app --host 0.0.0.0 --port 8000

使用指南

分类管理

  1. 点击左侧菜单的"分类管理"
  2. 使用"添加分类"按钮创建新分类
  3. 可以编辑或删除现有分类

资源管理

  1. 点击左侧菜单的"资源管理"
  2. 使用"添加资源"按钮添加新资源
  3. 选择资源类型(本地文件或外部链接)
  4. 填写必要信息并提交
  5. 在资源列表中可以查看、访问或删除资源

开发计划

  • 基础框架搭建
  • 分类管理功能
  • 资源管理功能
  • 用户认证系统
  • 批量导入功能
  • 高级搜索功能
  • AI分类功能
  • MCP功能
  • 题库功能
  • 云同步功能

贡献指南

  1. Fork 项目
  2. 创建特性分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add some amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 创建Pull Request

许可证

MIT

About

一个多分类资源管理平台,支持本地文件和外部链接的管理、分类和访问。

Language
Vue42.4%
Python16.4%
Markdown12.5%
Batch8.9%
Others19.8%