CLAUDE.md Mastery Intermediate

# Personal Claude Code Preferences

- Always use TypeScript strict mode
- Prefer functional programming patterns
- Write tests for every new function
- Use descriptive variable names (no single letters except loop indices)
- When creating commits, use conventional commit format

# ShopAPI - E-Commerce Backend

## Stack
Node.js 20, Express 4, TypeScript 5.3, PostgreSQL 16, Knex.js, Jest

## Commands
- `npm run dev` - Start with hot reload (port 3000)
- `npm test` - Run Jest tests
- `npm run migrate` - Run database migrations
- `npm run seed` - Seed test data
- `npm run lint` - ESLint

## Structure
- src/routes/ - Express route handlers (one file per resource)
- src/services/ - Business logic (called by routes)
- src/models/ - Knex query builders
- src/middleware/ - Auth, validation, error handling
- src/types/ - TypeScript interfaces
- migrations/ - Knex migration files

## Conventions
- All routes return { success: boolean, data?: any, error?: string }
- Use the AppError class from src/errors/AppError.ts for all errors
- Database queries go in models/, never in routes or services
- All dates stored as UTC timestamps
- Pagination uses cursor-based (not offset) - see src/utils/pagination.ts

# DataPortal - Analytics Dashboard

## Stack
Python 3.12, Django 5.0, PostgreSQL, Celery + Redis, pytest

## Commands
- `python manage.py runserver` - Dev server
- `pytest` - Run all tests
- `pytest -x --tb=short` - Stop on first failure
- `python manage.py makemigrations` - Create migrations
- `celery -A config worker` - Start background workers

## Structure
- apps/dashboard/ - Main dashboard app
- apps/api/ - REST API (DRF)
- apps/analytics/ - Data processing
- config/ - Django settings
- tasks/ - Celery tasks

## Conventions
- Use class-based views for API endpoints
- Type hints on all function signatures
- Docstrings in Google style
- Tests mirror the app structure in tests/

# StoreFront - E-Commerce UI

## Stack
React 18, TypeScript, Vite, TailwindCSS, React Query, Zustand

## Commands
- `pnpm dev` - Dev server (port 5173)
- `pnpm test` - Vitest
- `pnpm build` - Production build
- `pnpm storybook` - Component playground

## Structure
- src/components/ - Reusable UI components (each in own folder with index.tsx, styles, tests)
- src/pages/ - Route-level components
- src/hooks/ - Custom React hooks
- src/stores/ - Zustand state stores
- src/api/ - React Query hooks for API calls
- src/types/ - TypeScript types

## Conventions
- Components are functional with hooks (no class components)
- Use Tailwind for styling (no CSS modules)
- State: Zustand for global, useState for local, React Query for server
- Every component folder has: index.tsx, ComponentName.test.tsx, ComponentName.stories.tsx

# Ask Claude to update CLAUDE.md based on recent changes
> We just added Redis caching to the project. Update CLAUDE.md to include:
> - Redis in the tech stack
> - The cache utility location (src/utils/cache.ts)
> - Caching conventions (TTL defaults, cache key patterns)

# Periodic review
> Review our CLAUDE.md and suggest improvements. What's missing?
> What's outdated? What could be more specific?