Add comprehensive database schema design and MVP implementation plan

[Copilot]

This PR addresses the need for a database schema design by creating a comprehensive yet simple foundation for the YarnWrangler web application. The design balances immediate MVP needs with future extensibility.

What's Added

📋 Database Schema Design (docs/design.md)

• 4-phase implementation strategy starting with pattern management only
• 5 core entities: User, Pattern, Project, Yarn, and junction tables for relationships
• Extensible design that allows adding features without breaking existing data
• Clear migration path from simple MVP to full-featured application

🗄️ MVP-Ready Prisma Schema (prisma/schema.prisma)

• Pattern model only for immediate development
• Commented future models ready to be uncommented as features are added
• Proper indexing for common query patterns
• PostgreSQL optimized with appropriate data types

📖 Complete Documentation

• README.md: Full setup guide with database configuration
• schema-validation.md: Examples and validation of the schema design
• .env.example: Environment configuration template

Design Philosophy

The schema follows a "start simple, grow smart" approach:

1. Phase 1 (MVP): Pattern management only - users can upload and organize knitting patterns
2. Phase 2: Add user authentication without breaking existing patterns
3. Phase 3: Implement project tracking and pattern-to-project relationships
4. Phase 4: Add yarn inventory management and project planning features

Key Benefits

• ✅ Non-breaking evolution: Each phase adds functionality without modifying existing data
• ✅ Query performance: Strategic indexes for search, filtering, and pagination
• ✅ Data integrity: Proper foreign keys and constraints
• ✅ Developer friendly: Clear documentation and setup instructions

Technical Implementation

The Prisma schema starts minimal with just the Pattern model, supporting:

• File upload and metadata storage
• Searchable tags using PostgreSQL arrays
• Full-text search capabilities
• Proper timestamps and indexing

Future models are included as commented code, ready to be enabled as features are developed.

Getting Started

After this PR, developers can:

1. Set up the database with npm run db:push
2. Start building the pattern upload functionality
3. Incrementally add features following the documented expansion plan

This design provides a solid foundation for rapid MVP development while maintaining a clear path to the full YarnWrangler feature set.

Warning

Firewall rules blocked me from connecting to one or more addresses

I tried to connect to the following addresses, but was blocked by firewall rules:

• binaries.prisma.sh
  • Triggering command: node scripts/postinstall.js (dns block)
  • Triggering command: node /home/REDACTED/work/YarnWrangler/YarnWrangler/node_modules/prisma/build/index.js generate --postinstall "UNABLE_TO_FIND_POSTINSTALL_TRIGGER__ENVAR_MISSING" (dns block)
  • Triggering command: node /home/REDACTED/work/YarnWrangler/YarnWrangler/node_modules/.bin/prisma generate (dns block)
• fonts.googleapis.com
  • Triggering command: /usr/local/bin/node /home/REDACTED/work/YarnWrangler/YarnWrangler/node_modules/next/dist/compiled/jest-worker/processChild.js (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Created from VS Code via the GitHub Pull Request extension.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.