# free_navigation

**Repository Path**: freechatgpt/free_navigation

## Basic Information

- **Project Name**: free_navigation
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-11
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网站导航

一个简洁的个人书签管理工具，帮助您整理和快速访问常用网站。

## 功能特性

- 浏览导航 - 访问首页即可查看所有分类和网站
- 用户注册登录 - 注册账号管理自己的专属导航
- 分类管理 - 添加、删除、编辑分类
- 网站管理 - 添加、删除网站
- 拖拽排序 - 支持分类和网站的拖拽排序，支持跨分类拖拽
- 导出导入 - 支持导出/导入 Excel 数据
- 管理员功能 - 管理员可管理所有注册用户
- 默认数据 - 新用户自动复制默认导航配置

## 技术栈

- **前端**：React + Vite
- **后端**：Express.js
- **数据库**：SQLite

## 项目结构

```
free_navigation/
├── server/                 # 后端
│   ├── package.json
│   ├── server.js           # 主程序
│   └── navigation.db      # SQLite 数据库
│
├── client/                 # 前端
│   ├── package.json
│   ├── vite.config.js      # Vite 配置
│   ├── index.html
│   └── src/
│       ├── main.jsx        # 入口文件
│       ├── App.jsx        # 主组件
│       └── index.css      # 样式文件
│
├── 技术手册.md             # 技术文档
├── 用户使用手册.md         # 用户文档
└── README.md              # 项目说明
```

## 快速开始

### 环境要求

- Node.js >= 16

### 安装依赖

```bash
# 安装后端依赖
cd server
npm install

# 安装前端依赖
cd ../client
npm install
```

### 启动项目

```bash
# 启动后端 (端口 3001)
cd server
npm start

# 启动前端 (端口 5173)
cd ../client
npm run dev
```

访问 http://127.0.0.1:5173

## 默认数据

- 管理员账号：`admin` / `admin123`
- 默认分类：搜索引擎、社交媒体、AI 工具

## API 接口

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | /api/register | 用户注册 |
| POST | /api/login | 用户登录 |
| GET | /api/categories | 获取分类和网站列表 |
| POST | /api/categories | 添加分类 |
| PUT | /api/categories/:id | 更新分类 |
| DELETE | /api/categories/:id | 删除分类 |
| POST | /api/sites | 添加网站 |
| PUT | /api/sites/:id | 更新网站 |
| DELETE | /api/sites/:id | 删除网站 |
| GET | /api/export | 导出数据为 Excel |
| POST | /api/import | 导入 Excel 数据 |
| GET | /api/users | 获取用户列表（登录用户） |
| GET | /api/admin/users | 获取用户列表（管理员） |
| PUT | /api/admin/users/:id | 编辑用户（管理员） |
| DELETE | /api/admin/users/:id | 删除用户（管理员） |
| POST | /api/admin/users/:id/reset | 重置用户密码（管理员） |
| GET | /api/admin/users/:id/navigation | 查看用户导航配置（登录用户） |

## 许可证

MIT