feat: sponsor service statistics crud endpoints

app/Http/Controllers/Apis/Protected/Summit/Factories/SponsorServicesStatisticsValidationRulesFactory.php

@@ -0,0 +1,35 @@
+<?php namespace App\Http\Controllers;
+/**
+ * Copyright 2026 OpenStack Foundation
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+use App\Http\ValidationRulesFactories\AbstractValidationRulesFactory;
+/**
+ * Class SponsorServicesStatisticsValidationRulesFactory
+ * @package App\Http\Controllers
+ */
+final class SponsorServicesStatisticsValidationRulesFactory extends AbstractValidationRulesFactory
+{
+    public static function buildForAdd(array $payload = []): array
+    {
+        return [
+            'forms_qty' => 'sometimes|integer',
+            'purchases_qty' => 'sometimes|integer',
+            'pages_qty' => 'sometimes|integer',
+            'documents_qty' => 'sometimes|integer',
+        ];
+    }
+
+    public static function buildForUpdate(array $payload = []): array
+    {
+        return self::buildForAdd();
+    }
+}

app/Http/Controllers/Apis/Protected/Summit/OAuth2SummitSponsorApiController.php

@@ -4288,4 +4288,84 @@ public function updateLeadReportSettings($summit_id, $sponsor_id) {
             );
         });
     }
+
+     #[OA\Put(
+        path: "/api/v1/summits/{id}/sponsors/{sponsor_id}/sponsorservices-statistics",
+        description: "required-groups " . IGroup::SuperAdmins . ", " . IGroup::Administrators . ", " . IGroup::SummitAdministrators,
+        summary: 'Upsert Sponsor Services Statistics',
+        operationId: 'updateSponsorServicesStatistics',
+        tags: ['Sponsors'],
+        x: [
+            'required-groups' => [
+                IGroup::SuperAdmins,
+                IGroup::Administrators,
+                IGroup::SummitAdministrators,
+            ]
+        ],
+        security: [
+            [
+                'summit_sponsor_oauth2' => [
+                    SummitScopes::WriteSummitData,
+                ]
+            ]
+        ],
+        parameters: [
+            new OA\Parameter(
+                name: 'id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The summit id'
+            ),
+            new OA\Parameter(
+                name: 'sponsor_id',
+                in: 'path',
+                required: true,
+                schema: new OA\Schema(type: 'integer'),
+                description: 'The sponsor id'
+            ),
+        ],
+        requestBody: new OA\RequestBody(
+            required: true,
+            content: new OA\JsonContent(ref: "#/components/schemas/SponsorServicesStatisticsUpsertRequest")
+        ),
+        responses: [
+            new OA\Response(
+                response: Response::HTTP_CREATED,
+                description: 'Sponsor Services Statistics created/updated successfully'
+            ),
+            new OA\Response(response: Response::HTTP_UNAUTHORIZED, description: "Unauthorized"),
+            new OA\Response(response: Response::HTTP_NOT_FOUND, description: "Not Found"),
+            new OA\Response(response: Response::HTTP_INTERNAL_SERVER_ERROR, description: "Server Error"),
+            new OA\Response(response: Response::HTTP_PRECONDITION_FAILED, description: "Validation Error")
+        ]
+    )]
+    /**
+     * @param $summit_id
+     * @param $sponsor_id
+     * @return mixed
+     */
+    public function updateSponsorServicesStatistics($summit_id, $sponsor_id) {
+        return $this->processRequest(function () use ($summit_id, $sponsor_id) {
+
+            $summit = SummitFinderStrategyFactory::build($this->summit_repository, $this->resource_server_context)->find($summit_id);
+            if (is_null($summit)) return $this->error404();
+
+            $sponsor = $summit->getSummitSponsorById(intval($sponsor_id));
+            if (is_null($sponsor)) return $this->error404();
+
+            $payload = $this->getJsonPayload(SponsorServicesStatisticsValidationRulesFactory::buildForUpdate(), true);
+
+            $statistics = $this->service->updateSponsorServicesStatistics($summit, $sponsor->getId(), $payload);
+
+            return $this->updated(SerializerRegistry::getInstance()
+                ->getSerializer($statistics)
+                ->serialize(
+                    SerializerUtils::getExpand(),
+                    SerializerUtils::getFields(),
+                    SerializerUtils::getRelations()
+                )
+            );
+        });
+    }
 }

