Files
yx-nav/README.md
T

63 lines
1.8 KiB
Markdown

# yx-nav 网址导航
## 项目简介
纯 Node.js 全栈实现的网址导航系统,包含前台展示页和后台管理面板。后台可配置前台的分类、网址、站点主题、布局模式等所有内容。
## 技术栈
- **后端**: Node.js + Express + MySQL
- **前端**: Vue 3 + TypeScript + Vite + Element Plus
## 外部服务配置
| 服务 | 地址 | 账号 | 密码 |
|------|------|------|------|
| 数据库 (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)
```
## 运行
```bash
# 后端
cd backend && npm install && npm start # 监听 3000
# 前端
cd frontend && npm install && npm run dev # 监听 5173,代理 /api → 后端
```
## Jenkins 发布
推送代码到 `hermesagent/yx-nav` 后,在 Jenkins `http://110.42.189.169:9101/` 手动触发 `yx-nav` job 即可构建部署。