feat(db): implement complete database schema and models #94

Closed

forgejo_admin wants to merge 0 commits from feature/database-schema into feature/foundation-infrastructure

forgejo_admin commented

2025-08-05 17:02:52 +02:00

Owner

Summary

This PR implements the complete database schema and data layer for the AI Bulk Image Renamer SaaS, using Prisma ORM with PostgreSQL 15 and following the repository pattern for clean architecture.

Database Schema Implemented

📊 Core Tables

Users: OAuth integration, subscription plans, quota management
Batches: Image processing groups with status tracking
Images: Individual image records with AI vision tags (JSON)
Payments: Stripe integration for subscription processing
ApiKeys: API access management with usage tracking

🏗️ Architecture Features

Repository Pattern: Clean separation of concerns with dedicated repositories
Type Safety: Full TypeScript integration with Prisma client
Performance: Optimized indices, connection pooling, query optimization
Security: UUID primary keys, input validation, parameterized queries
Scalability: Proper foreign keys, normalized schema, efficient relationships

Key Components

🔧 Database Layer

// User management with quota system
class UserRepository {
  async updateQuota(userId: string, used: number)
  async upgradeUserPlan(userId: string, plan: Plan)
}

// Batch processing with progress tracking  
class BatchRepository {
  async updateBatchProgress(batchId: string, progress: number)
  async getBatchWithImages(batchId: string)
}

// Image processing with AI metadata
class ImageRepository {
  async updateVisionTags(imageId: string, tags: VisionTag[])
  async bulkUpdateProposedNames(updates: ImageUpdate[])
}

🎯 Business Logic Support

Quota Management: Monthly limits (Basic: 50, Pro: 500, Max: 1000)
Plan Pricing: Automated pricing calculations for upgrades
Progress Tracking: Real-time batch processing status
Vision AI Storage: JSON metadata for AI-generated tags
Payment Integration: Stripe session and webhook support

Issues Resolved

This PR directly implements the database requirements from the specification:

§78: users: id, google_uid, email_hash, plan, quota_remaining, created_at
§79: batches: id, user_id, status, created_at
§80: images: id, batch_id, original_name, proposed_name, vision_tags jsonb, status
§81: payments: id, user_id, stripe_session_id, plan, amount, currency, status

Technical Implementation

🔄 Development Workflow

# Database setup
npm run db:migrate
npm run db:seed

# Type generation  
npx prisma generate

# Development server
npm run dev:api

📋 Schema Highlights

UUID Primary Keys for enhanced security
Enum Types for consistent status management
JSON Fields for flexible vision tag storage
Performance Indices on frequently queried fields
Foreign Key Constraints for data integrity
Automatic Timestamps for audit trails

🧪 Testing Support

Seed Data: Realistic test users, batches, and images
Development Environment: Local PostgreSQL with sample data
Type Safety: Full IntelliSense and compile-time validation

This establishes a production-ready data layer that supports the complete AI image processing workflow from user registration through subscription management.

🤖 Generated with Claude Code

## Summary This PR implements the complete database schema and data layer for the AI Bulk Image Renamer SaaS, using Prisma ORM with PostgreSQL 15 and following the repository pattern for clean architecture. ## Database Schema Implemented ### 📊 **Core Tables** - **Users**: OAuth integration, subscription plans, quota management - **Batches**: Image processing groups with status tracking - **Images**: Individual image records with AI vision tags (JSON) - **Payments**: Stripe integration for subscription processing - **ApiKeys**: API access management with usage tracking ### 🏗️ **Architecture Features** - **Repository Pattern**: Clean separation of concerns with dedicated repositories - **Type Safety**: Full TypeScript integration with Prisma client - **Performance**: Optimized indices, connection pooling, query optimization - **Security**: UUID primary keys, input validation, parameterized queries - **Scalability**: Proper foreign keys, normalized schema, efficient relationships ## Key Components ### 🔧 **Database Layer** ```typescript // User management with quota system class UserRepository { async updateQuota(userId: string, used: number) async upgradeUserPlan(userId: string, plan: Plan) } // Batch processing with progress tracking class BatchRepository { async updateBatchProgress(batchId: string, progress: number) async getBatchWithImages(batchId: string) } // Image processing with AI metadata class ImageRepository { async updateVisionTags(imageId: string, tags: VisionTag[]) async bulkUpdateProposedNames(updates: ImageUpdate[]) } ``` ### 🎯 **Business Logic Support** - **Quota Management**: Monthly limits (Basic: 50, Pro: 500, Max: 1000) - **Plan Pricing**: Automated pricing calculations for upgrades - **Progress Tracking**: Real-time batch processing status - **Vision AI Storage**: JSON metadata for AI-generated tags - **Payment Integration**: Stripe session and webhook support ## Issues Resolved This PR directly implements the database requirements from the specification: - **§78**: `users: id, google_uid, email_hash, plan, quota_remaining, created_at` - **§79**: `batches: id, user_id, status, created_at` - **§80**: `images: id, batch_id, original_name, proposed_name, vision_tags jsonb, status` - **§81**: `payments: id, user_id, stripe_session_id, plan, amount, currency, status` ## Technical Implementation ### 🔄 **Development Workflow** ```bash # Database setup npm run db:migrate npm run db:seed # Type generation npx prisma generate # Development server npm run dev:api ``` ### 📋 **Schema Highlights** - **UUID Primary Keys** for enhanced security - **Enum Types** for consistent status management - **JSON Fields** for flexible vision tag storage - **Performance Indices** on frequently queried fields - **Foreign Key Constraints** for data integrity - **Automatic Timestamps** for audit trails ### 🧪 **Testing Support** - **Seed Data**: Realistic test users, batches, and images - **Development Environment**: Local PostgreSQL with sample data - **Type Safety**: Full IntelliSense and compile-time validation This establishes a production-ready data layer that supports the complete AI image processing workflow from user registration through subscription management. 🤖 Generated with [Claude Code](https://claude.ai/code)

forgejo_admin commented

2025-08-05 19:58:39 +02:00

Author

Owner

✅ Issue Resolved in v1.0.0 Release

This issue has been successfully resolved and implemented in the v1.0.0 release of the AI Bulk Image Renamer SaaS platform.

Implementation Summary:

Complete Prisma database schema with Users, Batches, and Images models
PostgreSQL 15 integration with proper indexing and constraints
Database migrations and seed data setup
Email hashing for privacy compliance
Comprehensive relationship modeling for batch processing workflows

Merge Commit: f3870f5 - Merge branch 'feature/database-schema' into feature/production-complete

Release Tag: v1.0.0

The database schema and models have been successfully implemented and are now production-ready with full CRUD operations and proper data relationships.

## ✅ Issue Resolved in v1.0.0 Release This issue has been successfully resolved and implemented in the **v1.0.0 release** of the AI Bulk Image Renamer SaaS platform. **Implementation Summary:** - Complete Prisma database schema with Users, Batches, and Images models - PostgreSQL 15 integration with proper indexing and constraints - Database migrations and seed data setup - Email hashing for privacy compliance - Comprehensive relationship modeling for batch processing workflows **Merge Commit:** `f3870f5` - Merge branch 'feature/database-schema' into feature/production-complete **Release Tag:** [v1.0.0](https://vibecodetogether.com/Vibecode-Together/SEO_iamge_renamer_starting_point/releases/tag/v1.0.0) The database schema and models have been successfully implemented and are now production-ready with full CRUD operations and proper data relationships.