app/ModelSerializers/SerializerRegistry.php

@@ -108,6 +108,7 @@
 use App\ModelSerializers\Summit\SponsorMaterialSerializer;
 use App\ModelSerializers\Summit\SponsorSerializerV2;
 use App\ModelSerializers\Summit\SponsorSocialNetworkSerializer;
+use App\ModelSerializers\Summit\SponsorStatisticsSerializer;
 use App\ModelSerializers\Summit\SponsorUserInfoGrantSerializer;
 use App\ModelSerializers\Summit\StripePaymentProfileSerializer;
 use App\ModelSerializers\Summit\SummitAttendeeBadgeSerializer;
@@ -268,7 +269,7 @@ private function __construct()
         $this->registry['SummitSelectionPlanExtraQuestionType'] = SummitSelectionPlanExtraQuestionTypeSerializer::class;
         $this->registry['AssignedSelectionPlanExtraQuestionType'] = AssignedSelectionPlanExtraQuestionTypeSerializer::class;
         $this->registry['SelectionPlanAllowedMember'] = SelectionPlanAllowedMemberSerializer::class;
-        
+
         $this->registry['SummitWIFIConnection'] = SummitWIFIConnectionSerializer::class;
         $this->registry['SummitType'] = SummitTypeSerializer::class;
         $this->registry['SummitEventType'] = SummitEventTypeSerializer::class;
@@ -602,6 +603,7 @@ private function __construct()
         $this->registry['SponsorAd'] = SponsorAdSerializer::class;
         $this->registry['SponsorMaterial'] = SponsorMaterialSerializer::class;
         $this->registry['SponsorSocialNetwork'] = SponsorSocialNetworkSerializer::class;
+        $this->registry['SponsorStatistics'] = SponsorStatisticsSerializer::class;
 
         // locations
 
@@ -804,4 +806,4 @@ public function serialize($expand = null, array $fields = [], array $relations =
 
         return $res;
     }
-}
+}

app/ModelSerializers/Summit/SponsorBaseSerializer.php

@@ -50,6 +50,7 @@ abstract class SponsorBaseSerializer extends SilverStripeSerializer
         'CarouselAdvertiseImageAltText' => 'carousel_advertise_image_alt_text:json_string',
         'ShowLogoInEventPage' => 'show_logo_in_event_page:json_boolean',
         'LeadReportSettingId' => 'lead_report_setting_id:json_int',
+        'SponsorServicesStatisticsId' => 'sponsorservices_statistics_id:json_int',
     ];
 
 
@@ -193,5 +194,11 @@ public function serialize($expand = null, array $fields = [], array $relations =
             'getter' => 'getLeadReportSetting',
             'has' => 'hasLeadReportSetting'
         ],
+        'sponsorservices_statistics' => [
+            'type' => One2ManyExpandSerializer::class,
+            'original_attribute' => 'sponsorservices_statistics_id',
+            'getter' => 'getSponsorServicesStatistics',
+            'has' => 'hasSponsorServicesStatistics'
+        ],
     ];
-}
+}

app/ModelSerializers/Summit/SponsorSerializer.php

@@ -14,8 +14,6 @@
 
 use App\ModelSerializers\Summit\SponsorBaseSerializer;
 use Libs\ModelSerializers\AbstractSerializer;
