Akiba So
e95e2f1338
Ship a new app version with broader analytics, restructured dashboards, and a server-rendered risk map. Frontend: - Add Overview, Demographic, Disease, and Environmental Health analysis pages - Add AnomalyMarkers, CalendarHeatmap, and MetricHeatmapTable components - Rebuild Alerts map onto server-rendered raster risk tiles; expand Monitoring, Trend, and District Comparison views - Extend API client, stores, and TypeScript types Backend: - Add environment router (pollutants, lag correlations) - Add risk_raster util serving XYZ 100m risk tiles - Expand cases endpoints (demographics, seasonality, diagnoses) and insights; harden auth and file-based loaders Data & tooling: - Add processed outpatient/inpatient/combined case parquet (LFS) - Add nested CLAUDE.md guides, pyrightconfig, and test updates
47 lines
1.4 KiB
Markdown
47 lines
1.4 KiB
Markdown
# Backend Tests
|
|
|
|
## Framework
|
|
|
|
pytest + FastAPI `TestClient` (sync, in-process). No database mocking needed — tests hit real endpoints with real data files.
|
|
|
|
## Structure
|
|
|
|
- `conftest.py` — shared fixtures (`client`, `auth_headers`, test data)
|
|
- `test_api.py` — endpoint integration tests, organized by router class
|
|
- `test_auth.py` — authentication flow tests
|
|
- `test_error_handling.py` — edge cases, error responses
|
|
- `test_utils.py` — pure utility function tests
|
|
|
|
## Patterns
|
|
|
|
- Tests organized in classes: `class TestRiskEndpoints:`
|
|
- One test method per scenario: `test_current_risk_map()`, `test_risk_map_with_date()`
|
|
- Fixture naming: `client: TestClient`, `auth_headers: dict`
|
|
- Assert response status, then JSON structure, then field types/values
|
|
|
|
```python
|
|
class TestSomeRouter:
|
|
def test_something(self, client: TestClient):
|
|
resp = client.get("/api/some/endpoint")
|
|
assert resp.status_code == 200
|
|
data = resp.json()
|
|
assert "key" in data
|
|
assert isinstance(data["key"], list)
|
|
```
|
|
|
|
## Running
|
|
|
|
```bash
|
|
cd backend
|
|
source venv/bin/activate
|
|
pytest tests/ -v
|
|
pytest tests/test_api.py -v -k "test_risk"
|
|
```
|
|
|
|
## Anti-Patterns
|
|
|
|
- Don't mock endpoints you can test with real data
|
|
- Don't hardcode test dates that will go stale
|
|
- Don't skip assertions on response structure just because status is 200
|
|
- Don't share mutable state between test classes — use fixtures
|