feat(api): update endpoints to use franchisee-specific routes for dashboard, holidays, students, contracts, and media

feat(permissions): enhance permission checks for contracts and student-related actions
fix(navigation): adjust navigation permissions for ContractsPage

src/api/franchisee_dashboard.js

@@ -0,0 +1,6 @@
+import api from "src/api";
+
+export const getDashboardSummary = async () => {
+  const { data } = await api.get("/franchisee/dashboard/summary");
+  return data.payload;
+};

src/api/holiday.js

@@ -1,21 +1,21 @@
 import api from "src/api";
 
 export const getHolidays = async () => {
-  const { data } = await api.get("/holiday");
+  const { data } = await api.get("/franchisee/dashboard/holidays");
   return data.payload;
 };
 
 export const createHoliday = async (holiday) => {
-  const { data } = await api.post("/holiday", holiday);
+  const { data } = await api.post("/franchisee/dashboard/holidays", holiday);
   return data.payload;
 };
 
 export const updateHoliday = async (holiday, id) => {
-  const { data } = await api.put(`/holiday/${id}`, holiday);
+  const { data } = await api.put(`/franchisee/dashboard/holidays/${id}`, holiday);
   return data.payload;
 };
 
 export const deleteHoliday = async (id) => {
-  const { data } = await api.delete(`/holiday/${id}`);
+  const { data } = await api.delete(`/franchisee/dashboard/holidays/${id}`);
   return data.payload;
 };

src/api/student.js

@@ -1,31 +1,31 @@
 import api from "src/api";
 
 export const getStudents = async (params = {}) => {
-  const { data } = await api.get("/student", { params });
+  const { data } = await api.get("/franchisee/students", { params });
   return data.payload;
 };
 
 export const getStudent = async (id) => {
-  const { data } = await api.get(`/student/${id}`);
+  const { data } = await api.get(`/franchisee/students/${id}`);
   return data.payload;
 };
 
 export const createStudent = async (student) => {
-  const { data } = await api.post("/student", student);
+  const { data } = await api.post("/franchisee/students", student);
   return data.payload;
 };
 
 export const updateStudent = async (payload, id) => {
   if (payload instanceof FormData) {
     payload.append('_method', 'PUT');
-    const { data } = await api.post(`/student/${id}`, payload);
+    const { data } = await api.post(`/franchisee/students/${id}`, payload);
     return data.payload;
   }
-  const { data } = await api.put(`/student/${id}`, payload);
+  const { data } = await api.put(`/franchisee/students/${id}`, payload);
   return data.payload;
 };
 
 export const deleteStudent = async (id) => {
-  const { data } = await api.delete(`/student/${id}`);
+  const { data } = await api.delete(`/franchisee/students/${id}`);
   return data.payload;
 };

src/api/studentContract.js

