Files
FishIQ/docs/ARCHITECTURE.md
T

17 lines
820 B
Markdown
Raw Normal View History

2026-08-28 10:56:14 -05:00
# Architecture
FishIQ begins as a modular monolith around Django and PostgreSQL, with Redis for caching and background work. The web and mobile clients consume a versioned REST API. Professor Finn, recommendations, conditions, and notifications have explicit service boundaries but remain deployable together until scale or team ownership justifies extraction.
## Core flow
User + trip + target species + water body → normalized conditions → recommendation evidence → ranked plan → Professor Finn explanation.
## Principles
- Keep precise catch locations private by default.
- Store source, timestamp, and freshness for condition data.
- Make recommendations explainable and measure outcomes.
- Keep provider integrations behind adapters.
- Never send secrets or unnecessary personal data to AI providers.