refactor: 重构后端架构为 go-zero 框架，优化项目结构
主要变更: - 采用 go-zero 框架替代 Gin，提升开发效率 - 重构项目结构，API 文件模块化组织 - 将 model 移至 api/internal/model 目录 - 移除 common 包，改为标准 pkg 目录结构 - 实现统一的仓储模式，支持配置驱动数据库切换 - 简化测试策略，专注 API 集成测试 - 更新 CLAUDE.md 文档，提供详细的开发指导 技术栈更新: - 框架: Gin → go-zero v1.6.0+ - 代码生成: 引入 goctl 工具 - 架构模式: 四层架构 → go-zero 三层架构 (Handler→Logic→Model) - 项目布局: 遵循 Go 社区标准和 go-zero 最佳实践
This commit is contained in:
xujiang
@ -1,64 +0,0 @@
|
||||
-- +migrate Up
|
||||
|
||||
CREATE TABLE photos (
|
||||
id SERIAL PRIMARY KEY,
|
||||
title VARCHAR(200) NOT NULL,
|
||||
description TEXT,
|
||||
filename VARCHAR(255) NOT NULL,
|
||||
original_url VARCHAR(500) NOT NULL,
|
||||
thumbnail_url VARCHAR(500),
|
||||
medium_url VARCHAR(500),
|
||||
large_url VARCHAR(500),
|
||||
file_size BIGINT,
|
||||
mime_type VARCHAR(100),
|
||||
width INTEGER,
|
||||
height INTEGER,
|
||||
camera_make VARCHAR(100),
|
||||
camera_model VARCHAR(100),
|
||||
lens_model VARCHAR(100),
|
||||
focal_length DECIMAL(5,2),
|
||||
aperture DECIMAL(3,1),
|
||||
shutter_speed VARCHAR(20),
|
||||
iso INTEGER,
|
||||
taken_at TIMESTAMP,
|
||||
location_name VARCHAR(200),
|
||||
latitude DECIMAL(10,8),
|
||||
longitude DECIMAL(11,8),
|
||||
user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
album_id INTEGER,
|
||||
category_id INTEGER,
|
||||
is_public BOOLEAN DEFAULT true,
|
||||
is_featured BOOLEAN DEFAULT false,
|
||||
view_count INTEGER DEFAULT 0,
|
||||
like_count INTEGER DEFAULT 0,
|
||||
download_count INTEGER DEFAULT 0,
|
||||
sort_order INTEGER DEFAULT 0,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
deleted_at TIMESTAMP
|
||||
);
|
||||
|
||||
-- 创建索引
|
||||
CREATE INDEX idx_photos_user_id ON photos(user_id);
|
||||
CREATE INDEX idx_photos_album_id ON photos(album_id);
|
||||
CREATE INDEX idx_photos_category_id ON photos(category_id);
|
||||
CREATE INDEX idx_photos_is_public ON photos(is_public);
|
||||
CREATE INDEX idx_photos_is_featured ON photos(is_featured);
|
||||
CREATE INDEX idx_photos_taken_at ON photos(taken_at);
|
||||
CREATE INDEX idx_photos_created_at ON photos(created_at);
|
||||
CREATE INDEX idx_photos_view_count ON photos(view_count);
|
||||
CREATE INDEX idx_photos_like_count ON photos(like_count);
|
||||
CREATE INDEX idx_photos_sort_order ON photos(sort_order);
|
||||
CREATE INDEX idx_photos_deleted_at ON photos(deleted_at) WHERE deleted_at IS NOT NULL;
|
||||
|
||||
-- 地理位置索引
|
||||
CREATE INDEX idx_photos_location ON photos(latitude, longitude) WHERE latitude IS NOT NULL AND longitude IS NOT NULL;
|
||||
|
||||
-- 添加更新时间触发器
|
||||
CREATE TRIGGER update_photos_updated_at BEFORE UPDATE ON photos
|
||||
FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- +migrate Down
|
||||
|
||||
DROP TRIGGER IF EXISTS update_photos_updated_at ON photos;
|
||||
DROP TABLE IF EXISTS photos;
|
||||
@ -1,113 +0,0 @@
|
||||
-- +migrate Up
|
||||
|
||||
CREATE TABLE categories (
|
||||
id SERIAL PRIMARY KEY,
|
||||
name VARCHAR(100) NOT NULL,
|
||||
description TEXT,
|
||||
slug VARCHAR(255) UNIQUE,
|
||||
parent_id INTEGER REFERENCES categories(id) ON DELETE CASCADE,
|
||||
user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
cover_photo_id INTEGER REFERENCES photos(id) ON DELETE SET NULL,
|
||||
color VARCHAR(7) DEFAULT '#3B82F6',
|
||||
is_public BOOLEAN DEFAULT true,
|
||||
photo_count INTEGER DEFAULT 0,
|
||||
album_count INTEGER DEFAULT 0,
|
||||
sort_order INTEGER DEFAULT 0,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
deleted_at TIMESTAMP
|
||||
);
|
||||
|
||||
-- 创建索引
|
||||
CREATE INDEX idx_categories_user_id ON categories(user_id);
|
||||
CREATE INDEX idx_categories_parent_id ON categories(parent_id);
|
||||
CREATE INDEX idx_categories_cover_photo_id ON categories(cover_photo_id);
|
||||
CREATE INDEX idx_categories_slug ON categories(slug);
|
||||
CREATE INDEX idx_categories_is_public ON categories(is_public);
|
||||
CREATE INDEX idx_categories_created_at ON categories(created_at);
|
||||
CREATE INDEX idx_categories_photo_count ON categories(photo_count);
|
||||
CREATE INDEX idx_categories_album_count ON categories(album_count);
|
||||
CREATE INDEX idx_categories_sort_order ON categories(sort_order);
|
||||
CREATE INDEX idx_categories_deleted_at ON categories(deleted_at) WHERE deleted_at IS NOT NULL;
|
||||
|
||||
-- 树形结构查询优化
|
||||
CREATE INDEX idx_categories_parent_sort ON categories(parent_id, sort_order);
|
||||
|
||||
-- 添加更新时间触发器
|
||||
CREATE TRIGGER update_categories_updated_at BEFORE UPDATE ON categories
|
||||
FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- 添加 slug 自动生成触发器
|
||||
CREATE OR REPLACE FUNCTION generate_category_slug()
|
||||
RETURNS TRIGGER AS $$
|
||||
BEGIN
|
||||
IF NEW.slug IS NULL OR NEW.slug = '' THEN
|
||||
NEW.slug = lower(regexp_replace(NEW.name, '[^a-zA-Z0-9]+', '-', 'g'));
|
||||
NEW.slug = trim(both '-' from NEW.slug);
|
||||
|
||||
-- 确保 slug 唯一
|
||||
DECLARE
|
||||
counter INTEGER := 0;
|
||||
base_slug VARCHAR(255);
|
||||
BEGIN
|
||||
base_slug := NEW.slug;
|
||||
WHILE EXISTS (SELECT 1 FROM categories WHERE slug = NEW.slug AND id != COALESCE(NEW.id, 0)) LOOP
|
||||
counter := counter + 1;
|
||||
NEW.slug := base_slug || '-' || counter;
|
||||
END LOOP;
|
||||
END;
|
||||
END IF;
|
||||
RETURN NEW;
|
||||
END;
|
||||
$$ language 'plpgsql';
|
||||
|
||||
CREATE TRIGGER generate_categories_slug BEFORE INSERT OR UPDATE ON categories
|
||||
FOR EACH ROW EXECUTE FUNCTION generate_category_slug();
|
||||
|
||||
-- 插入默认分类
|
||||
INSERT INTO categories (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'风景摄影' as name,
|
||||
'自然风光、城市景观等风景类摄影作品' as description,
|
||||
'landscape' as slug,
|
||||
1 as user_id,
|
||||
'#10B981' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO categories (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'人像摄影' as name,
|
||||
'肖像、写真、人物摄影作品' as description,
|
||||
'portrait' as slug,
|
||||
1 as user_id,
|
||||
'#F59E0B' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO categories (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'街拍摄影' as name,
|
||||
'街头摄影、日常生活记录' as description,
|
||||
'street' as slug,
|
||||
1 as user_id,
|
||||
'#EF4444' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO categories (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'建筑摄影' as name,
|
||||
'建筑、室内设计等建筑类摄影作品' as description,
|
||||
'architecture' as slug,
|
||||
1 as user_id,
|
||||
'#8B5CF6' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
-- +migrate Down
|
||||
|
||||
DROP TRIGGER IF EXISTS generate_categories_slug ON categories;
|
||||
DROP FUNCTION IF EXISTS generate_category_slug();
|
||||
DROP TRIGGER IF EXISTS update_categories_updated_at ON categories;
|
||||
DROP TABLE IF EXISTS categories;
|
||||
@ -2,54 +2,63 @@
|
||||
|
||||
CREATE TABLE photos (
|
||||
id SERIAL PRIMARY KEY,
|
||||
title VARCHAR(255) NOT NULL,
|
||||
title VARCHAR(200) NOT NULL,
|
||||
description TEXT,
|
||||
filename VARCHAR(255) NOT NULL,
|
||||
file_path VARCHAR(500) NOT NULL,
|
||||
original_url VARCHAR(500) NOT NULL,
|
||||
thumbnail_url VARCHAR(500),
|
||||
medium_url VARCHAR(500),
|
||||
large_url VARCHAR(500),
|
||||
file_size BIGINT,
|
||||
mime_type VARCHAR(100),
|
||||
width INTEGER,
|
||||
height INTEGER,
|
||||
category_id INTEGER REFERENCES categories(id),
|
||||
exif JSONB,
|
||||
camera_make VARCHAR(100),
|
||||
camera_model VARCHAR(100),
|
||||
lens_model VARCHAR(100),
|
||||
focal_length DECIMAL(5,2),
|
||||
aperture DECIMAL(3,1),
|
||||
shutter_speed VARCHAR(20),
|
||||
iso INTEGER,
|
||||
taken_at TIMESTAMP,
|
||||
location VARCHAR(255),
|
||||
location_name VARCHAR(200),
|
||||
latitude DECIMAL(10,8),
|
||||
longitude DECIMAL(11,8),
|
||||
user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
album_id INTEGER,
|
||||
category_id INTEGER,
|
||||
is_public BOOLEAN DEFAULT true,
|
||||
status VARCHAR(20) DEFAULT 'draft',
|
||||
is_featured BOOLEAN DEFAULT false,
|
||||
view_count INTEGER DEFAULT 0,
|
||||
like_count INTEGER DEFAULT 0,
|
||||
user_id INTEGER NOT NULL REFERENCES users(id),
|
||||
download_count INTEGER DEFAULT 0,
|
||||
sort_order INTEGER DEFAULT 0,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
deleted_at TIMESTAMP
|
||||
);
|
||||
|
||||
-- 创建照片标签关联表
|
||||
CREATE TABLE photo_tags (
|
||||
photo_id INTEGER REFERENCES photos(id) ON DELETE CASCADE,
|
||||
tag_id INTEGER REFERENCES tags(id) ON DELETE CASCADE,
|
||||
PRIMARY KEY (photo_id, tag_id)
|
||||
);
|
||||
|
||||
-- 创建索引
|
||||
CREATE INDEX idx_photos_category_id ON photos(category_id);
|
||||
CREATE INDEX idx_photos_user_id ON photos(user_id);
|
||||
CREATE INDEX idx_photos_status ON photos(status);
|
||||
CREATE INDEX idx_photos_album_id ON photos(album_id);
|
||||
CREATE INDEX idx_photos_category_id ON photos(category_id);
|
||||
CREATE INDEX idx_photos_is_public ON photos(is_public);
|
||||
CREATE INDEX idx_photos_is_featured ON photos(is_featured);
|
||||
CREATE INDEX idx_photos_taken_at ON photos(taken_at);
|
||||
CREATE INDEX idx_photos_created_at ON photos(created_at);
|
||||
CREATE INDEX idx_photos_view_count ON photos(view_count);
|
||||
CREATE INDEX idx_photos_like_count ON photos(like_count);
|
||||
CREATE INDEX idx_photos_deleted_at ON photos(deleted_at);
|
||||
CREATE INDEX idx_photos_sort_order ON photos(sort_order);
|
||||
CREATE INDEX idx_photos_deleted_at ON photos(deleted_at) WHERE deleted_at IS NOT NULL;
|
||||
|
||||
-- 为JSONB字段创建GIN索引（支持高效的JSON查询）
|
||||
CREATE INDEX idx_photos_exif_gin ON photos USING GIN (exif);
|
||||
-- 地理位置索引
|
||||
CREATE INDEX idx_photos_location ON photos(latitude, longitude) WHERE latitude IS NOT NULL AND longitude IS NOT NULL;
|
||||
|
||||
-- 全文搜索索引
|
||||
CREATE INDEX idx_photos_title_gin ON photos USING GIN (to_tsvector('english', title));
|
||||
CREATE INDEX idx_photos_description_gin ON photos USING GIN (to_tsvector('english', description));
|
||||
-- 添加更新时间触发器
|
||||
CREATE TRIGGER update_photos_updated_at BEFORE UPDATE ON photos
|
||||
FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- +migrate Down
|
||||
|
||||
DROP TABLE IF EXISTS photo_tags;
|
||||
DROP TRIGGER IF EXISTS update_photos_updated_at ON photos;
|
||||
DROP TABLE IF EXISTS photos;
|
||||
@ -1,164 +0,0 @@
|
||||
-- +migrate Up
|
||||
|
||||
-- 创建标签表
|
||||
CREATE TABLE tags (
|
||||
id SERIAL PRIMARY KEY,
|
||||
name VARCHAR(100) NOT NULL,
|
||||
slug VARCHAR(255) UNIQUE,
|
||||
color VARCHAR(7) DEFAULT '#6B7280',
|
||||
description TEXT,
|
||||
user_id INTEGER NOT NULL REFERENCES users(id) ON DELETE CASCADE,
|
||||
is_public BOOLEAN DEFAULT true,
|
||||
photo_count INTEGER DEFAULT 0,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
deleted_at TIMESTAMP
|
||||
);
|
||||
|
||||
-- 创建照片标签关联表（多对多）
|
||||
CREATE TABLE photo_tags (
|
||||
id SERIAL PRIMARY KEY,
|
||||
photo_id INTEGER NOT NULL REFERENCES photos(id) ON DELETE CASCADE,
|
||||
tag_id INTEGER NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
UNIQUE(photo_id, tag_id)
|
||||
);
|
||||
|
||||
-- 创建相册标签关联表（多对多）
|
||||
CREATE TABLE album_tags (
|
||||
id SERIAL PRIMARY KEY,
|
||||
album_id INTEGER NOT NULL REFERENCES albums(id) ON DELETE CASCADE,
|
||||
tag_id INTEGER NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
UNIQUE(album_id, tag_id)
|
||||
);
|
||||
|
||||
-- 创建标签表索引
|
||||
CREATE INDEX idx_tags_user_id ON tags(user_id);
|
||||
CREATE INDEX idx_tags_slug ON tags(slug);
|
||||
CREATE INDEX idx_tags_is_public ON tags(is_public);
|
||||
CREATE INDEX idx_tags_created_at ON tags(created_at);
|
||||
CREATE INDEX idx_tags_photo_count ON tags(photo_count);
|
||||
CREATE INDEX idx_tags_deleted_at ON tags(deleted_at) WHERE deleted_at IS NOT NULL;
|
||||
|
||||
-- 创建照片标签关联表索引
|
||||
CREATE INDEX idx_photo_tags_photo_id ON photo_tags(photo_id);
|
||||
CREATE INDEX idx_photo_tags_tag_id ON photo_tags(tag_id);
|
||||
CREATE INDEX idx_photo_tags_created_at ON photo_tags(created_at);
|
||||
|
||||
-- 创建相册标签关联表索引
|
||||
CREATE INDEX idx_album_tags_album_id ON album_tags(album_id);
|
||||
CREATE INDEX idx_album_tags_tag_id ON album_tags(tag_id);
|
||||
CREATE INDEX idx_album_tags_created_at ON album_tags(created_at);
|
||||
|
||||
-- 添加更新时间触发器
|
||||
CREATE TRIGGER update_tags_updated_at BEFORE UPDATE ON tags
|
||||
FOR EACH ROW EXECUTE FUNCTION update_updated_at_column();
|
||||
|
||||
-- 添加 slug 自动生成触发器
|
||||
CREATE OR REPLACE FUNCTION generate_tag_slug()
|
||||
RETURNS TRIGGER AS $$
|
||||
BEGIN
|
||||
IF NEW.slug IS NULL OR NEW.slug = '' THEN
|
||||
NEW.slug = lower(regexp_replace(NEW.name, '[^a-zA-Z0-9]+', '-', 'g'));
|
||||
NEW.slug = trim(both '-' from NEW.slug);
|
||||
|
||||
-- 确保 slug 唯一
|
||||
DECLARE
|
||||
counter INTEGER := 0;
|
||||
base_slug VARCHAR(255);
|
||||
BEGIN
|
||||
base_slug := NEW.slug;
|
||||
WHILE EXISTS (SELECT 1 FROM tags WHERE slug = NEW.slug AND id != COALESCE(NEW.id, 0)) LOOP
|
||||
counter := counter + 1;
|
||||
NEW.slug := base_slug || '-' || counter;
|
||||
END LOOP;
|
||||
END;
|
||||
END IF;
|
||||
RETURN NEW;
|
||||
END;
|
||||
$$ language 'plpgsql';
|
||||
|
||||
CREATE TRIGGER generate_tags_slug BEFORE INSERT OR UPDATE ON tags
|
||||
FOR EACH ROW EXECUTE FUNCTION generate_tag_slug();
|
||||
|
||||
-- 创建标签计数更新触发器
|
||||
CREATE OR REPLACE FUNCTION update_tag_photo_count()
|
||||
RETURNS TRIGGER AS $$
|
||||
BEGIN
|
||||
IF TG_OP = 'INSERT' THEN
|
||||
UPDATE tags SET photo_count = photo_count + 1 WHERE id = NEW.tag_id;
|
||||
RETURN NEW;
|
||||
ELSIF TG_OP = 'DELETE' THEN
|
||||
UPDATE tags SET photo_count = photo_count - 1 WHERE id = OLD.tag_id;
|
||||
RETURN OLD;
|
||||
END IF;
|
||||
RETURN NULL;
|
||||
END;
|
||||
$$ language 'plpgsql';
|
||||
|
||||
CREATE TRIGGER trigger_update_tag_photo_count
|
||||
AFTER INSERT OR DELETE ON photo_tags
|
||||
FOR EACH ROW EXECUTE FUNCTION update_tag_photo_count();
|
||||
|
||||
-- 插入默认标签
|
||||
INSERT INTO tags (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'自然' as name,
|
||||
'自然风光、植物、动物等自然主题' as description,
|
||||
'nature' as slug,
|
||||
1 as user_id,
|
||||
'#10B981' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO tags (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'城市' as name,
|
||||
'城市景观、建筑、街道等城市主题' as description,
|
||||
'city' as slug,
|
||||
1 as user_id,
|
||||
'#3B82F6' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO tags (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'黑白' as name,
|
||||
'黑白摄影作品' as description,
|
||||
'black-white' as slug,
|
||||
1 as user_id,
|
||||
'#6B7280' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO tags (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'夜景' as name,
|
||||
'夜晚拍摄的照片' as description,
|
||||
'night' as slug,
|
||||
1 as user_id,
|
||||
'#1F2937' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
INSERT INTO tags (name, description, slug, user_id, color, is_public)
|
||||
SELECT
|
||||
'日出日落' as name,
|
||||
'日出、日落、黄金时段拍摄' as description,
|
||||
'sunrise-sunset' as slug,
|
||||
1 as user_id,
|
||||
'#F59E0B' as color,
|
||||
true as is_public
|
||||
WHERE EXISTS (SELECT 1 FROM users WHERE id = 1);
|
||||
|
||||
-- +migrate Down
|
||||
|
||||
DROP TRIGGER IF EXISTS trigger_update_tag_photo_count ON photo_tags;
|
||||
DROP FUNCTION IF EXISTS update_tag_photo_count();
|
||||
DROP TRIGGER IF EXISTS generate_tags_slug ON tags;
|
||||
DROP FUNCTION IF EXISTS generate_tag_slug();
|
||||
DROP TRIGGER IF EXISTS update_tags_updated_at ON tags;
|
||||
DROP TABLE IF EXISTS album_tags;
|
||||
DROP TABLE IF EXISTS photo_tags;
|
||||
DROP TABLE IF EXISTS tags;
|
||||
Reference in New Issue
Block a user