feat: 实现后端和管理后台基础架构

## 后端架构 (Go + Gin + GORM)
-  完整的分层架构 (API/Service/Repository)
-  PostgreSQL数据库设计和迁移脚本
-  JWT认证系统和权限控制
-  用户、照片、分类、标签等核心模型
-  中间件系统 (认证、CORS、日志)
-  配置管理和环境变量支持
-  结构化日志和错误处理
-  Makefile构建和部署脚本

## 管理后台架构 (React + TypeScript)
-  Vite + React 18 + TypeScript现代化架构
-  路由系统和状态管理 (Zustand + TanStack Query)
-  基于Radix UI的组件库基础
-  认证流程和权限控制
-  响应式设计和主题系统

## 数据库设计
-  用户表 (角色权限、认证信息)
-  照片表 (元数据、EXIF、状态管理)
-  分类表 (层级结构、封面图片)
-  标签表 (使用统计、标签云)
-  关联表 (照片-标签多对多)

## 技术特点
- 🚀 高性能: Gin框架 + GORM ORM
- 🔐 安全: JWT认证 + 密码加密 + 权限控制
- 📊 监控: 结构化日志 + 健康检查
- 🎨 现代化: React 18 + TypeScript + Vite
- 📱 响应式: Tailwind CSS + Radix UI

参考文档: docs/development/saved-docs/
This commit is contained in:
xujiang
2025-07-09 14:56:22 +08:00
parent 180fbd2ae9
commit c57ec3aa82
34 changed files with 3432 additions and 0 deletions

View File

@ -0,0 +1,99 @@
package models
import (
"time"
"gorm.io/gorm"
)
// Photo 照片模型
type Photo struct {
ID uint `gorm:"primaryKey" json:"id"`
Title string `gorm:"size:255;not null" json:"title"`
Description string `gorm:"type:text" json:"description"`
Filename string `gorm:"size:255;not null" json:"filename"`
FilePath string `gorm:"size:500;not null" json:"file_path"`
FileSize int64 `json:"file_size"`
MimeType string `gorm:"size:100" json:"mime_type"`
Width int `json:"width"`
Height int `json:"height"`
CategoryID uint `json:"category_id"`
Category *Category `gorm:"foreignKey:CategoryID" json:"category,omitempty"`
Tags []Tag `gorm:"many2many:photo_tags;" json:"tags,omitempty"`
EXIF string `gorm:"type:jsonb" json:"exif"`
TakenAt *time.Time `json:"taken_at"`
Location string `gorm:"size:255" json:"location"`
IsPublic bool `gorm:"default:true" json:"is_public"`
Status string `gorm:"size:20;default:draft" json:"status"`
ViewCount int `gorm:"default:0" json:"view_count"`
LikeCount int `gorm:"default:0" json:"like_count"`
UserID uint `gorm:"not null" json:"user_id"`
User *User `gorm:"foreignKey:UserID" json:"user,omitempty"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
DeletedAt gorm.DeletedAt `gorm:"index" json:"-"`
}
// TableName 返回照片表名
func (Photo) TableName() string {
return "photos"
}
// PhotoStatus 照片状态常量
const (
StatusDraft = "draft"
StatusPublished = "published"
StatusArchived = "archived"
)
// CreatePhotoRequest 创建照片请求
type CreatePhotoRequest struct {
Title string `json:"title" binding:"required,max=255"`
Description string `json:"description"`
CategoryID uint `json:"category_id" binding:"required"`
TagIDs []uint `json:"tag_ids"`
TakenAt *time.Time `json:"taken_at"`
Location string `json:"location" binding:"max=255"`
IsPublic *bool `json:"is_public"`
Status string `json:"status" binding:"omitempty,oneof=draft published archived"`
}
// UpdatePhotoRequest 更新照片请求
type UpdatePhotoRequest struct {
Title *string `json:"title" binding:"omitempty,max=255"`
Description *string `json:"description"`
CategoryID *uint `json:"category_id"`
TagIDs []uint `json:"tag_ids"`
TakenAt *time.Time `json:"taken_at"`
Location *string `json:"location" binding:"omitempty,max=255"`
IsPublic *bool `json:"is_public"`
Status *string `json:"status" binding:"omitempty,oneof=draft published archived"`
}
// PhotoListParams 照片列表查询参数
type PhotoListParams struct {
Page int `form:"page,default=1" binding:"min=1"`
Limit int `form:"limit,default=20" binding:"min=1,max=100"`
CategoryID uint `form:"category_id"`
TagID uint `form:"tag_id"`
UserID uint `form:"user_id"`
Status string `form:"status" binding:"omitempty,oneof=draft published archived"`
Search string `form:"search"`
SortBy string `form:"sort_by,default=created_at" binding:"omitempty,oneof=created_at taken_at title view_count like_count"`
SortOrder string `form:"sort_order,default=desc" binding:"omitempty,oneof=asc desc"`
Year int `form:"year"`
Month int `form:"month" binding:"min=1,max=12"`
}
// PhotoResponse 照片响应
type PhotoResponse struct {
*Photo
ThumbnailURLs map[string]string `json:"thumbnail_urls,omitempty"`
}
// PhotoListResponse 照片列表响应
type PhotoListResponse struct {
Photos []PhotoResponse `json:"photos"`
Total int64 `json:"total"`
Page int `json:"page"`
Limit int `json:"limit"`
}