Skip to content

feat: v2 refactor - migrate to Hertz backend and Vue 3 frontend #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
zy84338719 merged 7 commits into from
Mar 11, 2026
Merged

feat: v2 refactor - migrate to Hertz backend and Vue 3 frontend #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
7f3cc2a
feat: v2 refactor - migrate to Hertz backend and Vue 3 frontend
zy84338719 Mar 11, 2026
110f699
fix: 修复CI工作流配置并统一端口为12345
zy84338719 Mar 11, 2026
6b5c5f5
fix: 更新golangci-lint版本并移除handler.bak目录
zy84338719 Mar 11, 2026
068e586
fix: 升级golangci-lint-action到v7并修复maintenance handler类型引用
zy84338719 Mar 11, 2026
35dcb3b
refactor: migrate biz to gen, split IDL by domain with independent go…
zy84338719 Mar 11, 2026
b2f4a01
fix: 添加 golangci-lint v2 配置版本声明
zy84338719 Mar 11, 2026
87d14f5
fix: CI集成测试前创建data目录以修复SQLite初始化失败
zy84338719 Mar 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
20 changes: 13 additions & 7 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,13 @@ jobs:
with:
go-version: ${{ matrix.go-version }}
cache: true
cache-dependency-path: |
go.sum
go.mod
cache-dependency-path: backend/go.sum

- name: Download dependencies
run: make deps

- name: Verify dependencies
working-directory: backend
run: go mod verify

- name: Run checks
Expand All @@ -45,7 +44,7 @@ jobs:
if: matrix.go-version == '1.25'
uses: codecov/codecov-action@v4
with:
file: ./coverage.out
file: ./backend/coverage.out
flags: unittests
name: codecov-umbrella
fail_ci_if_error: false
Expand All @@ -55,9 +54,12 @@ jobs:

- name: Run integration tests
run: |
# 创建必要的目录
mkdir -p backend/data/uploads

# 构建并启动服务
make build
./filecodebox &
cd backend && ./bin/server &
SERVER_PID=$!

# 等待服务启动
Expand Down Expand Up @@ -93,11 +95,13 @@ jobs:
with:
go-version: '1.25'
cache: true
cache-dependency-path: backend/go.sum

- name: golangci-lint
uses: golangci/golangci-lint-action@v6
uses: golangci/golangci-lint-action@v7
with:
version: latest
version: v2.11.3
working-directory: backend
args: --timeout=5m

docker-test:
Expand Down Expand Up @@ -173,6 +177,8 @@ jobs:
uses: actions/setup-go@v5
with:
go-version: '1.25'
cache: true
cache-dependency-path: backend/go.sum

- name: Run Basic Security Checks
run: |
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/release.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ jobs:
#### 方式四：源码编译

