# work-navigation

**Repository Path**: eluup/work-navigation

## Basic Information

- **Project Name**: work-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**: 2025-09-12
- **Last Updated**: 2025-09-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人导航服务

一个基于Golang的现代化个人导航服务，提供RESTful API和Web界面，帮助您快速访问常用的工具和平台。

## 功能特性

- 🎨 **现代化设计** - 采用渐变背景和毛玻璃效果
- 📱 **响应式布局** - 支持桌面和移动设备
- 🔍 **智能搜索** - 支持按名称和描述搜索
- ⭐ **收藏功能** - 收藏常用工具，快速访问
- 🌙 **深色主题** - 支持明暗主题切换
- 📊 **统计信息** - 显示工具总数、分类数等统计
- 🚀 **RESTful API** - 提供完整的API接口
- 💾 **数据持久化** - 收藏和主题设置自动保存
- 🔄 **实时更新** - 支持动态数据更新

## 文件结构

```
tools/
├── main.go                 # Golang服务主文件
├── go.mod                  # Go模块依赖
├── config.yaml             # 服务配置文件
├── navigation-data.json    # 数据配置文件
├── templates/
│   └── index.html         # Web页面模板
├── start.sh               # 启动脚本
├── API.md                 # API文档
└── README.md              # 使用说明
```

## 快速开始

### 1. 环境要求

- Go 1.21 或更高版本
- 现代浏览器（Chrome 60+, Firefox 55+, Safari 12+, Edge 79+）

### 2. 启动服务

```bash
# 进入项目目录
cd tools

# 启动服务
./start.sh

# 或者手动启动
go run main.go
```

### 3. 访问服务

- **Web界面**: http://localhost:8080
- **API接口**: http://localhost:8080/api

### 4. 使用功能

- 使用搜索框快速查找工具
- 点击工具右上角的⭐来收藏/取消收藏
- 点击右上角的🌙/☀️切换主题
- 通过API接口进行数据操作

## 自定义配置

所有数据都存储在 `navigation-data.json` 文件中，您可以：

### 添加新工具
在对应分类的 `items` 数组中添加新对象：
```json
{
  "name": "工具名称",
  "url": "https://example.com",
  "description": "工具描述",
  "icon": "🔧"
}
```

### 添加新分类
在 `categories` 数组中添加新分类：
```json
{
  "id": "category-id",
  "name": "分类名称",
  "icon": "🏢",
  "color": "#3B82F6",
  "items": []
}
```

### 修改设置
在 `settings` 对象中调整页面设置：
```json
{
  "theme": "light",
  "layout": "grid",
  "showDescriptions": true,
  "enableSearch": true,
  "enableFavorites": true
}
```

## 分类说明

- **公司平台** - Git、Jenkins、Jira等公司内部工具
- **个人需求绩效** - OKR、绩效管理、需求跟踪等
- **开发工具** - GitHub、VS Code、Postman等开发相关工具
- **监控平台** - Grafana、Prometheus、ELK等监控工具
- **数据库平台** - MySQL、Redis、MongoDB等数据库管理工具
- **环境管理** - 开发、测试、预生产、生产环境入口
- **个人资源** - 网盘、笔记、密码管理等个人工具

## API 接口

服务提供完整的RESTful API接口，支持：

- `GET /api/navigation` - 获取完整导航数据
- `GET /api/categories` - 获取所有分类
- `GET /api/categories/{id}` - 获取特定分类
- `GET /api/search?q={query}` - 搜索项目
- `POST /api/favorites` - 添加收藏
- `DELETE /api/favorites/{name}` - 移除收藏
- `GET /api/favorites` - 获取收藏列表
- `POST /api/recently-used` - 记录最近使用
- `GET /api/stats` - 获取统计信息

详细的API文档请参考 [API.md](API.md)

## 技术特性

- **后端**: Golang + Gin框架
- **前端**: 现代HTML5/CSS3/JavaScript
- **数据格式**: JSON
- **API设计**: RESTful风格
- **响应式设计**: 支持桌面和移动设备
- **主题切换**: 明暗主题支持
- **实时搜索**: 客户端实时搜索过滤
- **数据持久化**: 收藏和设置本地存储

## 部署说明

### 开发环境
```bash
go run main.go
```

### 生产环境
```bash
# 编译
go build -o navigation-service main.go

# 运行
./navigation-service
```

### Docker部署
```dockerfile
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go mod tidy && go build -o navigation-service main.go

FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY --from=builder /app/navigation-service .
COPY --from=builder /app/navigation-data.json .
COPY --from=builder /app/templates ./templates
EXPOSE 8080
CMD ["./navigation-service"]
```

## 更新日志

### v2.0.0
- 重构为Golang服务架构
- 添加RESTful API接口
- 支持动态数据更新
- 改进错误处理和日志记录
- 添加配置文件和启动脚本

### v1.0.0
- 初始版本发布
- 支持7个主要分类
- 实现搜索、收藏、主题切换功能
- 响应式设计