ubk.erp.webpack 1.4.2 → 1.4.4

package/README.md

@@ -562,15 +562,22 @@ const LibraryPage = ({ token }) => {
 import { AddStaff } from "ubk.erp.webpack";
 
 const AddStaffPage = ({ token }) => {
+  const handleStepComplete = (payload) => {
+    // Fires after Basic, Experience and Payroll each save successfully
+    console.log("Step saved:", payload.step, payload.staffId, payload.data);
+  };
+
   const handleFinished = (rec) => {
-    // Optionally refresh staff list or show a notification
-    console.log("Staff created successfully",rec);
+    // Fires once, after the final (Payroll) step saves
+    console.log("Staff created successfully", rec.staffId, rec);
   };
 
-  return <AddStaff token={token} onFinished={handleFinished} />;
+  return <AddStaff token={token} onStepComplete={handleStepComplete} onFinished={handleFinished} />;
 };
 ```
 
+`AddStaff` accepts the same callbacks as `StaffWizard` (`onStepComplete`, `onReturn`, `onFinished`) — see **StaffWizard — Return Callback** below. `onFinished` is only called after all three steps are saved.
+
 ### Store
 
 | Component | Description |
@@ -617,6 +624,7 @@ const AddStaffPage = ({ token }) => {
 | `onNavigate` | `(action: string, record: object) => void` | No | Called when the Edit button is clicked. Receives `("staff-edit", record)`. If provided, the parent handles navigation. |
 | `onFinished` | `(res: any) => void` | No | Called after the wizard (edit drawer) completes successfully. |
 | `onDelete` | `(payload: DeletePayload) => void` | No | Called after a staff member is deactivated. |
+| `onPasswordChange` | `(payload: PasswordChangePayload) => void` | No | Called after a staff member's password is changed successfully. Receives `{ id, password, record, response }` — `password` is the new password as entered, `response` is the API response from `updateStaffPassword`. |
 
 ## DeletePayload Shape
 
@@ -632,6 +640,7 @@ const AddStaffPage = ({ token }) => {
 
 - Clicking the **Edit** button: if `onNavigate` is provided, it calls `onNavigate("staff-edit", record)`. Otherwise, opens an inline edit drawer with `StaffWizard` in `mode="edit"`.
 - Clicking **Delete/Deactivate**: sends a deactivate request to the API. On success, refreshes the list and calls `onDelete({ id, record, response })`.
+- Clicking **Change password** (key icon): opens a modal with New Password + Confirm Password. On save it posts `{ staff_id, new_passwod }` to `api/branchapi/staff/updateStaffPassword` (override with `VITE_HR_STAFF_CHANGE_PASSWORD_URL`), then calls `onPasswordChange({ id, password, record, response })`.
 - `onFinished` fires after the edit wizard completes successfully, allowing the parent to refresh its own data.
 
 ## Usage
@@ -674,24 +683,26 @@ const StaffPage = ({ token }) => {
 | `mode` | `'add' \| 'edit'` | No | Determines whether basic info is edited or created. Default: `"add"`. |
 | `staffId` | `string` | No | Staff ID when editing; ignored when `mode="add"`. |
 | `onStepComplete` | `(payload: object) => void` | No | Called after **every** step's successful save. |
-| `onFinished` | `() => void` | No | Called after the final (Payroll) step completes. |
+| `onReturn` | `(payload: object) => void` | No | Alias of `onStepComplete` — receives the same payload. |
+| `onFinished` | `(result: object) => void` | No | Called after the final (Payroll) step completes. Receives `{ staffId, payroll, result, data }`. |
 
 ## Payload Shape
 
-The `onStepComplete` callback receives an object:
+The `onStepComplete` / `onReturn` callback receives an object:
 
 ```ts
 {
   step: "basic" | "experience" | "payroll";
-  data?: object;   // Step-specific data
+  staffId: string | number | null; // id of the staff being created/edited
+  data: object;                    // Step-specific data (below)
 }
 ```
 
 | Step | `data` contents |
 | :--- | :--- |
-| `"basic"` | `{ staffId, basic }` from Step1's `onSubmitted` |
-| `"experience"` | `{ experience, result }` from Step2's `onSubmitted` |
-| `"payroll"` | `{ payroll, result }` from Step3's `onSubmitted` |
+| `"basic"` | `{ staffId, basic, data }` from Step1 (`data` = raw API response) |
+| `"experience"` | `{ experience, result, data }` from Step2 |
+| `"payroll"` | `{ payroll, result, data }` from Step3 |
 
 ## Behavior
 
@@ -787,6 +798,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';

package/dist/Layout/HumanResource/AddStaff/AddStaff.d.ts

@@ -1,7 +1,8 @@
 import { default as React } from 'react';
 export default AddStaff;
-declare function AddStaff({ token, onFinished, onReturn }: {
+declare function AddStaff({ token, onStepComplete, onFinished, onReturn }: {
     token: any;
+    onStepComplete: any;
     onFinished: any;
     onReturn: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/AddStaff/Pages/AddStaffPage.d.ts

@@ -1,7 +1,8 @@
 import { default as React } from 'react';
 export default AddStaffPage;
-declare function AddStaffPage({ token, onFinished, onReturn }: {
+declare function AddStaffPage({ token, onStepComplete, onFinished, onReturn }: {
     token: any;
+    onStepComplete: any;
     onFinished: any;
     onReturn: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/AddStaff/Services/addStaffService.d.ts

@@ -3,6 +3,7 @@ export const addStaffEndpoints: {
     searchByRole: any;
     searchByKeywords: any;
     deactivate: any;
+    changePassword: any;
     basicById: any;
     experienceById: any;
     payrollById: any;

package/dist/Layout/HumanResource/Services/humanResourceService.d.ts

@@ -6,6 +6,7 @@ export namespace endpoints {
         let searchByRole: any;
         let searchByKeywords: any;
         let deactivate: any;
+        let changePassword: any;
         let basicById: any;
         let experienceById: any;
         let payrollById: any;

package/dist/Layout/HumanResource/StaffDirectory/Pages/StaffDirectoryPage.d.ts

@@ -1,8 +1,9 @@
 import { default as React } from 'react';
 export default StaffDirectoryPage;
-declare function StaffDirectoryPage({ token, onNavigate, onFinished, onDelete, }: {
+declare function StaffDirectoryPage({ token, onNavigate, onFinished, onDelete, onPasswordChange, }: {
     token: any;
     onNavigate: any;
     onFinished: any;
     onDelete: any;
+    onPasswordChange: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffDirectory/Services/staffDirectoryService.d.ts

@@ -3,6 +3,7 @@ export const staffEndpoints: {
     searchByRole: any;
     searchByKeywords: any;
     deactivate: any;
+    changePassword: any;
     basicById: any;
     experienceById: any;
     payrollById: any;

package/dist/Layout/HumanResource/StaffDirectory/StaffDirectory.d.ts

@@ -1,8 +1,9 @@
 import { default as React } from 'react';
 export default StaffDirectory;
-declare function StaffDirectory({ token, onNavigate, onFinished, onDelete }: {
+declare function StaffDirectory({ token, onNavigate, onFinished, onDelete, onPasswordChange }: {
     token: any;
     onNavigate: any;
     onFinished: any;
     onDelete: any;
+    onPasswordChange: any;
 }): React.JSX.Element;

package/dist/Layout/HumanResource/StaffWizard/StaffWizard.d.ts

@@ -1,9 +1,10 @@
 import { default as React } from 'react';
 export default StaffWizard;
-declare function StaffWizard({ token, mode, staffId: staffIdProp, onStepComplete, onFinished, }: {
+declare function StaffWizard({ token, mode, staffId: staffIdProp, onStepComplete, onFinished, onReturn, }: {
     token: any;
     mode?: string | undefined;
     staffId: any;
     onStepComplete: any;
     onFinished: any;
+    onReturn: any;
 }): React.JSX.Element;