ubk.erp.webpack 1.4.2 → 1.4.3

package/README.md

@@ -787,6 +787,84 @@ const CommunicatePage = ({ token }) => {
 };
 ```
 
+### Exam
+
+| Component | Description |
+| :--- | :--- |
+|
+| `Exam` | Create an exam schedule. |
+| `ExamList` | Exam schedule list. |
+| `ExamEdit` | Edit an exam schedule. |
+| `ExamDetails` | Exam schedule details. |
+| `ExamLink` | Exam links. |
+| `ExamType` | Exam type list. |
+| `Grade` | Grade master — add, edit and delete grades with a mark range (Mark From / Mark To) and remark. |
+| `CoScholasticAreaGrade` | Co-scholastic grade master — add, edit and delete grades with a remark (no mark range). |
+| `ExamSetting` | Per exam/class report card settings: class-teacher signature per section, Exam I/C signature, report card title, marksheet issue date, promoted-to and abbreviations. |
+| `ExamInstruction` | Pick an exam and edit its instructions in a rich-text editor (bold, italic, underline, lists). Saved as HTML and printed on the admit card. |
+| `Assessment` | Assessment management. |
+| `AssignMarks` | Enter exam marks for students. |
+| `CoScholasticAreaMarks` | Search by Class / Section / Exam / Co-Scholastic Category, then enter a grade per student per skill and save. |
+| `StudentResult` | Search by Class / Section / Exam to see each student's marks, percentage, marks-entry progress, meetings and attendance. Edit remarks, meeting dates, attendance and result per student. |
+| `MarksReport` | Marks report. |
+| `AdmitCardSetting` | Admit card settings (photo, room no, subject list, exam time, invigilator and Exam I/C signature toggles). |
+| `AdmitPrint` | Search by Class / Section / Exam and print admit cards using one of three templates. The class's assigned template is preselected. |
+| `RoomManagment` | Add/delete exam rooms, and assign rooms with roll-number ranges per section for a class and exam. |
+
+### Using the Exam Module
+
+```jsx
+import {
+  Grade,
+  CoScholasticAreaGrade,
+  ExamSetting,
+  ExamInstruction,
+  CoScholasticAreaMarks,
+  StudentResult,
+  AdmitPrint,
+  RoomManagment,
+} from "ubk.erp.webpack";
+
+const ExamPage = ({ token }) => {
+  return (
+    <>
+      <Grade token={token} />
+      <CoScholasticAreaGrade token={token} />
+      <ExamSetting token={token} />
+      <ExamInstruction token={token} />
+      <CoScholasticAreaMarks token={token} />
+      <StudentResult token={token} />
+      <AdmitPrint token={token} />
+      <RoomManagment token={token} />
+    </>
+  );
+};
+```
+
+**Notes:**
+- `AdmitPrint` reads the session name from `localStorage.academy_session` (templates 2 and 3). Set it in the host app, otherwise the session shows as blank / `-`.
+- `AdmitPrint` requests `per_page=10` students per search.
+- The **View Result** button in `StudentResult` navigates to `/ExamDashboard/SingleResult?id=…&exam_id=…`, which is not part of this library yet.
+- `RoomManagment` is spelled as in the original project (no "e" after "g").
+
+**Endpoint overrides** — each Exam endpoint has a built-in default and can be overridden with a `VITE_*` variable in `.env`, for example:
+
+| Variable | Default |
+| :--- | :--- |
+| `VITE_GRADE_TABLE_URL` / `_ADD_URL` / `_EDIT_URL` / `_DELETE_URL` | `/api/exam/exam/getgradeTable`, `addGrade`, `editGradec`, `deleteGrade` |
+| `VITE_COSCHOLASTIC_GRADE_TABLE_URL` / `_ADD_URL` / `_EDIT_URL` / `_DELETE_URL` | `/api/exam/exam/getgradeTableCoScholastic`, `addGradeCoScholastic`, `editGradeCoScholastic`, `deleteGradeCoScholastic` |
+| `VITE_COSCHOLASTIC_GRADE_DROPDOWN_URL` | `/api/exam/exam/gradeDropdownCoScholastic` |
+| `VITE_COSCHOLASTIC_ASSIGN_MARKS_URL` | `/api/exam/exam/assignCoscholasticMarks` |
+| `VITE_COSCHOLASTIC_CATEGORY_DROPDOWN_URL` | `/api/branchapi/academy/getscholasticCategoryByClassId` |
+| `VITE_EXAM_SETTING_UPLOAD_FILE_URL` | `api/SuperAdmin/uploadFile` (signature uploads, saved to `schoolFile`) |
+| `VITE_EXAM_ROOM_LIST_URL` / `_DELETE_URL` | `/api/exam/Exam/listClassRoom`, `/api/exam/Exam/removeClassRoom` |
+| `VITE_EXAM_ROOM_ADD_URL` | `/api/exam/exam/addClassRoom` |
+| `VITE_EXAM_ROOM_ASSIGNED_LIST_URL` | `/api/exam/Exam/getClassRoomdata` |
+| `VITE_EXAM_ROOM_ASSIGN_URL` / `_REMOVE_URL` | `/api/exam/exam/assignClassRoom`, `/api/exam/exam/remove_exam_class_room` |
+| `VITE_EXAM_ROOM_DROPDOWN_URL` / `_EXAM_DROPDOWN_URL` | `/api/exam/exam/roomDropdown`, `examdropdown_new` |
+
+See `src/Layout/Exam/Services/examsService.js` for the full list.
+
 
 
 ## 🛠️ Development

package/dist/Layout/Exam/AdmitPrint.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default AdmitPrint;
+declare function AdmitPrint({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/CoScholasticAreaGrade.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default CoScholasticAreaGrade;
+declare function CoScholasticAreaGrade({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Components/AdmitCardTemplates.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+export function templateOptionAdmit(): {
+    label: string;
+    value: string;
+}[];
+export function buildTemplateContext(data: any): {
+    academy_session: any;
+    exam_details: any;
+    receipt_info: any;
+    general_setting: any;
+    students: any;
+    settings: any;
+};
+export default AdmitCardTemplate;
+declare function AdmitCardTemplate({ templateId, data }: {
+    templateId: any;
+    data: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Components/AssignClassRoomEditor.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+export default AssignClassRoomEditor;
+/**
+ * Add mode (no rowData): pick class + exam, then fill roll ranges per section.
+ * Update mode (rowData = an assigned-room record): locked to that record's class, exam and section.
+ * Calls onSubmit(formData) with class_id, exam_id, the row arrays and added/updated/deleted JSON.
+ */
+declare function AssignClassRoomEditor({ token, rowData, onSubmit }: {
+    token: any;
+    rowData: any;
+    onSubmit: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Grade.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default Grade;
+declare function Grade({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/AdmitPrintPage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default AdmitPrintPage;
+declare function AdmitPrintPage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/CoScholasticAreaGradePage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default CoScholasticAreaGradePage;
+declare function CoScholasticAreaGradePage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Pages/GradePage.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export default GradePage;
+declare function GradePage({ token }: {
+    token: any;
+}): React.JSX.Element;

package/dist/Layout/Exam/Services/examsService.d.ts

@@ -6,11 +6,31 @@ export namespace endpoints {
         let edit: any;
         let remove: any;
     }
-    export namespace examSchedule {
+    export namespace grade {
+        let table_1: any;
+        export { table_1 as table };
         let add_1: any;
         export { add_1 as add };
         let edit_1: any;
         export { edit_1 as edit };
+        let remove_1: any;
+        export { remove_1 as remove };
+    }
+    export namespace coScholasticGrade {
+        let table_2: any;
+        export { table_2 as table };
+        let add_2: any;
+        export { add_2 as add };
+        let edit_2: any;
+        export { edit_2 as edit };
+        let remove_2: any;
+        export { remove_2 as remove };
+    }
+    export namespace examSchedule {
+        let add_3: any;
+        export { add_3 as add };
+        let edit_3: any;
+        export { edit_3 as edit };
         export let getById: any;
         export let list: any;
         let dropdown_1: any;
@@ -29,17 +49,17 @@ export namespace endpoints {
         export let update: any;
     }
     export namespace examSetting {
-        let table_1: any;
-        export { table_1 as table };
-        let add_2: any;
-        export { add_2 as add };
+        let table_3: any;
+        export { table_3 as table };
+        let add_4: any;
+        export { add_4 as add };
         export let uploadSignature: any;
         export let typeByExamId: any;
         export let assignMarksheetClass: any;
     }
     export namespace assessment {
-        let table_2: any;
-        export { table_2 as table };
+        let table_4: any;
+        export { table_4 as table };
         let dropdown_3: any;
         export { dropdown_3 as dropdown };
         let _delete: any;
@@ -62,6 +82,7 @@ export namespace endpoints {
         let getGradeTable: any;
         let getGradeTableCoScholastic: any;
         let getAdmitCard: any;
+        let subjectDropdown: any;
     }
     export namespace admitCardSetting {
         let get_1: any;
@@ -72,14 +93,18 @@ export namespace endpoints {
     export namespace roomManagement {
         let list_1: any;
         export { list_1 as list };
-        let remove_1: any;
-        export { remove_1 as remove };
+        export let removeRoom: any;
+        export let assignedList: any;
+        export let examDropdown: any;
+        let remove_3: any;
+        export { remove_3 as remove };
         export let assign: any;
-        let add_3: any;
-        export { add_3 as add };
+        let add_5: any;
+        export { add_5 as add };
         export let roomDropdown: any;
     }
-    export let examDropdown: any;
+    let examDropdown_1: any;
+    export { examDropdown_1 as examDropdown };
     export let examDropdownInstruction: any;
     export namespace observation {
         let dropdown_4: any;
@@ -89,19 +114,24 @@ export namespace endpoints {
         export let deleteType: any;
         export let editType: any;
         export let addType: any;
-        let add_4: any;
-        export { add_4 as add };
+        let add_6: any;
+        export { add_6 as add };
     }
     export let coscholasticCategoryDropdown: any;
+    export namespace coScholasticMarks {
+        export let gradeDropdown: any;
+        let assign_1: any;
+        export { assign_1 as assign };
+    }
     export namespace templateType {
         let get_2: any;
         export { get_2 as get };
         export let assignClassDropdown: any;
         export let assignTable: any;
-        let assign_1: any;
-        export { assign_1 as assign };
-        let remove_2: any;
-        export { remove_2 as remove };
+        let assign_2: any;
+        export { assign_2 as assign };
+        let remove_4: any;
+        export { remove_4 as remove };
     }
     export let classSubjectDropdown: any;
     export let sectionDropdown: any;

package/dist/Layout/Exam/hooks.d.ts

@@ -1,35 +1,10 @@
-export function useExamTypeDropdown(token: any): {
-    isLoading: boolean;
-    error: any;
-    examTypeOptions: any;
-};
-export function useExamDropdown(classId: any, token: any): {
-    isLoading: boolean;
-    error: any;
-    examList: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useExamSchedule(token: any): {
-    isLoading: boolean;
-    error: any;
-    examSchedule: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useAssessmentTable(token: any): {
-    isLoading: boolean;
-    error: any;
-    assessmentData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useExamSettingTable(page: any, perPage: any, token: any): {
-    isLoading: boolean;
-    error: any;
-    examSettingData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
-export function useStudentResult(token: any): {
-    isLoading: boolean;
-    error: any;
-    studentResultData: any;
-    mutate: import('swr').KeyedMutator<any>;
-};
+export function useSubmit(handler: any): (boolean | ((...args: any[]) => Promise<any>))[];
+export function usePaginatedFetcher(): {
+    fetchAllPagesWithProgress: (tableData: any, exam_id: any, onProgress: any, token: any) => Promise<any[]>;
+    isMutating: boolean;
+};
+declare namespace _default {
+    export { useSubmit };
+    export { usePaginatedFetcher };
+}
+export default _default;

package/dist/Layout/Exam/index.d.ts

@@ -2,6 +2,9 @@ export { default as StudentResult } from './StudentResult';
 export { default as Exam } from './Exam';
 export { default as ExamList } from './ExamList';
 export { default as ExamType } from './ExamType';
+export { default as Grade } from './Grade';
+export { default as AdmitPrint } from './AdmitPrint';
+export { default as CoScholasticAreaGrade } from './CoScholasticAreaGrade';
 export { default as ExamSetting } from './ExamSetting';
 export { default as Assessment } from './Assessment';
 export { default as ExamInstruction } from './ExamInstruction';