feat: 第二次优化迭代
- Links 后端分页+前端分页器 - 搜索关键词高亮(mark标签) - 搜索防抖200ms,支持描述搜索 - 移除不可用的 type-check 脚本 - 更新 README 项目文档
This commit is contained in:
@@ -1,62 +1,71 @@
|
||||
# yx-nav 网址导航
|
||||
# 言逍导航 (yx-nav)
|
||||
|
||||
## 项目简介
|
||||
|
||||
纯 Node.js 全栈实现的网址导航系统,包含前台展示页和后台管理面板。后台可配置前台的分类、网址、站点主题、布局模式等所有内容。
|
||||
精选实用网址导航系统,支持分类管理、搜索、后台管理。
|
||||
|
||||
## 技术栈
|
||||
|
||||
- **后端**: Node.js + Express + MySQL
|
||||
- **前端**: Vue 3 + TypeScript + Vite + Element Plus
|
||||
- **后端**: Node.js + Express + MySQL (110.42.189.169:9109)
|
||||
- **前端**: Vue 3.5 + TypeScript + Vite 6 + Element Plus
|
||||
- **部署**: Docker (端口 9110) + Jenkins CI
|
||||
|
||||
## 外部服务配置
|
||||
|
||||
| 服务 | 地址 | 账号 | 密码 |
|
||||
|------|------|------|------|
|
||||
| 数据库 (MySQL) | 110.42.189.169:9109 | yx-nav | yx-nav |
|
||||
| Jenkins (CI/CD) | 110.42.189.169:9101 | hermesagent | hermesagent |
|
||||
| Gitea (代码仓库) | 110.42.189.169:3000 | hermesagent/yx-nav | — |
|
||||
|
||||
## 默认登录
|
||||
|
||||
后台管理:`http://localhost:5173/admin/login`
|
||||
- 账号: `admin`
|
||||
- 密码: `admin123`
|
||||
|
||||
## 项目结构
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
backend/ # 后端 (Express + MySQL)
|
||||
src/
|
||||
index.js # 入口,启动 Express
|
||||
database.js # MySQL 连接池 + 表结构初始化
|
||||
middleware/auth.js # JWT 认证中间件
|
||||
routes/api.js # 全部 API 路由
|
||||
frontend/ # 前端 (Vue 3 + TS + Vite)
|
||||
src/
|
||||
views/
|
||||
Home.vue # 前台:分类导航 + 搜索
|
||||
admin/
|
||||
Login.vue # 后台登录
|
||||
AdminLayout.vue # 后台布局
|
||||
Dashboard.vue # 仪表盘
|
||||
Links.vue # 网址管理
|
||||
Categories.vue # 分类管理
|
||||
Settings.vue # 站点配置
|
||||
api/index.ts # API 封装
|
||||
stores/user.ts # 用户状态 (Pinia)
|
||||
yx-nav/
|
||||
├── backend/ # 后端服务
|
||||
│ ├── src/
|
||||
│ │ ├── index.js # 入口 + Express 配置
|
||||
│ │ ├── database.js # MySQL 连接 + 表初始化
|
||||
│ │ ├── middleware/auth.js # JWT 认证中间件
|
||||
│ │ └── routes/api.js # API 路由(公开 + 后台)
|
||||
│ └── package.json
|
||||
├── frontend/ # 前端应用
|
||||
│ ├── src/
|
||||
│ │ ├── views/ # 页面组件
|
||||
│ │ │ ├── Home.vue # 前台首页
|
||||
│ │ │ ├── NotFound.vue # 404 页面
|
||||
│ │ │ └── admin/ # 后台管理
|
||||
│ │ ├── api/index.ts # API 调用封装
|
||||
│ │ ├── router/index.ts # Vue Router 配置
|
||||
│ │ └── stores/user.ts # Pinia 用户状态
|
||||
│ ├── public/favicon.svg # 站点图标
|
||||
│ └── package.json
|
||||
└── build.sh # Jenkins 构建脚本
|
||||
```
|
||||
|
||||
## 运行
|
||||
## 本地开发
|
||||
|
||||
```bash
|
||||
# 后端
|
||||
cd backend && npm install && npm start # 监听 3000
|
||||
cd backend
|
||||
npm install
|
||||
npm run dev
|
||||
|
||||
# 前端
|
||||
cd frontend && npm install && npm run dev # 监听 5173,代理 /api → 后端
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
## Jenkins 发布
|
||||
前端运行在 5173 端口(自动代理 API 到 3000)。
|
||||
|
||||
推送代码到 `hermesagent/yx-nav` 后,在 Jenkins `http://110.42.189.169:9101/` 手动触发 `yx-nav` job 即可构建部署。
|
||||
## 部署
|
||||
|
||||
Jenkins 构建触发(需认证):
|
||||
|
||||
```bash
|
||||
curl -u hermesagent:hermesagent \
|
||||
"http://110.42.189.169:9101/job/yx-nav/build?token=yx-navbuild"
|
||||
```
|
||||
|
||||
## 默认管理员
|
||||
|
||||
- 用户名: `admin`
|
||||
- 密码: `qq755141`
|
||||
|
||||
## 服务地址
|
||||
|
||||
- 前台首页: http://110.42.189.169:9110/
|
||||
- 后台管理: http://110.42.189.169:9110/#/admin
|
||||
- MySQL: 110.42.189.169:9109 (yx-nav/yx-nav)
|
||||
- Jenkins: http://110.42.189.169:9101 (hermesagent/hermesagent)
|
||||
|
||||
Reference in New Issue
Block a user