Cursor rule

1---
2description: Backend logging should use the centralized logger utilities
3globs: packages/backend/**/*.py
4---
5 
6# Backend Logging Standard
7 
8Always use the centralized logging utilities in [packages/backend/src/boards/logging.py](mdc:packages/backend/src/boards/logging.py).
9 
10- Use `get_logger(__name__)` to create module loggers
11- Do not use `print(...)` or `logging.getLogger(...)` directly in backend code
12- Configure once at app startup using `configure_logging(debug=settings.debug)`
13- Prefer structured logs; include request/user context via provided helpers
14- unless logging errors, never use `exc_info=True`
15 
16Example (module usage):
17 
18```python
19from boards.logging import get_logger
20 
21logger = get_logger(__name__)
22 
23async def handler():
24    logger.info("processing", step="start")
25```
26 
27Example (app setup):
28 
29```python
30from boards.logging import configure_logging
31 
32configure_logging(debug=settings.debug)
33```
34