\`\`\`bash
git clone https://github.com/zy84338719/filecodebox.git
git clone https://github.com/zy84338719/fileCodeBox/backend.git
cd filecodebox
git checkout $CURRENT_TAG
make build
Expand Down
150 changes: 150 additions & 0 deletions API-COMPARISON.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,150 @@
# API 完整性对比报告

## 对比日期: 2026-03-11

---

## 新项目已实现的 API

### ✅ 用户模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| POST /user/register | ✅ | ✅ | 完整 |
| POST /user/login | ✅ | ✅ | 完整 |
| GET /user/info | ✅ | ✅ | 完整 |
| PUT /user/profile | ✅ | ✅ | 完整 |
| POST /user/change-password | ✅ | ✅ | 完整 |
| GET /user/stats | ✅ | ✅ | 完整 |
| GET /user/files | ✅ | ✅ | 完整 |
| DELETE /user/files/:code | ✅ | ⚠️ | 需验证 |
| GET /user/api-keys | ✅ | ✅ | 完整 |
| POST /user/api-keys | ✅ | ✅ | 完整 |
| DELETE /user/api-keys/:id | ✅ | ✅ | 完整 |
| POST /user/logout | ✅ | ❌ | 缺失 |
| GET /user/check-auth | ✅ | ❌ | 缺失 |

### ✅ 管理员模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| POST /admin/login | ✅ | ✅ | 完整 |
| GET /admin/stats | ✅ | ✅ | 完整 |
| GET /admin/dashboard | ✅ | ⚠️ | 复用 stats |
| GET /admin/files | ✅ | ✅ | 完整 |
| DELETE /admin/files/:id | ✅ | ✅ | 完整 |
| PUT /admin/files/:id | ✅ | ❌ | 缺失 |
| GET /admin/files/:id | ✅ | ❌ | 缺失 |
| GET /admin/files/download | ✅ | ❌ | 缺失 |
| GET /admin/users | ✅ | ✅ | 完整 |
| GET /admin/users/:id | ✅ | ❌ | 缺失 |
| POST /admin/users | ✅ | ❌ | 缺失 |
| PUT /admin/users/:id | ✅ | ❌ | 缺失 |
| DELETE /admin/users/:id | ✅ | ❌ | 缺失 |
| PUT /admin/users/:id/status | ✅ | ✅ | 完整 |
| POST /admin/users/batch-* | ✅ | ❌ | 缺失 |
| GET /admin/config | ✅ | ✅ | 完整 |
| PUT /admin/config | ✅ | ✅ | 完整 |

### ✅ 存储模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| GET /admin/storage | ✅ | ✅ | 完整 |
| POST /admin/storage/switch | ✅ | ✅ | 完整 |
| GET /admin/storage/test/:type | ✅ | ✅ | 完整 |
| PUT /admin/storage/config | ✅ | ✅ | 完整 |

### ✅ 维护模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| POST /admin/maintenance/clean-expired | ✅ | ✅ | 完整 |
| POST /admin/maintenance/clean-temp | ✅ | ✅ | 完整 |
| GET /admin/maintenance/system-info | ✅ | ✅ | 完整 |
| GET /admin/maintenance/monitor/storage | ✅ | ✅ | 完整 |
| GET /admin/maintenance/logs | ✅ | ✅ | 完整 |
| POST /admin/maintenance/db/backup | ✅ | ❌ | 缺失 |
| POST /admin/maintenance/db/optimize | ✅ | ❌ | 缺失 |
| POST /admin/maintenance/cache/clear-* | ✅ | ❌ | 缺失 |
| POST /admin/maintenance/security/scan | ✅ | ❌ | 缺失 |

### ✅ 分享模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| POST /share/text/ | ✅ | ✅ | 完整 |
| POST /share/file/ | ✅ | ✅ | 完整 |
| GET /share/select/ | ✅ | ✅ | 完整 |
| POST /share/select/ | ✅ | ✅ | 完整 |
| GET /share/download | ✅ | ✅ | 完整 |

### ✅ 分片上传模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| POST /chunk/upload/init | ✅ | ✅ | 完整 |
| POST /chunk/upload/chunk | ✅ | ✅ | 完整 |
| POST /chunk/upload/complete | ✅ | ✅ | 完整 |
| GET /chunk/upload/status | ✅ | ✅ | 完整 |
| DELETE /chunk/upload/cancel | ✅ | ✅ | 完整 |

### ✅ 其他模块
| API | 老项目 | 新项目 | 状态 |
|-----|--------|--------|------|
| GET /health | ✅ | ✅ | 完整 |
| GET /setup/check | ✅ | ✅ | 完整 |
| POST /setup | ✅ | ✅ | 完整 |
| POST /qrcode/generate | ✅ | ✅ | 完整 |
| GET /qrcode/:id | ✅ | ✅ | 完整 |

---

## 缺失的高优先级 API

### P0 - 核心功能 (影响基本使用)
- ❌ **POST /user/logout** - 用户登出
- ❌ **GET /user/check-auth** - 检查认证状态

### P1 - 管理功能 (影响后台管理)
- ❌ **GET/POST/PUT/DELETE /admin/users/:id** - 用户 CRUD
- ❌ **PUT /admin/files/:id** - 文件更新
- ❌ **GET /admin/logs/transfer** - 传输日志

### P2 - 高级功能 (可后续补充)
- ❌ **MCP 协议支持** - AI 集成
- ❌ **批量操作 API** - batch-delete/enable/disable
- ❌ **数据库维护** - backup/optimize
- ❌ **安全扫描** - security/scan

---

## 前端 API 对接状态

### 已匹配
- ✅ /user/login, /user/register
- ✅ /admin/login, /admin/stats
- ✅ /share/text/, /share/file/, /share/select/
- ✅ /admin/storage, /admin/maintenance/*

### 需前端调整
- ⚠️ /user/profile → /user/info
- ⚠️ /user/files → /share/user
- ⚠️ /user/files/:code → /share/:code

---

## 建议优先补充

1. **POST /user/logout** - 简单，影响用户体验
2. **GET /user/check-auth** - 简单，前端需要
3. **GET /admin/logs/transfer** - 管理后台需要
4. **用户 CRUD** - 管理后台核心功能

---

## 总体评估

| 类别 | 完成度 |
|------|--------|
| 核心功能 | 95% |
| 管理功能 | 80% |
| 维护功能 | 70% |
| 高级功能 | 40% |
| **总体** | **85%** |

**结论**: 核心功能基本完整，可进入测试阶段。缺失功能可在后续迭代补充。
71 changes: 55 additions & 16 deletions Dockerfile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,28 +1,59 @@
# 多阶段构建：第一阶段用于编译
FROM golang:1.24-alpine AS builder
# 多阶段构建 FileCodeBox v2
# Stage 1: 构建前端
FROM node:20-alpine AS frontend-builder

WORKDIR /frontend

# 复制前端依赖文件
COPY frontend/package*.json ./

# 安装依赖
RUN npm ci

# 复制前端源代码
COPY frontend/ ./

# 构建前端
RUN npm run build

# Stage 2: 构建后端
FROM golang:1.25-alpine AS backend-builder

# 安装构建依赖
RUN apk add --no-cache \
gcc \
musl-dev \
sqlite-dev \
git \
ca-certificates
ca-certificates \
tzdata

WORKDIR /app

# 复制依赖文件并下载依赖
COPY go.mod go.sum ./
# 复制后端依赖文件
COPY backend/go.mod backend/go.sum ./

# 下载依赖
RUN go mod download

# 复制源代码
COPY . .
# 复制后端源代码
COPY backend/ ./

# 构建参数
ARG VERSION=dev
ARG COMMIT=unknown
ARG BUILD_TIME=unknown

# 编译应用程序
RUN CGO_ENABLED=1 go build -ldflags="-w -s" -o filecodebox .
# 编译后端
RUN CGO_ENABLED=1 go build \
-ldflags="-w -s \
-X 'github.com/zy84338719/fileCodeBox/backend/internal/models/service.Version=${VERSION}' \
-X 'github.com/zy84338719/fileCodeBox/backend/internal/models/service.GitCommit=${COMMIT}' \
-X 'github.com/zy84338719/fileCodeBox/backend/internal/models/service.BuildTime=${BUILD_TIME}'" \
-o bin/server ./cmd/server
Comment on lines +47 to +53
Copy link

Copilot AI Mar 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This Dockerfile builds with CGO_ENABLED=1 but the runtime stage is a minimal Alpine image; if the binary ends up dynamically linked, it may fail at runtime due to missing libs. Unless CGO is required, prefer CGO_ENABLED=0 for a fully static binary (and keep consistent with backend/Dockerfile which already does that).

Copilot uses AI. Check for mistakes.

# 第二阶段：运行时镜像
FROM alpine:latest
# Stage 3: 运行时镜像
FROM alpine:3.19

# 安装运行时依赖
RUN apk --no-cache add \
Expand All @@ -36,16 +67,24 @@ RUN addgroup -g 1000 app && \

WORKDIR /app

# 从构建阶段复制文件
COPY --from=builder /app/filecodebox .
COPY --from=builder /app/themes ./themes
# 从后端构建阶段复制二进制文件
COPY --from=backend-builder /app/bin/server ./

# 从前端构建阶段复制静态文件
COPY --from=frontend-builder /frontend/dist ./static/

# 创建数据目录并设置权限
RUN mkdir -p data && chown -R app:app /app
RUN mkdir -p data configs && chown -R app:app /app

# 切换到非root用户
USER app

# 暴露端口
EXPOSE 12345

CMD ["./filecodebox"]
# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD wget --no-verbose --tries=1 --spider http://localhost:12345/health || exit 1

# 启动服务
CMD ["./server"]
Loading
Loading