Cursor rule

1---
2globs: back/**
3alwaysApply: false
4---
5 
6# Python Firebase Functions - Broker Architecture
7 
8This project follows the broker architecture pattern for Firebase Functions.
9 
10## Folder Structure
11 
12### `src/` - Source Code
13 
14#### Core Components
15 
16- **brokers/** - Message/event handling layer
17 
18  - **callable/** - Client-callable functions (Firebase callable functions)
19  - **https/** - HTTP endpoints (REST APIs)
20  - **triggered/** - Event-triggered functions (Firestore/Storage triggers)
21 
22- **documents/** - DocumentBase classes
23 
24  - Each document class represents a Firestore collection
25  - All Firestore operations MUST go through these classes
26  - Never access Firestore directly
27 
28- **models/** - Type definitions
29 
30  - **firestore_types.py** - Pydantic models for Firestore documents
31  - **function_types.py** - Request/response types for functions
32  - **util_types.py** - Utility types and enums
33 
34- **services/** - Business logic
35 
36  - Orchestrate operations across multiple documents
37  - Complex workflows and business rules
38 
39- **factories/** - Object creation
40 
41  - Create documents from various sources (CSV, JSON, templates)
42  - Batch operations
43 
44- **shared/** - Shared components
45 
46  - **Db.py** - Database singleton with ProjectDb class
47  - **DocumentBase.py** - Base document class
48 
49- **util/** - Utility functions
50 
51  - Authentication helpers
52  - CORS handling
53  - Logging
54 
55- **exceptions/** - Custom exceptions
56  - Project-specific error classes
57 
58### `tests/` - Test Suite
59 
60- **integration/** - End-to-end tests
61- **unit/** - Component tests
62- **util/** - Test utilities
63