nazar-salary 2.7.1 → 2.8.1

package/index.d.ts

@@ -648,16 +648,104 @@ declare module 'nazar-salary' {
     status: string;
     student: {
       id: number;
-      is_active: boolean;
-      finished_at: string;
+      name: string;
+      is_active: false;
+      finished_at: number;
       stop_reason: StopReason;
+      stop_comment: string | null;
       completed_lessons: number;
+      total_lessons: number;
+      remaining_lessons: number;
     };
-    teacher_payment_created?: {
+    lesson_group_id: number | null;
+    remaining_group_students: Array<{ id: number; name: string }> | null;
+  }
+
+  export interface ResumeStudentData {
+    comment?: string;
+  }
+
+  export interface ResumeStudentResponse {
+    status: string;
+    student: {
       id: number;
-      lessons_count: number;
-      amount: number;
-      status: string;
+      name: string;
+      is_active: true;
+      resumed_at: number;
+      previous_stop_reason: StopReason | null;
+      completed_lessons: number;
+      total_lessons: number;
+      remaining_lessons: number;
+    };
+    lesson_group_id: number | null;
+  }
+
+  export interface DashboardKpi {
+    students: {
+      active: number;
+      new_this_month: number;
+      finished_this_month: number;
+    };
+    staff: {
+      managers: number;
+      teachers: number;
+    };
+    finance: {
+      verified_amount: number;
+      verified_count: number;
+      manager_commission: number;
+      teacher_pending_amount: number;
+      teacher_pending_count: number;
+    };
+  }
+
+  export interface DashboardAlerts {
+    discrepancies: number;
+    orphan_payments: number;
+    teacher_not_paid_count: number;
+    teacher_not_paid_amount: number;
+  }
+
+  export interface DashboardManagerItem {
+    id: number;
+    name: string;
+    students_count?: number;
+    total_commission?: number;
+  }
+
+  export interface DashboardRecentReceipt {
+    id: number;
+    file_name: string;
+    status: 'processing' | 'completed' | 'failed';
+    uploaded_by: string;
+    uploaded_at: number;
+    verified_count: number;
+    discrepancies_count: number;
+    orphan_count: number;
+  }
+
+  export interface DashboardRecentStudent {
+    id: number;
+    name: string;
+    manager_name: string;
+    created_at: number;
+  }
+
+  export interface DashboardResponse {
+    period: {
+      month: string;
+      month_start: number;
+      month_end: number;
+    };
+    kpi: DashboardKpi;
+    alerts: DashboardAlerts;
+    top_managers: {
+      by_students: DashboardManagerItem[];
+      by_commission: DashboardManagerItem[];
+    };
+    recent: {
+      receipts: DashboardRecentReceipt[];
+      students: DashboardRecentStudent[];
     };
   }
 
@@ -891,6 +979,46 @@ declare module 'nazar-salary' {
     students: StudentListItem[];
   }
 
+  export interface StoppedStudentsParams {
+    search?: string;
+    manager_id?: number;
+    teacher_id?: number;
+    stop_reason?: string;
+    page?: number;
+    limit?: number;
+  }
+
+  export interface StoppedStudentItem {
+    id: number;
+    first_name: string;
+    last_name: string;
+    phone: string;
+    age: number;
+    created_at: number;
+    history_id: number;
+    price_id: number;
+    teacher_id: number;
+    owned_by: number;
+    manager_name: string;
+    enrollment_months: number;
+    total_lessons: number;
+    completed_lessons: number;
+    remaining_lessons: number;
+    main_course: string;
+    group_name: string | null;
+    lesson_group_id: number | null;
+    stop_reason: string;
+    stop_comment: string | null;
+    finished_at: number;
+  }
+
+  export interface StoppedStudentsResponse {
+    total_students: number;
+    current_page: number;
+    total_pages: number;
+    students: StoppedStudentItem[];
+  }
+
   export interface StudentsListParams {
     manager_id?: number;
     prepayment?: boolean;
@@ -1007,6 +1135,9 @@ declare module 'nazar-salary' {
     getBanksConfig(): Promise<BanksConfigResponse>;
     getManagerStudentsAdmin(managerId: number, params?: StudentsListParams): Promise<StudentsListResponse>;
     
+    // Dashboard endpoints
+    getDashboard(): Promise<DashboardResponse>;
+
     // Salary endpoints
     getManagerSalary(month: string, managerId?: number): Promise<ManagerSalaryResponse>;
     getTeachersSalary(params: TeachersSalaryParams): Promise<TeachersSalaryResponse>;
@@ -1036,8 +1167,10 @@ declare module 'nazar-salary' {
     changeStudentManager(studentId: number, data: ChangeStudentManagerData): Promise<ChangeStudentManagerResponse>;
     updateStudentProgress(studentId: number, data: UpdateStudentProgressData): Promise<UpdateStudentProgressResponse>;
     stopStudent(studentId: number, data: StopStudentData): Promise<StopStudentResponse>;
+    resumeStudent(studentId: number, data?: ResumeStudentData): Promise<ResumeStudentResponse>;
     getStudent(studentId: number): Promise<StudentDetail>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
+    getStoppedStudents(params?: StoppedStudentsParams): Promise<StoppedStudentsResponse>;
     getStudentsList(params?: StudentsListParams): Promise<StudentsListResponse>;
     /** @deprecated Use getStudentsList instead */
     getManagerStudents(managerId: number, params?: ManagerStudentsParams): Promise<ManagerStudentsResponse>;

package/index.js

@@ -567,13 +567,21 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Get admin dashboard summary (Admin only)
+   * @returns {Promise<DashboardResponse>}
+   */
+  async getDashboard() {
+    return await this.client.get("/api/v1/admin/dashboard/");
+  }
+
   /**
    * Stop student enrollment (Admin only)
    * @param {number} studentId - Student ID
    * @param {object} data - Stop data
    * @param {string} data.reason - Reason for stopping (student_quit, moved_away, health_issues, financial, other)
    * @param {string} [data.comment] - Optional comment
-   * @returns {Promise<{status: string, student: object, teacher_payment_created?: object}>}
+   * @returns {Promise<StopStudentResponse>}
    */
   async stopStudent(studentId, data) {
     return await this.client.post(
@@ -582,6 +590,20 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Resume stopped student enrollment (Admin only)
+   * @param {number} studentId - Student ID
+   * @param {object} [data] - Resume data
+   * @param {string} [data.comment] - Optional comment
+   * @returns {Promise<ResumeStudentResponse>}
+   */
+  async resumeStudent(studentId, data = {}) {
+    return await this.client.post(
+      `/api/v1/admin/progress/${studentId}/resume`,
+      data,
+    );
+  }
+
   /**
    * Get student by ID (requireAuth)
    * @param {number} studentId - Student ID
@@ -612,6 +634,21 @@ class SalaryAPI {
     return await this.client.get("/api/v1/admin/students", { params });
   }
 
+  /**
+   * Get stopped students list (Admin only)
+   * @param {object} [params] - Filter parameters
+   * @param {string} [params.search] - Search by name or phone
+   * @param {number} [params.manager_id] - Filter by manager ID
+   * @param {number} [params.teacher_id] - Filter by teacher ID
+   * @param {string} [params.stop_reason] - Filter by stop reason
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Page size
+   * @returns {Promise<object>}
+   */
+  async getStoppedStudents(params = {}) {
+    return await this.client.get("/api/v1/admin/students/stopped", { params });
+  }
+
   /**
    * Get students of specific manager (Admin provides manager_id, Manager gets own students)
    * @param {object} [params] - Filter parameters

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nazar-salary",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",