fix: expose complete dataset period catalog

docs/openapi.yaml

@@ -136,9 +136,11 @@ paths:
       operationId: listAnalyticsPeriods
       summary: List approved reporting periods
       description: |
-        Returns allowlisted periods with server-calculated UTC and Tehran-local
-        half-open boundaries. Clients start runs with a returned `periodId` and
-        never submit arbitrary timestamps.
+        Returns every complete allowlisted day, Iranian week, Jalali month, and
+        Persian season inside the imported dataset's local-date coverage, with
+        server-calculated UTC and Tehran-local half-open boundaries. Periods are
+        grouped by type and ordered newest-first inside each group. Clients start
+        runs with a returned `periodId` and never submit arbitrary timestamps.
       parameters:
         - name: periodType
           in: query
@@ -1090,6 +1092,7 @@ components:
           $ref: '#/components/schemas/PeriodId'
         periods:
           type: array
+          description: Dataset-bounded complete periods, grouped by type and newest-first within each group.
           maxItems: 1000
           items:
             $ref: '#/components/schemas/ReportingPeriod'