Initialize FishIQ development foundation

2026-08-28 10:56:14 -05:00
commit 3eb459a307
81 changed files with 1642 additions and 0 deletions
@@ -0,0 +1,16 @@
+# 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.
+