ITEP-89462 Refactor and add UT for controller analytics functions

[tdorauintc]

📝 Description

Changes:

• Refactoring of tripwire and region events calculation into an isolated, easily testable primitive functions (independent from controller) operating in batched manner, that can be further optimized and unit tested.
• Adding comprehensive unit tests of the new functions.

Background:

• Short-term goal is to enable unit testing of the functionality in SceneScape and early reuse in DLStreamer PoC of gvaAnalytics element.
• Long-term goal is to establish a common interface that encapsulates the functionality and enables future optimizations (batch processing, C++ implementation) and reuse.

✨ Type of Change

Select the type of change your PR introduces:

• 🐞 Bug fix – Non-breaking change which fixes an issue
• 🚀 New feature – Non-breaking change which adds functionality
• 🔨 Refactor – Non-breaking change which refactors the code base
• 💥 Breaking change – Changes that break existing functionality
• 📚 Documentation update
• 🔒 Security update
• 🧪 Tests
• 🚂 CI

🧪 Testing Scenarios

Validated with the following automated tests: mqtt-tripwire, mqtt-roi, geometry-unit

• ✅ Tested manually
• 🤖 Ran automated end-to-end tests

✅ Checklist

Before submitting the PR, ensure the following:

• 🔍 PR title is clear and descriptive
• 📝 For internal contributors: If applicable, include the JIRA ticket number (e.g., ITEP-123456) in the PR title. Do not include full URLs
• 💬 I have commented my code, especially in hard-to-understand areas
• 📄 I have made corresponding changes to the documentation
• ✅ I have added tests that prove my fix is effective or my feature works

[Copilot]

Pull request overview

Refactors controller analytics for tripwire/region event detection into reusable, batch-oriented helpers in scene_common.geometry, and adds unit tests to validate the new primitives independently of the controller.

Changes:

• Added get_tripwire_events() and get_region_events() helpers to scene_common.geometry.
• Updated controller.scene.Scene to use the new helpers for analytics event calculation.
• Added new geometry unit tests covering tripwire crossings and region containment.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File	Description
scene_common/src/scene_common/geometry.py	Introduces batched helper functions to compute tripwire crossings and region membership.
controller/src/controller/scene.py	Refactors tripwire/region event update logic to call the new geometry helpers.
tests/sscape_tests/geometry/test_tripwire_events.py	Adds unit tests for tripwire crossing detection across orientations and edge cases.
tests/sscape_tests/geometry/test_region_events.py	Adds unit tests for region containment across polygon/circle/scene region types.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

[ltalarcz]

In review