How stuv1983/aqualog works
AquaLog is a local Streamlit aquarium-management dashboard backed by SQLite. Users select or configure a tank in the sidebar, log water tests, then inspect overview, warnings, analytics, cycle status, inventory, maintenance, and calculator views. The main entry point initializes storage and dispatches these views. Repository excerpts establish several UI-to-data and utility relationships; README capability statements fill in unsampled feature areas. Weekly email delivery is documented, but its runtime sender is not shown in the sampled source.
Main entry points: main.py Dashboard entry · tank.py Tank repository · base.py Repository database layer · sidebar.py Sidebar controls
Components 29
App and navigation
- Dashboard entry
main.py - Sidebar controls
sidebar/sidebar.py - Localization and units
utils/localization.py
Water quality
- Water-test form
sidebar/water_test_form.py - Overview dashboard
tabs/overview_tab.py - Warnings and advice
tabs/warnings_tab.py - Range alert banner
utils/ui/alerts.py - Range validation
utils/validation.py
Tank management
- Tank selector
sidebar/tank_selector.py - Tank and app settings
sidebar/settings_panel.py - Fish and plant inventory
tabs - Equipment inventory
tabs/equipment_tab.py - Maintenance log
tabs/maintenance_tab.py - Weekly report preferences
aqualog_db/repositories/email_settings.py
Analysis and tools
- Data analytics
tabs/data_analytics_tab.py - Cycle tracker
tabs/cycle_tab.py - Aquarium calculators
tabs/tools_tab.py - Chemistry calculations
utils/chemistry.py
SQLite persistence
- Schema initialization
aqualog_db/schema.py - Tank repository
aqualog_db/repositories/tank.py - Water-test repository
aqualog_db/repositories - Inventory repositories
aqualog_db/repositories - Maintenance repository
aqualog_db/repositories/maintenance.py - Custom-range repository
aqualog_db/repositories/custom_range.py - Repository database layer
aqualog_db/base.py - SQLite connection manager
aqualog_db/connection.py - Local SQLite database
Other components
- Aquarium keeper
- SMTP service
Connections 43
- Aquarium keeper → Dashboard entry: opens dashboard
- Dashboard entry → Schema initialization: initializes schema
main.py - Dashboard entry → Sidebar controls: renders sidebar
main.py - Dashboard entry → Overview dashboard: dispatches view
main.py - Dashboard entry → Warnings and advice: dispatches view
main.py - Dashboard entry → Data analytics: dispatches view
main.py - Dashboard entry → Cycle tracker: dispatches view
main.py - Dashboard entry → Aquarium calculators: dispatches view
main.py - Dashboard entry → Fish and plant inventory: dispatches views
main.py - Dashboard entry → Equipment inventory: dispatches view
main.py - Dashboard entry → Maintenance log: dispatches view
main.py - Sidebar controls → Tank selector: renders selector
sidebar/sidebar.py - Sidebar controls → Tank and app settings: renders settings
sidebar/sidebar.py - Sidebar controls → Water-test form: renders form
sidebar/sidebar.py - Tank and app settings → Tank repository: manages tanks
sidebar/settings_panel.py - Tank and app settings → Weekly report preferences: configures preferences
sidebar/settings_panel.py - Water-test form → Water-test repository: records readings
sidebar/water_test_form.py - Tank selector → Tank repository: loads tanks
sidebar/tank_selector.py - Overview dashboard → Tank repository: reads tank details
tabs/overview_tab.py - Overview dashboard → Water-test repository: reads test history
tabs/overview_tab.py - Warnings and advice → Range validation: checks readings
tabs/warnings_tab.py - Warnings and advice → SQLite connection manager: reads stored data
tabs/warnings_tab.py - Range alert banner → Water-test repository: loads latest test
utils/ui/alerts.py - Range alert banner → Range validation: checks ranges
utils/ui/alerts.py - Range validation → Custom-range repository: loads custom ranges
utils/validation.py - Range validation → Tank repository: loads tank settings
utils/validation.py - Data analytics → SQLite connection manager: queries test data
tabs/data_analytics_tab.py - Cycle tracker → Water-test repository: uses water records
tabs/cycle_tab.py - Aquarium calculators → Chemistry calculations: calculates doses
tabs/tools_tab.py - Aquarium calculators → Tank repository: uses tank volume
tabs/tools_tab.py - Fish and plant inventory → Inventory repositories: manages livestock
tabs/fish_inventory_tab.py - Equipment inventory → Inventory repositories: manages equipment
tabs/equipment_tab.py - Maintenance log → Maintenance repository: records tasks
tabs/maintenance_tab.py - Water-test form → Localization and units: translates form
sidebar/water_test_form.py - Schema initialization → Local SQLite database: creates schema
- Tank repository → Repository database layer: uses repository layer
aqualog_db/repositories/tank.py - Maintenance repository → Repository database layer: uses repository layer
aqualog_db/repositories/maintenance.py - Custom-range repository → Repository database layer: uses repository layer
aqualog_db/repositories/custom_range.py - Weekly report preferences → Repository database layer: uses repository layer
aqualog_db/repositories/email_settings.py - Repository database layer → Local SQLite database: reads and writes
aqualog_db/base.py - SQLite connection manager → Local SQLite database: opens database
aqualog_db/connection.py - Tank and app settings → Custom-range repository: sets safe ranges
sidebar/settings_panel.py - Weekly report preferences → SMTP service: weekly delivery