feat: 完成容器化系统和用户文档开发

本次提交包含3个重要功能的完成:

1. 📖 用户使用文档完成
   - 创建完整的用户使用手册 (docs/USER_MANUAL.md)
   - 管理后台使用指南 (登录、照片管理、分类管理)
   - 前端网站使用说明 (浏览、搜索、移动端)
   - 部署运维指南 (环境准备、监控维护)
   - 故障排查指南 (错误处理、性能优化)
   - 技术支持体系和问题反馈渠道

2. 🐳 后端Docker容器化完成
   - 多阶段构建Dockerfile (golang:1.23-alpine → scratch)
   - Docker Compose开发环境 (PostgreSQL + Redis + API)
   - 优化的构建配置和安全用户设置
   - 健康检查和环境变量管理
   - 更新Makefile添加Docker命令

3. 🏗️ 前端Docker容器化完成
   - 多阶段构建Dockerfile (node:20-alpine → nginx:1.25-alpine)
   - 集成bun包管理器优化构建速度
   - 优化的Nginx配置 (缓存、压缩、安全头部)
   - Docker Compose多模式支持 (开发/生产/代理)
   - 更新Makefile添加Docker命令

4. 📋 完整的Docker编排系统
   - 项目根目录完整的docker-compose.yml
   - 支持数据库、缓存、API、前端、管理后台的统一部署
   - 自动化Docker设置脚本 (docker-setup.sh)
   - 生产环境监控和日志收集配置

技术成果:
- 项目完成率从65.0%提升至72.5%
- 中优先级任务完成率达90%
- 低优先级任务开始推进(18%)
- 容器化部署体系完全就绪
- 用户文档体系建立完成

下一步: 继续推进容器化扩展和性能优化任务
This commit is contained in:
xujiang
2025-07-11 14:29:04 +08:00
parent c8b9049a9b
commit 6efccae78a
14 changed files with 2082 additions and 18 deletions

64
backend/Dockerfile Normal file
View File

@ -0,0 +1,64 @@
# Photography Portfolio Backend Dockerfile
# 多阶段构建,优化镜像大小和安全性
# Stage 1: 构建阶段
FROM golang:1.23-alpine AS builder
# 设置工作目录
WORKDIR /app
# 安装构建依赖
RUN apk add --no-cache git ca-certificates tzdata
# 复制 go mod 文件并下载依赖
COPY go.mod go.sum ./
RUN go mod download
# 复制源代码
COPY . .
# 构建应用程序
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
-ldflags='-w -s -extldflags "-static"' \
-a -installsuffix cgo \
-o photography-api \
./cmd/api/main.go
# 构建迁移工具
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
-ldflags='-w -s -extldflags "-static"' \
-a -installsuffix cgo \
-o migrate \
./cmd/migrate/main.go
# Stage 2: 运行阶段
FROM scratch
# 从builder阶段复制时区数据和CA证书
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
# 复制编译好的二进制文件
COPY --from=builder /app/photography-api /photography-api
COPY --from=builder /app/migrate /migrate
# 复制配置文件和脚本
COPY --from=builder /app/configs /configs
COPY --from=builder /app/scripts /scripts
COPY --from=builder /app/pkg/migration/migrations /pkg/migration/migrations
# 设置时区
ENV TZ=Asia/Shanghai
# 创建非root用户 (在scratch镜像中需要手动创建)
USER 65534:65534
# 暴露端口
EXPOSE 8080
# 健康检查
HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
CMD ["/photography-api", "--health-check"]
# 启动应用
ENTRYPOINT ["/photography-api"]