Cline rules

1# API Patterns
2 
3## Interactive API Documentation
4 
5- **Swagger UI**: http://localhost:8000/docs
6- **ReDoc**: http://localhost:8000/redoc
7- **OpenAPI Schema**: http://localhost:8000/openapi.json
8 
9## API Endpoints Reference
10 
11→ Complete API reference: `docs/api-reference.md`
12→ Curl examples: `backend-curls.md`
13 
14## Current Endpoints
15 
16### Health & System
17- `GET /health` - System health check
18 
19### 3D Model Management
20- `GET /model` - Download GLB model
21- `GET /model/info` - Get model metadata
22 
23### User Management
24- `POST /users/` - Create user
25- `GET /users/` - List users (paginated)
26- `GET /users/{user_id}` - Get user details
27- `PUT /users/{user_id}` - Update user
28- `DELETE /users/{user_id}` - Delete user
29- `POST /users/login` - User login
30 
31## Testing the API
32 
33### Using Swagger UI (Recommended)
341. Start application: `./run_dev.sh`
352. Open: http://localhost:8000/docs
363. Click "Try it out" on any endpoint
374. Fill parameters and click "Execute"
38 
39### Using curl
40→ See examples: `backend-curls.md`
41→ See examples: `docs/api-reference.md#testing-the-api`
42 
43## API Implementation Pattern
44 
45When adding new endpoints, follow this pattern:
46 
471. **Create Router** (`backend/app/api/routers/`)
482. **Use Service Layer** (`backend/app/services/`)
493. **Use Repository Layer** (`backend/app/repositories/`)
504. **Register Router** in `backend/app/main.py`
51 
52→ Detailed guide: `docs/development-guide.md#adding-a-new-feature`
53 
54## CORS Configuration
55 
56- **Allowed Origins**: `http://localhost:3000`
57- **Allowed Methods**: `GET, POST, PUT, DELETE, OPTIONS`
58- **Allowed Headers**: `*`
59 
60→ Configuration: `backend/app/core/config.py`
61