16 Commits

Author SHA1 Message Date
Anthony Cassandra
9374dc0418 Clarify that Redis is bundled in Docker deployments
Developer docs mentioned Redis as a requirement without distinguishing
between local development (where you install it yourself) and Docker
deployment (where it is bundled and managed by supervisord). This caused
confusion for a user who set up an external Redis server not realizing
the Docker image already includes one.

Closes #241
2026-03-29 13:15:54 -05:00
Tony C
f5032b72e0 Docs updates for new first-time user flows (#191)
* New Getting Started page, moved and revised content into Editing page.
2025-09-17 00:09:29 +00:00
Anthony Cassandra
28cb0e6356 A few more documentation fixes. 2025-09-07 00:11:15 -05:00
Tony C
535549e74c Documentation updates and pre-release tweaks (#146)
* Bug fix and some documentation improvements.

* Addd model diagrams.

* Documentation Updates and DB utility scripts added.

* Updated documentation.

* Documentation refinements.

* Added new screenshot images and updated docs.

* Added linkk to helper data export scripts.
2025-09-06 22:31:17 -05:00
Tony C
39c7266e77 Refactor developer documentation for role-based use (#126)
* Refactored dev documentation extensivekly.

* Style tweaks and link removals.
2025-08-26 23:17:26 +00:00
cassandra-ai-agent
a44c973412 [Ops] Add Development Setup Helper Script (Issue #7) (#72)
* Add development setup helper script (Issue #7)

- Create comprehensive setup script deploy/dev-setup.sh
- Automates git configuration, environment setup, virtual environment creation
- Handles package installation and database initialization
- Interactive prompts for user input with validation
- Idempotent design allows safe repeated execution
- Update docs/dev/Setup.md to reference new automated setup option
- Maintain existing manual setup instructions as alternative

* Update CLAUDE.md with GitHub issue template guidance

- Add section on creating GitHub issues
- Document available issue templates
- Include examples of using gh CLI with templates
- Note that blank issues are disabled
2025-08-20 23:33:59 +00:00
Tony Cassandra
645f518019 Update documentation: AI agent workflow improvements and setup clarifications
- Enhanced CLAUDE.md with development environment checks
- Improved AiAgentSetup.md with latest procedures
- Updated Setup.md with additional configuration details

These documentation updates improve guidance for AI-assisted development workflows.
2025-08-18 17:04:37 -05:00
Tony C
f37d283a18 Integration/Services unit tests adds and improvements (#59)
* Add comprehensive unit tests for HASS and ZoneMinder integration services

- Create complete test suite for ZoneMinder services (manager, controller, sync)
- Add comprehensive HASS service tests (manager, client, controller, sync)
- Include real API response data for enhanced test robustness
- Cover database operations, external API boundaries, and error handling
- Address zero test coverage gaps identified in Issue #52

* A boatload of integration/service unit test adds and fixes.

* Addressed PR feedback about empty IntegrationKey instances.
2025-08-16 17:24:38 +00:00
Tony C
dd9f1be0db Refactor documentation structure to separate universal guidelines from environment-specific configuration (#57)
- Move architecture overview from CLAUDE.md to dev/Architecture.md
- Enhance dev/Guidelines.md with coding standards and flake8 configurations
- Add comprehensive testing guidelines to dev/Testing.md
- Expand dev/Setup.md with daily development commands
- Streamline CLAUDE.md to focus on environment-specific config
- Add cross-references between documentation files
- Separate Claude-specific guidance from universal project guidelines

Closes #54
2025-08-15 22:06:07 +00:00
Tony C
73fb9a322c Fix typos and language clarifications in documentation (#48)
- Fix typo 'organizes' to 'organize' in README.md
- Fix typo 'Un'zip' to 'unzip' in README.md and Installation.md
- Fix typo 'functonality' to 'functionality' in CONTRIBUTING.md
- Fix typo 'envirnoment' to 'environment' in Setup.md
- Improve Redis startup instruction clarity in Setup.md
- Fix multiple typos in GettingStarted.md including 'thne', 'LIne', 'integations', 'acquaintences'
- Fix typos 'trhe', 'UURLs', 'triued' in Guidelines.md
2025-08-15 02:06:39 +00:00
Tony C
036f39d2c4 Add new weather module (#41)
* Added initial scaffolding for weather support.

* Code cleanup and refactor around SecurityManager accesses.

* Added initial pass for an internal, unified weather data model.

* Added display unit conversions and UI testing page for weather app.

* Added template scaffolding and initial data model for weather.

* Finished templates and test data scaffolding for weather views.

* Added user setting for geo location (lat/long).

* WIP for weather monitors and NWS API integration.

* Beter factoring and parsing for NWS weather data source.

* Added WMO units and unit test for it. WIP for NWS weather source.

* Added unit tests for weather app (transient) models.

* Added unit test for NWS weather source observation parsing.

* Renamed a bunch of mixin file names for pluralization consistency.

* Straggler (missed) mixin file name change from previous commit.

* Added folding in of updated weath data into WeatherManager.

* Fixed some bug around fetching NWS data for the first time.

* Added WeatherStation to data model. WIP

* Finished adding new WeatherStation to weather data model.

* Added weather stations to UI.

* Added fetching NWS forecast data (hourly and 12 hour).

* Added three-valued parsing for NWS data: min, ave, max

* Updated weather synthetic data for recent model tweaks.

* Some variable/class renaming. Prep for forecast data model changes.

* Added StatisticDataPoint for min/max/ave values.

* Some minor refactoring to improve class naming and structures.

* Saving WIP for weather data aggregation class and data structures.

* Added improvement to dev docs.

* From strudel...more weather work.

* Removed redundant "elevation" model fields.

* Completed initial weather integrations w/Claude Code.

* Implement auto-discovery weather source configuration system

* Fix weather module unit test failures and improve WMO units handling

* Add git commit message guidelines to CLAUDE.md

* Expand testing infrastructure documentation with comprehensive high-value testing patterns and system architecture insights

* Fixed a few weather app bugs.

* Weather data inspection script and weather app bug fixes.

* More weather bug fixes and unit tests.

* More testing and fixing of initial weather app.

* Added sunrise-sunset.org integration. Fixed boolean config bug.

* Fixed astronomical data integration.

* Added future astronomical data frim sunrise-sunset.org API.

* Added USNO API data for sun and moon.

* Added weather alert data from NWS. Still need to map to Alarms.

* Added mapping weather alerts to system Alarms.

* Added tracking min/max daily temperatures.

* Tweaks and refinements for weather alerts.

* Last weather app tweaks before declaring first version done.

* Moved console context processor to more logical location.

* Fixed and updates some unit tests.

* Coding style fixes for weather module.

* Updated dev workflow doc.

* Fixed a bunch of code formatting.

* A few more code style fixes.

* Added missing import.
2025-08-13 14:47:04 -05:00
Tony C
eba114f084 Changed install docs to go to releases. (#11)
* Changed install process to use release files and not git clone.

* Updated dev setup docs to reflect new default staging branch setting.
2025-02-14 15:05:37 -06:00
Tony C
670459cfaa A bunch of tweaks from going through dev setup with other account. 2025-02-14 13:45:00 -06:00
Anthony Cassandra
44bcfd0e7a Added runing unit tests to dev setup docs. 2025-02-13 17:34:45 -06:00
Anthony Cassandra
fa83bff4f4 Fixed some documentation link bugs and a few typo improvements. 2025-02-13 17:03:24 -06:00
Anthony Cassandra
836b3c5372 Continued refactoring and content additions to documentation. 2025-02-13 15:36:02 -06:00