academe-kit 0.9.9 → 0.10.0

package/dist/index.cjs

@@ -4944,15 +4944,30 @@ function createReportService(apiClient) {
         /**
          * Get encourage dashboard for an institution
          * Retorna o payload agregado da tela /new-dashboard:
-         * overview, KPIs, licenças (alunos), jornada (cursos), submissões,
-         * desempenho por turma, top alunos e top professores.
+         * overview (com lista de períodos do ano letivo + flag isAllPeriods),
+         * KPIs, licenças (alunos), jornada (cursos do bimestre selecionado ou do
+         * ano letivo quando allPeriods), submissões do bimestre corrente,
+         * desempenho por turma, top alunos e top professores do bimestre.
          *
-         * @param id UUID da instituição.
-         */
-        getEncourageDashboardByInstitution(id) {
+         * @param id                UUID da instituição.
+         * @param params.periodId   UUID do educational_model_period. Quando omitido,
+         *                          o backend resolve para o período corrente (NOW).
+         *                          Ignorado quando allPeriods=true.
+         * @param params.allPeriods Quando true, desliga o recorte por período em
+         *                          Jornada/Classes/TopTeachers — passa a refletir
+         *                          o ano letivo inteiro. SubmissionsCard continua
+         *                          sempre no bimestre corrente.
+         */
+        getEncourageDashboardByInstitution(id, params) {
+            const query = {};
+            if (params?.allPeriods)
+                query.allPeriods = 'true';
+            else if (params?.periodId)
+                query.periodId = params.periodId;
             return apiClient.GET('/reports/encourage-dashboard/{id}', {
                 params: {
                     path: { id },
+                    query: Object.keys(query).length > 0 ? query : undefined,
                 },
             });
         },