Cline rules

1# Project Overview
2 
3## What is Sapi3D?
4 
53D building visualization application with interactive first-person exploration, gamification features (achievements, progress tracking, session management).
6 
7## Tech Stack
8 
9- **Backend**: FastAPI + SQLAlchemy 2.0 + PostgreSQL
10- **Frontend**: React 19 + Three.js + Vite
11- **Infrastructure**: Docker + Docker Compose
12- **Database**: PostgreSQL 16 Alpine
13 
14## Quick Constants
15 
16### Docker Containers
17- Backend: `sapi3d-backend`
18- Frontend: `sapi3d-frontend`
19- Database: `sapi3d-db`
20 
21### Ports
22- Backend API: `8000`
23- Frontend: `3000`
24- PostgreSQL: `5432`
25 
26### Database Connection
27- URL: `postgresql+asyncpg://sapi3d:sapi3d_password@db:5432/sapi3d`
28- User: `sapi3d`
29- Password: `sapi3d_password`
30- Database: `sapi3d`
31 
32### Base Paths
33- Backend code: `backend/app/`
34- Frontend code: `frontend/src/`
35- 3D models: `backend/static/models/`
36- Documentation: `docs/`
37 
38## Implementation Status
39 
40### ✅ Complete
41- Database setup & models (all 11 tables)
42- User CRUD operations
43- 3D model serving
44- Health monitoring
45- Basic UI (Navbar, Sidebar, 3D scene)
46 
47### 🚧 In Progress
48- JWT authentication
49- User management (basic done, auth pending)
50 
51### 📋 Planned
52- Session tracking
53- Performance metrics
54- Achievement system
55- Location features
56 
57## Key URLs
58 
59- **Frontend**: http://localhost:3000
60- **Backend API Docs**: http://localhost:8000/docs (Swagger UI)
61- **ReDoc**: http://localhost:8000/redoc
62- **Health Check**: http://localhost:8000/health
63 
64## Detailed Documentation
65 
66→ Full architecture: `docs/architecture.md`
67→ Feature roadmap: `docs/features.md`
68→ Development guide: `docs/development-guide.md`
69