ref: user, visitor endpoints; added: zone, site and report endpoints

[devcavin]

This pull request introduces several new features and improvements related to visitor profiles, user and site management, and reporting. The main changes include the introduction of the VisitorProfile entity, enhancements to user and visitor management services, and the addition of new services for handling sites and zones. Below are the most important changes grouped by theme:

Visitor Profile Management:

• Introduced the VisitorProfile entity, ensuring unique visitor profiles per site and phone number, and updated the Visitor entity to reference VisitorProfile. [1] [2]
• Added VisitorProfileRepository for data access, including methods to find and check existence by site and phone number.
• Updated VisitorService to associate visitors with profiles, create profiles if missing, and provide a method to update visitor profiles with validation. [1] [2]
• Improved returning visitor lookup to use VisitorProfile for more accurate results.
• Added a repository method to count visits by profile and site.

User Management Enhancements:

• Extended UserService with methods to list, retrieve, update, activate, deactivate users, and change passwords, including role and site-based access control.

Site and Zone Management:

• Added SiteService and ZoneService for full CRUD operations on sites and zones, with business rules to prevent duplicates and ensure proper site/zone relationships. [1] [2]

Reporting:

• Added ReportService to export visitor data as CSV, including visit details and durations.

General Improvements:

• Refactored service and repository dependencies for better modularity and clarity.

These changes collectively improve the data model, enforce business rules, and add essential features for managing visitors, users, sites, and zones.