Files
photography/backend/migrations/004_create_categories.sql
xujiang a2f2f66f88
Some checks failed
部署后端服务 / 🧪 测试后端 (push) Failing after 1m37s
部署后端服务 / 🚀 构建并部署 (push) Has been skipped
部署后端服务 / 🔄 回滚部署 (push) Has been skipped
refactor: 重构后端架构,采用 Go 风格四层设计模式
## 主要变更

### 🏗️ 架构重构
- 采用简洁的四层架构:API → Service → Repository → Model
- 遵循 Go 语言最佳实践和命名规范
- 实现依赖注入和接口导向设计
- 统一错误处理和响应格式

### 📁 目录结构优化
- 删除重复模块 (application/, domain/, infrastructure/ 等)
- 规范化命名 (使用 Go 风格的 snake_case)
- 清理无关文件 (package.json, node_modules/ 等)
- 新增规范化的测试目录结构

### 📚 文档系统
- 为每个模块创建详细的 CLAUDE.md 指导文件
- 包含开发规范、最佳实践和使用示例
- 支持模块化开发,缩短上下文长度

### 🔧 开发规范
- 统一接口命名规范 (UserServicer, PhotoRepositoryr)
- 标准化错误处理机制
- 完善的测试策略 (单元测试、集成测试、性能测试)
- 规范化的配置管理

### 🗂️ 新增文件
- cmd/server/ - 服务启动入口和配置
- internal/model/ - 数据模型层 (entity, dto, request)
- pkg/ - 共享工具包 (logger, response, validator)
- tests/ - 完整测试结构
- docs/ - API 文档和架构设计
- .gitignore - Git 忽略文件配置

### 🗑️ 清理内容
- 删除 Node.js 相关文件 (package.json, node_modules/)
- 移除重复的架构目录
- 清理临时文件和构建产物
- 删除重复的文档文件

## 影响
- 提高代码可维护性和可扩展性
- 统一开发规范,提升团队协作效率
- 优化项目结构,符合 Go 语言生态标准
- 完善文档体系,降低上手难度
2025-07-10 11:20:59 +08:00

113 lines
4.0 KiB
PL/PgSQL

-- +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;