# TechDegree IL — CLAUDE.md

## Current Architecture
- Next.js 16 App Router + React 19 on Vercel
- FastAPI backend on Railway (Python 3.11)
- MongoDB Atlas (Beanie ODM)
- Auth: Google OAuth → JWT (access 720min, refresh 30 days in localStorage)
- Payments: Grow (Israeli) — scaffold only, links are placeholders

## Key Decisions Made (don't question these)
- Using localStorage for tokens (not cookies) — decision: Railway CORS limitations
- Beanie instead of PyMongo — decision: async-first, type-safe ODM
- App Router instead of Pages Router — decision: server components performance
- No separate cart DB — localStorage only for now

## Known Issues (don't suggest "fixing" these yet)
- Grow payment integration is placeholder — waiting for live credentials
- No server-side cart — intentional, postponed
- Mobile responsiveness on lesson page needs work — known, not priority

## Current Sprint Focus
- Adding remaining 40 lessons to courses
- Performance: lazy loading for MDX content
- Auth: add email/password as fallback for Google OAuth

## Code Conventions
[... conventions ...]

## Testing
- Frontend: npm run build (type checks only for now)
- Backend: cd backend && uv run pytest

## DO NOT
- Don't add dependencies without checking package.json first
- Don't touch the MongoDB indexes — they have TTL and are intentional
- Don't suggest Redux — we use Zustand/React Query
- Don't generate code with Hebrew comments
Memory וניהול Context ארוך טווח

Memory וניהול Context ארוך טווח

Memory וניהול Context ארוך טווח
