.cursorrules

# Scratchpad

## Current Task
Implement a complete web application workflow including:
- Frontend development
- Authentication system
- Backend API integration
- Database management
- Admin system
- Deployment and monitoring setup

### Progress Tracking
[X] Project Setup
  [X] Next.js project structure
  [X] Tailwind CSS configuration
  [X] TypeScript setup
  [X] ESLint configuration

[ ] Frontend Development
  [X] Basic app structure with App Router
  [X] UI component libraries (Radix UI, Headless UI)
  [ ] Layout components
  [ ] Page components
  [ ] Form components with react-hook-form
  [ ] Responsive design implementation
  [ ] Dark mode support
  [ ] Internationalization setup with next-intl

[ ] Authentication System
  [ ] Choose between options:
    - Supabase Auth
    - NextAuth.js
    - Custom auth with Postgres
  [ ] User model and schema
  [ ] Authentication UI components
  [ ] Protected routes in middleware
  [ ] Session management

[ ] Backend API
  [ ] API route structure
  [ ] Database models with Prisma
  [ ] CRUD operations
  [ ] Rate limiting with Upstash
  [ ] Error handling
  [ ] Input validation with Zod
  [ ] API documentation

[ ] Database Integration
  [X] Vercel Postgres setup
  [ ] Database schema design
  [ ] Prisma models
  [ ] Migrations
  [ ] Backup strategy

[ ] Admin System
  [ ] Admin dashboard layout
  [ ] User management interface
  [ ] Content management system
  [ ] Analytics integration
  [ ] Admin-only API routes

[ ] Deployment & Monitoring
  [X] Vercel deployment setup
  [X] Sentry error tracking
  [X] Vercel Analytics
  [ ] Performance monitoring
  [ ] Logging system
  [ ] Alert setup

# Lessons

## Project Setup
- Using Next.js 14+ with App Router
- Python virtual environment in ./venv for tools
- Include debugging information in program output
- Always read files before editing
- Use git commit -F for multiline commit messages
- Include "[Cursor] " in commit messages and PR titles

## Tech Stack
- Next.js for frontend and API routes
- Tailwind CSS for styling
- Radix UI and Headless UI for components
- Vercel Postgres for database
- Upstash Redis for rate limiting
- Resend for email
- next-intl for internationalization
- Vercel Analytics for usage tracking
- Sentry for error monitoring

## Best Practices
- Check GitHub for similar implementations when stuck
- Document all API endpoints
- Keep security best practices in mind
- Use proper error handling
- Maintain clean code structure
- Use Zod for input validation
- Implement rate limiting for API routes

## Known Issues
- Need to handle different character encodings (UTF-8) for international queries
- Add debug information to stderr while keeping stdout clean
- Use 'seaborn-v0_8' for seaborn styles in matplotlib
- Use 'gpt-4o' for OpenAI's GPT-4 with vision capabilities