-use Libs\ModelSerializers\Many2OneExpandSerializer;
-use Libs\ModelSerializers\One2ManyExpandSerializer;
 use models\summit\Sponsor;
 
 /**
@@ -63,11 +61,26 @@ public function serialize($expand = null, array $fields = [], array $relations =
                             }
                         }
                         break;
+                    case 'sponsorservices_statistics':
+                        {
+                            if ($sponsor->hasStatistics()) {
+                                unset($values['sponsorservices_statistics_id']);
+                                $statistics = $sponsor->getStatistics();
+                                $values['sponsorservices_statistics'] = SerializerRegistry::getInstance()->getSerializer($statistics)->serialize
+                                (
+                                    AbstractSerializer::filterExpandByPrefix($expand, $relation),
+                                    AbstractSerializer::filterFieldsByPrefix($fields, $relation),
+                                    AbstractSerializer::filterFieldsByPrefix($relations, $relation),
+                                    $params
+                                );
+                            }
+                        }
+                        break;
                 }
             }
         }
 
         return $values;
     }
 
-}
+}

app/ModelSerializers/Summit/SponsorSerializerV2.php

@@ -23,6 +23,7 @@ final class SponsorSerializerV2 extends SponsorBaseSerializer
 {
     protected static $allowed_relations = [
         'sponsorships',
+        'statistics',
     ];
 
     /**
@@ -53,6 +54,6 @@ public function serialize($expand = null, array $fields = [], array $relations =
         'sponsorships' => [
             'type' => Many2OneExpandSerializer::class,
             'getter' => 'getSponsorships',
-        ],
+        ]
     ];
-}
+}

app/ModelSerializers/Summit/SponsorStatisticsSerializer.php

@@ -0,0 +1,29 @@
+<?php namespace App\ModelSerializers\Summit;
+/*
+ * Copyright 2026 OpenStack Foundation
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+use ModelSerializers\SilverStripeSerializer;
+
+/**
+ * Class SponsorStatisticsSerializer
+ * @package App\ModelSerializers\Summit
+ */
+final class SponsorStatisticsSerializer extends SilverStripeSerializer
+{
+    protected static $array_mappings = [
+        'FormsQty' => 'forms_qty:json_int',
+        'PurchasesQty' => 'purchases_qty:json_int',
+        'PagesQty' => 'pages_qty:json_int',
+        'DocumentsQty' => 'documents_qty:json_int',
+    ];
+}

app/Models/Foundation/Summit/Factories/SponsorServicesStatisticsFactory.php

@@ -0,0 +1,58 @@
+<?php namespace App\Models\Foundation\Summit\Factories;
+/*
+ * Copyright 2026 OpenStack Foundation
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ **/
+
+use App\Models\Foundation\Summit\SponsorStatistics;
+
+/**
+ * Class SponsorServicesStatisticsFactory
+ * @package App\Models\Foundation\Summit\Factories
+ */
+final class SponsorServicesStatisticsFactory
+{
+    /**
+     * @param array $data
+     * @return SponsorStatistics
+     */
+    public static function build(array $data): SponsorStatistics
+    {
+        return self::populate(self::getNewEntity(), $data);
+    }
+
+    /**
+     * @param SponsorStatistics $settings
+     * @param array $data
+     * @return SponsorStatistics
+     */
+    public static function populate(SponsorStatistics $statistics, array $data): SponsorStatistics
+    {
+        if(isset($data['forms_qty'])) {
+            $statistics->setFormsQty(intval($data['forms_qty']));
+        }
+        if(isset($data['purchases_qty'])) {
+            $statistics->setPurchasesQty(intval($data['purchases_qty']));
+        }
+        if(isset($data['pages_qty'])) {
+            $statistics->setPagesQty(intval($data['pages_qty']));
+        }
+        if(isset($data['documents_qty'])) {
+            $statistics->setDocumentsQty(intval($data['documents_qty']));
+        }
+        return $statistics;
+    }
+
+    protected static function getNewEntity(): SponsorStatistics
+    {
+        return new SponsorStatistics;
+    }
+}