[IMP] alerts v2 consolidation — merge alerts_filters blueprint into /api/v2/alerts/filters, add v2 endpoints for escalate/merge/unmerge/batch, mark legacy alerts_routes counterparts deprecated, business layer gains alerts_escalate/merge/unmerge/batch_* helpers

Author: whitekernel

source/app/blueprints/rest/alerts_routes.py

@@ -421,6 +421,7 @@ def alerts_update_route(alert_id) -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/batch/update', methods=['POST'])
+@endpoint_deprecated('PUT', '/api/v2/alerts/{identifier} (repeated per alert)')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_batch_update_route() -> Response:
     """
@@ -500,6 +501,7 @@ def alerts_batch_update_route() -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/batch/delete', methods=['POST'])
+@endpoint_deprecated('DELETE', '/api/v2/alerts/{identifier} (repeated per alert)')
 @ac_api_requires(Permissions.alerts_delete)
 def alerts_batch_delete_route() -> Response:
     """
@@ -592,6 +594,7 @@ def alerts_delete_route(alert_id) -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/escalate/<int:alert_id>', methods=['POST'])
+@endpoint_deprecated('POST', '/api/v2/alerts/escalate/{identifier}')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_escalate_route(alert_id) -> Response:
     """
@@ -663,6 +666,7 @@ def alerts_escalate_route(alert_id) -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/merge/<int:alert_id>', methods=['POST'])
+@endpoint_deprecated('POST', '/api/v2/alerts/merge/{identifier}')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_merge_route(alert_id) -> Response:
     """
@@ -730,6 +734,7 @@ def alerts_merge_route(alert_id) -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/unmerge/<int:alert_id>', methods=['POST'])
+@endpoint_deprecated('POST', '/api/v2/alerts/unmerge/{identifier}')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_unmerge_route(alert_id) -> Response:
     """
@@ -786,6 +791,7 @@ def alerts_unmerge_route(alert_id) -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/batch/merge', methods=['POST'])
+@endpoint_deprecated('POST', '/api/v2/alerts/batch/merge')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_batch_merge_route() -> Response:
     """
@@ -863,6 +869,7 @@ def alerts_batch_merge_route() -> Response:
 
 
 @alerts_rest_blueprint.route('/alerts/batch/escalate', methods=['POST'])
+@endpoint_deprecated('POST', '/api/v2/alerts/batch/escalate')
 @ac_api_requires(Permissions.alerts_write)
 def alerts_batch_escalate_route() -> Response:
     """
@@ -966,6 +973,7 @@ def alert_comments_get(alert_id):
 
 
 @alerts_rest_blueprint.route('/alerts/<int:alert_id>/comments/<int:com_id>/delete', methods=['POST'])
+@endpoint_deprecated('DELETE', '/api/v2/alerts/{alert_identifier}/comments/{identifier}')
 @ac_api_requires(Permissions.alerts_write)
 def alert_comment_delete(alert_id, com_id):
     """
@@ -1029,6 +1037,7 @@ def alert_comment_get(alert_id, com_id):
 
 
 @alerts_rest_blueprint.route('/alerts/<int:alert_id>/comments/<int:com_id>/edit', methods=['POST'])
+@endpoint_deprecated('PUT', '/api/v2/alerts/{alert_identifier}/comments/{identifier}')
 @ac_api_requires(Permissions.alerts_write)
 def alert_comment_edit(alert_id, com_id):
     """

source/app/blueprints/rest/api_v2_routes.py

@@ -36,7 +36,6 @@
 from app.blueprints.rest.v2.tasks import tasks_blueprint
 from app.blueprints.rest.v2.profile import profile_blueprint
 from app.blueprints.rest.v2.search import search_blueprint
-from app.blueprints.rest.v2.alerts_filters import alerts_filters_blueprint
 from app.blueprints.rest.v2.avatars import admin_avatar_blueprint
 from app.blueprints.rest.v2.avatars import me_avatar_blueprint
 from app.blueprints.rest.v2.avatars import users_public_blueprint
@@ -70,7 +69,6 @@
 rest_v2_blueprint.register_blueprint(tags_blueprint)
 rest_v2_blueprint.register_blueprint(profile_blueprint)
 rest_v2_blueprint.register_blueprint(search_blueprint)
-rest_v2_blueprint.register_blueprint(alerts_filters_blueprint)
 rest_v2_blueprint.register_blueprint(cases_filters_blueprint)
 rest_v2_blueprint.register_blueprint(users_public_blueprint)
 rest_v2_blueprint.register_blueprint(me_avatar_blueprint)