# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Project Overview

"掐日子" (Qia Rizi) - AI 纪念日·提醒 - A Chinese calendar reminder app with anniversaries, reminders, and notes.

## Project Structure

```
qia/
├── client/          # Frontend (React 19 + TypeScript + Vite)
├── server/          # Backend (Node.js + Express + Prisma)
├── docs/            # Documentation
└── ui/              # Design assets
```

## Commands

### Frontend (client/)
```bash
cd client
pnpm install
pnpm dev      # Start dev server (http://localhost:5173)
pnpm build    # Production build
pnpm lint     # Run ESLint
```

### Backend (server/)
```bash
cd server
npm install
npm run dev   # Start dev server (http://localhost:3000)
```

## Backend API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/api/auth/register` | POST | User registration |
| `/api/auth/login` | POST | User login |
| `/api/auth/logout` | POST | Logout |
| `/api/auth/me` | GET | Get current user |
| `/api/auth/refresh` | POST | Refresh token |
| `/api/events` | GET/POST | Events CRUD |
| `/api/events/:id` | PUT/DELETE | Event operations |
| `/api/notes` | GET/PUT | Notes operations |
| `/api/ai/parse` | POST | AI event parsing |

## Frontend Architecture

See `client/CLAUDE.md` for detailed frontend guidance.