@@ -1,57 +1,57 @@
 import api from "src/api";
 
 export const getStudentContractById = async (id) => {
-  const { data } = await api.get(`/student-contract/${id}`);
+  const { data } = await api.get(`/franchisee/contracts/${id}`);
   return data.payload;
 };
 
 export const getStudentContracts = async (studentId) => {
-  const { data } = await api.get("/student-contract", { params: { student_id: studentId } });
+  const { data } = await api.get("/franchisee/contracts", { params: { student_id: studentId } });
   return data.payload;
 };
 
 export const getAllContracts = async () => {
-  const { data } = await api.get("/student-contract");
+  const { data } = await api.get("/franchisee/contracts");
   return data.payload;
 };
 
 export const createStudentContract = async (payload) => {
-  const { data } = await api.post("/student-contract", payload);
+  const { data } = await api.post("/franchisee/contracts", payload);
   return data.payload;
 };
 
 export const updateStudentContract = async (id, payload) => {
-  const { data } = await api.put(`/student-contract/${id}`, payload);
+  const { data } = await api.put(`/franchisee/contracts/${id}`, payload);
   return data.payload;
 };
 
 export const attachContractFile = async (id, formData) => {
-  const { data } = await api.post(`/student-contract/${id}/file`, formData, {
+  const { data } = await api.post(`/franchisee/contracts/${id}/file`, formData, {
     headers: { "Content-Type": "multipart/form-data" },
   });
   return data.payload;
 };
 
 export const getContractInstallments = async (id) => {
-  const { data } = await api.get(`/student-contract/${id}/installments`);
+  const { data } = await api.get(`/franchisee/contracts/${id}/installments`);
   return data.payload;
 };
 
 export const freezeContract = async (id, months) => {
-  const { data } = await api.post(`/student-contract/${id}/freeze`, { months });
+  const { data } = await api.post(`/franchisee/contracts/${id}/freeze`, { months });
   return data.payload;
 };
 
 export const cancelContract = async (id) => {
-  const { data } = await api.post(`/student-contract/${id}/cancel`);
+  const { data } = await api.post(`/franchisee/contracts/${id}/cancel`);
   return data.payload;
 };
 
 export const reactivateContract = async (id) => {
-  const { data } = await api.post(`/student-contract/${id}/reactivate`);
+  const { data } = await api.post(`/franchisee/contracts/${id}/reactivate`);
   return data.payload;
 };
 
 export const deleteStudentContract = async (id) => {
-  await api.delete(`/student-contract/${id}`);
+  await api.delete(`/franchisee/contracts/${id}`);
 };

src/api/studentResponsible.js

@@ -1,21 +1,21 @@
 import api from "src/api";
 
 export const getStudentResponsible = async (studentId) => {
-  const { data } = await api.get(`/student/${studentId}/responsible`);
+  const { data } = await api.get(`/franchisee/students/${studentId}/responsible`);
   return data.payload;
 };
 
 export const createStudentResponsible = async (payload) => {
-  const { data } = await api.post("/student-responsible", payload);
+  const { data } = await api.post("/franchisee/students/responsibles", payload);
   return data.payload;
 };
 
 export const updateStudentResponsible = async (id, payload) => {
-  const { data } = await api.put(`/student-responsible/${id}`, payload);
+  const { data } = await api.put(`/franchisee/students/responsibles/${id}`, payload);
   return data.payload;
 };
 
 export const deleteStudentResponsible = async (id) => {
-  const { data } = await api.delete(`/student-responsible/${id}`);
+  const { data } = await api.delete(`/franchisee/students/responsibles/${id}`);
   return data.payload;
 };

src/api/student_media.js

@@ -1,17 +1,22 @@
 import api from "src/api";
 
 export const getStudentMedias = async (studentId) => {
-  const { data } = await api.get("/student-media", { params: { student_id: studentId } });
+  const { data } = await api.get("/franchisee/students/medias", { params: { student_id: studentId } });
   return data.payload;
 };
 
 export const getContractMedias = async (contractId) => {
-  const { data } = await api.get("/student-media", { params: { student_contract_id: contractId } });
+  const { data } = await api.get("/franchisee/contracts/medias", { params: { student_contract_id: contractId } });
   return data.payload;
 };
 
+export const deleteContractMedia = async (id) => {
+  const { data } = await api.delete(`/franchisee/contracts/medias/${id}`);
+  return data;
+};
+
 export const createStudentMedia = async (formData) => {
-  const { data } = await api.post("/student-media", formData, {
+  const { data } = await api.post("/franchisee/students/medias", formData, {
     headers: { "Content-Type": "multipart/form-data" },
   });
   return data.payload;
@@ -19,13 +24,13 @@ export const createStudentMedia = async (formData) => {
 
 export const updateStudentMedia = async (id, formData) => {
   formData.append("_method", "PUT");
-  const { data } = await api.post(`/student-media/${id}`, formData, {
+  const { data } = await api.post(`/franchisee/students/medias/${id}`, formData, {
     headers: { "Content-Type": "multipart/form-data" },
   });
   return data.payload;
 };
 
 export const deleteStudentMedia = async (id) => {
-  const { data } = await api.delete(`/student-media/${id}`);
+  const { data } = await api.delete(`/franchisee/students/medias/${id}`);
   return data;
 };

src/pages/contracts/ContractsPage.vue

@@ -63,6 +63,7 @@
               @click.prevent.stop="handleView(row)"
             />
             <q-btn
+              v-if="canEdit"
               outline
               icon="mdi-dots-vertical"
               style="width: 36px"
@@ -113,6 +114,7 @@ import DefaultHeaderPage from "src/components/layout/DefaultHeaderPage.vue";
 import DefaultTable from "src/components/defaults/DefaultTable.vue";
 import DashboardStatCard from "src/components/charts/DashboardStatCard.vue";
 import { userStore } from "src/stores/user";
+import { permissionStore } from "src/stores/permission";
 import ContractActionConfirmDialog from "src/pages/students/components/ContractActionConfirmDialog.vue";
 import FreezeContractDialog from "src/pages/students/components/FreezeContractDialog.vue";
 import ViewContractDialog from "src/pages/students/components/ViewContractDialog.vue";
@@ -124,6 +126,10 @@ import {
 
 const $q = useQuasar();
 const store = userStore();
+const permissions = permissionStore();
+const canEdit = computed(() =>
+  permissions.getAccess("franchisee_contracts", "edit"),
+);
 const rows = ref([]);
 const isLoading = ref(false);
 

src/pages/dashboard/DashboardPage.vue

@@ -85,7 +85,7 @@
             <q-separator />
             <q-card-section class="q-pt-md column q-gutter-sm">
               <q-btn
-                v-if="canAdd"
+                v-if="canAddContracts"
                 unelevated
                 color="primary"
                 label="Criar contrato"
@@ -94,7 +94,7 @@
                 @click="onCriarContrato"
               />
               <q-btn
-                v-if="canEdit"
+                v-if="canEditClasses"
                 unelevated
                 color="primary"
                 label="Registrar presença"
@@ -103,7 +103,7 @@
                 @click="onRegistrarPresenca"
               />
               <q-btn
-                v-if="canAdd"
+                v-if="canAddOrders"
                 unelevated
                 color="primary"
                 label="Novo pedido"
@@ -207,8 +207,7 @@ import AniversariantesCard from "src/components/charts/AniversariantesCard.vue";
 import FeriadosDialog from "./components/FeriadosDialog.vue";
 import FeriadosEditDialog from "./components/FeriadosEditDialog.vue";
 import { getHolidays } from "src/api/holiday";
-import { getStudents } from "src/api/student";
-import { getAllContracts } from "src/api/studentContract";
+import { getDashboardSummary } from "src/api/franchisee_dashboard";
 import { userStore } from "src/stores/user";
 import { permissionStore } from "src/stores/permission";
 
@@ -220,8 +219,14 @@ const permissions = permissionStore();
 const canAdd = computed(() =>
   permissions.getAccess("franchisee_dashboard", "add"),
 );
-const canEdit = computed(() =>
-  permissions.getAccess("franchisee_dashboard", "edit"),
+const canAddContracts = computed(() =>
+  permissions.getAccess("franchisee_contracts", "add"),
+);
+const canEditClasses = computed(() =>
+  permissions.getAccess("franchisee_classes", "edit"),
+);
+const canAddOrders = computed(() =>
+  permissions.getAccess("franchisee_orders", "add"),
 );
 
 // Faturamento Serviço / Materiais — zerado (sem fluxo de dados ainda),
@@ -326,19 +331,7 @@ const activeContracts = ref(0);
 const students = ref([]);
 
 // Aniversariantes do mês corrente (dia + nome), ordenados por dia.
-const aniversariantes = computed(() => {
-  const month = new Date().getMonth() + 1;
-  return students.value
-    .filter((s) => {
-      if (!s.birth_date) return false;
-      return new Date(s.birth_date + "T00:00:00").getMonth() + 1 === month;
-    })
-    .map((s) => ({
-      day: new Date(s.birth_date + "T00:00:00").getDate(),
-      name: s.name,
-    }))
-    .sort((a, b) => a.day - b.day);
-});
+const aniversariantes = ref([]);
 
 // Matrículas por Período — alunos cadastrados (created_at) nos últimos 6 meses,
 // terminando no mês atual.
@@ -369,22 +362,17 @@ const matriculasChart = computed(() => {
   };
 });
 
-async function fetchAlunos() {
-  try {
-    students.value = await getStudents();
-    totalAlunos.value = students.value.length;
-  } catch {
-    // silencioso
-  }
-}
-
-async function fetchContracts() {
+async function fetchSummary() {
   try {
-    const contracts = await getAllContracts();
-    activeContracts.value = contracts.filter((c) => c.status === "active").length;
-    // Posiciona a agulha do medidor na quantidade de contratos ativos
-    // (escala de 0 a 10; valores maiores ficam no topo da escala).
-    gaugeData.value.datasets[0].needleValue = Math.min(activeContracts.value, 10);
+    const summary = await getDashboardSummary();
+    students.value = summary.enrollments;
+    totalAlunos.value = summary.students_count;
+    activeContracts.value = summary.contracts.active;
+    aniversariantes.value = summary.birthdays;
+    gaugeData.value.datasets[0].needleValue = Math.min(
+      activeContracts.value,
+      10,
+    );
   } catch {
     // silencioso
   }
@@ -464,8 +452,7 @@ watch(
   () => store.selectedUnit?.id,
   (newId, oldId) => {
     if (newId && newId !== oldId) {
-      fetchAlunos();
-      fetchContracts();
+      fetchSummary();
       fetchHolidays();
     }
   },
@@ -473,8 +460,7 @@ watch(
 
 onMounted(() => {
   fetchHolidays();
-  fetchAlunos();
-  fetchContracts();
+  fetchSummary();
 });
 </script>
 

src/pages/students/components/AddEditContractDialog.vue

@@ -369,7 +369,7 @@ import {
   createStudentContract,
   updateStudentContract,
 } from "src/api/studentContract";
-import { getContractMedias, deleteStudentMedia } from "src/api/student_media";
+import { getContractMedias, deleteContractMedia } from "src/api/student_media";
 
 const props = defineProps({
   student: {
@@ -548,7 +548,7 @@ function handleDeleteMedia(media) {
     cancel: { color: "primary", outline: true, label: "Cancelar" },
   }).onOk(async () => {
     try {
-      await deleteStudentMedia(media.id);
+      await deleteContractMedia(media.id);
       medias.value = medias.value.filter((m) => m.id !== media.id);
     } catch (e) {
       console.error(e);

src/pages/students/components/EditStudentDialog.vue

@@ -21,7 +21,7 @@
           <ResponsibleTab :student-id="props.student.id" />
         </div>
 
-        <div v-show="currentTab === 'contracts'">
+        <div v-if="canViewContracts" v-show="currentTab === 'contracts'">
           <ContractTab :student="props.student" />
         </div>
 
@@ -55,12 +55,13 @@
 </template>
 
 <script setup>
-import { ref, watch, useTemplateRef, defineAsyncComponent } from "vue";
+import { computed, ref, watch, useTemplateRef, defineAsyncComponent } from "vue";
 import { useDialogPluginComponent } from "quasar";
 import DefaultDialogHeader from "src/components/defaults/DefaultDialogHeader.vue";
 import CustomTabComponent from "src/components/shared/CustomTabComponent.vue";
 import { useSubmitHandler } from "src/composables/useSubmitHandler";
 import { updateStudent } from "src/api/student";
+import { permissionStore } from "src/stores/permission";
 
 const StudentDataTab = defineAsyncComponent(
   () => import("src/pages/students/tabs/StudentDataTab.vue"),
@@ -94,6 +95,10 @@ const studentDataTabRef = useTemplateRef("studentDataTabRef");
 const mediaTabRef = useTemplateRef("mediaTabRef");
 
 const currentTab = ref("profile");
+const permissions = permissionStore();
+const canViewContracts = computed(() =>
+  permissions.getAccess("franchisee_contracts", "view"),
+);
 
 watch(currentTab, (tab) => {
   if (tab === "media") mediaTabRef.value?.refresh();
@@ -103,13 +108,15 @@ const { loading: saving, execute } = useSubmitHandler({
   onSuccess: () => onDialogOK(true),
 });
 
-const tabs = [
+const tabs = computed(() => [
   { name: "profile", label: "Perfil do Aluno" },
   { name: "responsible", label: "Responsáveis" },
-  { name: "contracts", label: "Contratos" },
+  ...(canViewContracts.value
+    ? [{ name: "contracts", label: "Contratos" }]
+    : []),
   { name: "history", label: "Frequência" },
   { name: "media", label: "Mídias" },
-];
+]);
 
 async function handleSave() {
   const valid = await (studentDataTabRef.value?.validate() ?? true);

src/pages/students/tabs/ContractTab.vue

@@ -118,8 +118,8 @@ const props = defineProps({
 
 const $q = useQuasar();
 const permissions = permissionStore();
-const canAdd = computed(() => permissions.getAccess("franchisee_students", "add"));
-const canEdit = computed(() => permissions.getAccess("franchisee_students", "edit"));
+const canAdd = computed(() => permissions.getAccess("franchisee_contracts", "add"));
+const canEdit = computed(() => permissions.getAccess("franchisee_contracts", "edit"));
 const rows = ref([]);
 const fileInputRef = ref(null);
 const uploadingId = ref(null);

src/router/routes/config.route.js

@@ -6,6 +6,7 @@ export default [
     meta: {
       title: "Contratos",
       requireAuth: true,
+      requiredPermission: "franchisee_contracts",
       breadcrumbs: [
         {
           name: "ContractsPage",

src/stores/navigation.js

@@ -28,7 +28,8 @@ export const navigationStore = defineStore("navigation", () => {
       name: "ContractsPage",
       icon: "mdi-file-document-outline",
       disable: false,
-      permission: true,
+      permission: false,
+      permissionScope: "franchisee_contracts",
     },
     {
       type: "single",