cloud-ide-model-schema 1.1.130 → 1.1.132

package/lib/schema/admission/admission_application_main.js

@@ -959,6 +959,11 @@ var admission_application_main = new mongoose_1.Schema({
         trim: true,
         comment: "Remarks or notes about the admission confirmation"
     },
+    admap_islocked: {
+        type: Boolean,
+        default: false,
+        comment: "Lock admission form to prevent editing after confirmation"
+    },
     // FOREIGN KEYS & REFERENCES
     admap_entity_id_syen: {
         type: mongoose_1.default.Schema.Types.ObjectId,

package/lib/schema/admission/admission_fee_snapshot.d.ts

@@ -0,0 +1,23 @@
+import mongoose from "mongoose";
+declare const CAdmissionFeeSnapshot: mongoose.Model<{
+    [x: string]: unknown;
+}, {}, {}, {}, mongoose.Document<unknown, {}, {
+    [x: string]: unknown;
+}, {}> & {
+    [x: string]: unknown;
+} & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}, mongoose.Schema<any, mongoose.Model<any, any, any, any, any, any>, {}, {}, {}, {}, mongoose.DefaultSchemaOptions, {
+    [x: string]: unknown;
+}, mongoose.Document<unknown, {}, mongoose.FlatRecord<{
+    [x: string]: unknown;
+}>, {}> & mongoose.FlatRecord<{
+    [x: string]: unknown;
+}> & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}>>;
+export { CAdmissionFeeSnapshot };

package/lib/schema/admission/admission_fee_snapshot.js

@@ -0,0 +1,375 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAdmissionFeeSnapshot = void 0;
+var mongoose_1 = require("mongoose");
+/**
+ * Admission Fee Snapshot Schema
+ *
+ * Purpose: Store complete fee structure snapshot at the time of admission confirmation/conversion
+ * This ensures that changes to fee structure definitions don't affect already applied fees
+ *
+ * BUSINESS LOGIC:
+ * 1. Stores complete fee structure with all items, amounts, discounts, scholarships
+ * 2. Linked to admission_id at confirmation stage
+ * 3. Updated with student_id at conversion stage
+ * 4. Used for viewing fee status instead of actual fee structure tables
+ * 5. Supports different school scenarios (apply at confirmation or conversion)
+ */
+/* SCHEMA START */
+var admission_fee_snapshot = new mongoose_1.Schema({
+    adfsn_snapshot_number: {
+        type: String,
+        required: true,
+        unique: true,
+        maxlength: 50,
+        trim: true,
+        comment: "Unique snapshot number (auto-generated, e.g., SNAP2026-001)"
+    },
+    adfsn_admission_id_admap: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "admission_application_main",
+        required: true,
+        comment: "Reference to admission application"
+    },
+    adfsn_student_id: {
+        type: String,
+        maxlength: 50,
+        trim: true,
+        default: null,
+        comment: "Student ID (updated at conversion stage, null until conversion)"
+    },
+    adfsn_user_id_auth: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "auth_user_mst",
+        default: null,
+        comment: "Reference to user account (updated at conversion stage)"
+    },
+    adfsn_entity_id_syen: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "core_system_entity",
+        required: true,
+        comment: "Entity for which fees are applicable"
+    },
+    adfsn_academic_year_id_acayr: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "aca_academic_year",
+        required: true,
+        comment: "Academic year for which fees are applicable"
+    },
+    adfsn_class_program_id_acacpm: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "aca_class_program_master",
+        required: true,
+        comment: "Class/Program for which fees are applicable"
+    },
+    adfsn_class_program_term_id_acapt: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "aca_class_program_term",
+        default: null,
+        comment: "Program term (if applicable)"
+    },
+    adfsn_class_program_branch_id_acabrn: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "aca_class_program_branch",
+        default: null,
+        comment: "Specialization/Branch (if applicable)"
+    },
+    adfsn_section_id_acapts: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "aca_prg_trm_section",
+        default: null,
+        comment: "Section (if applicable)"
+    },
+    adfsn_fee_structure_id_feest: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "fee_structures",
+        default: null,
+        comment: "Original fee structure ID (for reference, snapshot is independent)"
+    },
+    adfsn_snapshot_date: {
+        type: Date,
+        required: true,
+        default: Date.now,
+        comment: "Date when snapshot was created (confirmation or conversion date)"
+    },
+    adfsn_applied_at_stage: {
+        type: String,
+        required: true,
+        enum: ['CONFIRMATION', 'CONVERSION'],
+        comment: "Stage at which fees were applied (confirmation or student conversion)"
+    },
+    adfsn_fee_items: [{
+            // Store complete fee item details (snapshot of fee_structure_item at time of application)
+            feesi_original_item_id: {
+                type: mongoose_1.default.Schema.Types.ObjectId,
+                ref: "fee_structure_items",
+                default: null,
+                comment: "Original fee structure item ID (for reference)"
+            },
+            feesi_category_id_sygms: {
+                type: mongoose_1.default.Schema.Types.ObjectId,
+                ref: "core_general_master",
+                required: true,
+                comment: "Fee category"
+            },
+            feesi_category_name: {
+                type: String,
+                maxlength: 200,
+                trim: true,
+                comment: "Fee category name (snapshot)"
+            },
+            feesi_item_code: {
+                type: String,
+                maxlength: 50,
+                trim: true,
+                comment: "Fee item code"
+            },
+            feesi_item_name: {
+                type: String,
+                required: true,
+                maxlength: 200,
+                trim: true,
+                comment: "Fee item name"
+            },
+            feesi_description: {
+                type: String,
+                maxlength: 500,
+                trim: true,
+                comment: "Fee item description"
+            },
+            feesi_original_amount: {
+                type: Number,
+                required: true,
+                min: 0,
+                comment: "Original fee amount (before discounts/scholarships)"
+            },
+            feesi_applied_amount: {
+                type: Number,
+                required: true,
+                min: 0,
+                comment: "Amount applied (may differ from original if editable)"
+            },
+            feesi_discount_type: {
+                type: String,
+                enum: ['PERCENTAGE', 'FIXED_AMOUNT', null],
+                default: null,
+                comment: "Discount type if applicable"
+            },
+            feesi_discount_value: {
+                type: Number,
+                default: 0,
+                min: 0,
+                comment: "Discount value (percentage or fixed amount)"
+            },
+            feesi_discount_amount: {
+                type: Number,
+                required: true,
+                default: 0,
+                min: 0,
+                comment: "Calculated discount amount"
+            },
+            feesi_discount_reason_id_sygms: {
+                type: mongoose_1.default.Schema.Types.ObjectId,
+                ref: "core_general_master",
+                default: null,
+                comment: "Discount reason (if applicable)"
+            },
+            feesi_scholarship_type_id_sygms: {
+                type: mongoose_1.default.Schema.Types.ObjectId,
+                ref: "core_general_master",
+                default: null,
+                comment: "Scholarship type (if applicable)"
+            },
+            feesi_scholarship_category: {
+                type: String,
+                enum: ['FULL', 'PARTIAL', null],
+                default: null,
+                comment: "Scholarship category"
+            },
+            feesi_scholarship_percentage: {
+                type: Number,
+                default: null,
+                min: 0,
+                max: 100,
+                comment: "Scholarship percentage (if partial)"
+            },
+            feesi_scholarship_amount: {
+                type: Number,
+                required: true,
+                default: 0,
+                min: 0,
+                comment: "Scholarship amount"
+            },
+            feesi_final_amount: {
+                type: Number,
+                required: true,
+                min: 0,
+                comment: "Final amount after discounts and scholarships"
+            },
+            feesi_tax_applicable: {
+                type: Boolean,
+                default: false,
+                comment: "Is tax applicable"
+            },
+            feesi_tax_percentage: {
+                type: Number,
+                default: 0,
+                min: 0,
+                max: 100,
+                comment: "Tax percentage"
+            },
+            feesi_tax_amount: {
+                type: Number,
+                default: 0,
+                min: 0,
+                comment: "Tax amount"
+            },
+            feesi_total_amount: {
+                type: Number,
+                required: true,
+                min: 0,
+                comment: "Total amount including tax"
+            },
+            feesi_is_mandatory: {
+                type: Boolean,
+                default: true,
+                comment: "Is this fee mandatory"
+            },
+            feesi_is_refundable: {
+                type: Boolean,
+                default: false,
+                comment: "Is this fee refundable"
+            },
+            feesi_is_installment_allowed: {
+                type: Boolean,
+                default: false,
+                comment: "Allow installments"
+            },
+            feesi_installment_count: {
+                type: Number,
+                default: 1,
+                min: 1,
+                comment: "Number of installments"
+            },
+            feesi_due_date_offset_days: {
+                type: Number,
+                default: 0,
+                comment: "Due date offset in days"
+            },
+            feesi_collection_start_offset_days: {
+                type: Number,
+                default: 0,
+                comment: "Collection start offset"
+            },
+            feesi_collection_end_offset_days: {
+                type: Number,
+                default: 30,
+                comment: "Collection end offset"
+            },
+            feesi_display_order: {
+                type: Number,
+                default: 0,
+                comment: "Display order"
+            },
+            feesi_notes: {
+                type: String,
+                maxlength: 500,
+                trim: true,
+                comment: "Additional notes for this fee item"
+            }
+        }],
+    adfsn_total_original_amount: {
+        type: Number,
+        required: true,
+        min: 0,
+        comment: "Total original amount (sum of all fee items before discounts)"
+    },
+    adfsn_total_discount_amount: {
+        type: Number,
+        required: true,
+        default: 0,
+        min: 0,
+        comment: "Total discount amount"
+    },
+    adfsn_total_scholarship_amount: {
+        type: Number,
+        required: true,
+        default: 0,
+        min: 0,
+        comment: "Total scholarship amount"
+    },
+    adfsn_total_tax_amount: {
+        type: Number,
+        required: true,
+        default: 0,
+        min: 0,
+        comment: "Total tax amount"
+    },
+    adfsn_total_final_amount: {
+        type: Number,
+        required: true,
+        min: 0,
+        comment: "Total final amount (after all adjustments)"
+    },
+    adfsn_currency_id_sycr: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "core_currency",
+        default: null,
+        comment: "Currency for fees"
+    },
+    adfsn_currency_code: {
+        type: String,
+        maxlength: 10,
+        trim: true,
+        default: 'USD',
+        comment: "Currency code (snapshot)"
+    },
+    adfsn_notes: {
+        type: String,
+        maxlength: 1000,
+        trim: true,
+        comment: "Additional notes about this fee snapshot"
+    },
+    adfsn_created_by_user: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "auth_user_mst",
+        comment: "User who created this snapshot"
+    },
+    adfsn_modified_by_user: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "auth_user_mst",
+        comment: "User who last modified this snapshot"
+    },
+    adfsn_isactive: {
+        type: Boolean,
+        default: true,
+        comment: "Active status"
+    },
+    adfsn_created_date: {
+        type: Date,
+        default: Date.now,
+        comment: "Creation timestamp"
+    },
+    adfsn_modified_date: {
+        type: Date,
+        default: Date.now,
+        comment: "Last modification timestamp"
+    }
+}, {
+    collection: 'admission_fee_snapshot',
+    timestamps: false // Using custom timestamp fields
+});
+// Indexes for performance
+admission_fee_snapshot.index({ adfsn_admission_id_admap: 1 });
+admission_fee_snapshot.index({ adfsn_student_id: 1 });
+admission_fee_snapshot.index({ adfsn_user_id_auth: 1 });
+admission_fee_snapshot.index({ adfsn_entity_id_syen: 1 });
+admission_fee_snapshot.index({ adfsn_academic_year_id_acayr: 1 });
+admission_fee_snapshot.index({ adfsn_class_program_id_acacpm: 1 });
+admission_fee_snapshot.index({ adfsn_snapshot_date: 1 });
+admission_fee_snapshot.index({ adfsn_applied_at_stage: 1 });
+// Compound index for efficient lookups
+admission_fee_snapshot.index({ adfsn_admission_id_admap: 1, adfsn_isactive: 1 });
+admission_fee_snapshot.index({ adfsn_student_id: 1, adfsn_isactive: 1 });
+var CAdmissionFeeSnapshot = mongoose_1.default.model("admission_fee_snapshot", admission_fee_snapshot);
+exports.CAdmissionFeeSnapshot = CAdmissionFeeSnapshot;

package/lib/schema/admission/index.d.ts

@@ -4,3 +4,4 @@ export * from "./admission_status_history";
 export * from "./admission_document_uploads";
 export * from "./admission_contact_addresses";
 export * from "./admission_family_members";
+export * from "./admission_fee_snapshot";

package/lib/schema/admission/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./admission_status_history"), exports);
 __exportStar(require("./admission_document_uploads"), exports);
 __exportStar(require("./admission_contact_addresses"), exports);
 __exportStar(require("./admission_family_members"), exports);
+__exportStar(require("./admission_fee_snapshot"), exports);

package/lib/schema/fees/fee_assignment.js

@@ -238,7 +238,7 @@ var fee_assignment = new mongoose_1.Schema({
     timestamps: true // Adds created_at and updated_at
 });
 // Indexes for performance
-fee_assignment.index({ feeas_assignment_number: 1 }, { unique: true });
+// Note: feeas_assignment_number already has unique index from field definition (unique: true)
 fee_assignment.index({ feeas_student_id: 1, feeas_due_date: 1 });
 fee_assignment.index({ feeas_fee_structure_id_feest: 1 });
 fee_assignment.index({ feeas_payment_status: 1, feeas_due_date: 1 });

package/lib/schema/fees/fee_receipt_template.d.ts

@@ -0,0 +1,3 @@
+import mongoose from "mongoose";
+declare const CFeeReceiptTemplate: mongoose.Model<any, {}, {}, {}, any, any>;
+export { CFeeReceiptTemplate };

package/lib/schema/fees/fee_receipt_template.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CFeeReceiptTemplate = void 0;
+var mongoose_1 = require("mongoose");
+/**
+ * Fee Receipt Template Schema
+ * Customizable receipt templates with HTML editor
+ */
+/* SCHEMA START */
+var fee_receipt_template = new mongoose_1.Schema({
+    feert_template_name: {
+        type: String,
+        required: true,
+        minlength: 1,
+        maxlength: 200,
+        trim: true,
+        comment: "Receipt template name"
+    },
+    feert_template_code: {
+        type: String,
+        required: false,
+        unique: true,
+        sparse: true,
+        maxlength: 50,
+        trim: true,
+        comment: "Unique receipt template code (auto-generated)"
+    },
+    feert_template_html: {
+        type: String,
+        required: true,
+        comment: "HTML content with placeholders for receipt data"
+    },
+    feert_template_type: {
+        type: String,
+        enum: ['PAYMENT', 'REFUND', 'PROVISIONAL'],
+        required: true,
+        comment: "Type of receipt template"
+    },
+    feert_template_for: {
+        type: String,
+        enum: ['STUDENT', 'OFFICE', 'BOTH'],
+        required: true,
+        default: 'BOTH',
+        comment: "Who this template is for"
+    },
+    feert_is_default: {
+        type: Boolean,
+        default: false,
+        comment: "Whether this is the default template for its type"
+    },
+    feert_entity_id_syen: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "core_system_entity",
+        required: false,
+        default: null,
+        comment: "Entity/Organization this template belongs to (null = global)"
+    },
+    feert_status: {
+        type: String,
+        enum: ['ACTIVE', 'INACTIVE'],
+        required: true,
+        default: 'ACTIVE',
+        comment: "Template status"
+    },
+    feert_created_by_user: {
+        type: mongoose_1.default.Schema.Types.ObjectId,
+        ref: "auth_user_mst",
+        required: false,
+        default: null,
+        comment: "User who created this template"
+    },
+    feert_created_at: {
+        type: Date,
+        default: Date.now,
+        comment: "Template creation timestamp"
+    },
+    feert_updated_at: {
+        type: Date,
+        default: Date.now,
+        comment: "Template last update timestamp"
+    }
+}, {
+    timestamps: false, // We handle timestamps manually
+    collection: "fee_receipt_template"
+});
+// Indexes
+fee_receipt_template.index({ feert_template_code: 1 }, { unique: true, sparse: true });
+fee_receipt_template.index({ feert_entity_id_syen: 1 });
+fee_receipt_template.index({ feert_template_type: 1 });
+fee_receipt_template.index({ feert_status: 1 });
+fee_receipt_template.index({ feert_is_default: 1 });
+fee_receipt_template.index({ feert_created_at: -1 });
+// Pre-save middleware to update feert_updated_at
+fee_receipt_template.pre('save', function (next) {
+    this.feert_updated_at = new Date();
+    if (this.isNew) {
+        this.feert_created_at = new Date();
+    }
+    next();
+});
+// Pre-update middleware to update feert_updated_at
+fee_receipt_template.pre(['updateOne', 'findOneAndUpdate', 'updateMany'], function (next) {
+    this.set({ feert_updated_at: new Date() });
+    next();
+});
+/* SCHEMA END */
+/* MODEL START */
+var CFeeReceiptTemplate = mongoose_1.default.models.fee_receipt_template || mongoose_1.default.model("fee_receipt_template", fee_receipt_template);
+exports.CFeeReceiptTemplate = CFeeReceiptTemplate;

package/lib/schema/fees/index.d.ts

@@ -1,3 +1,4 @@
 export * from './fee_assignment';
 export * from './fee_structure';
 export * from './fee_structure_item';
+export * from './fee_receipt_template';

package/lib/schema/fees/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fee_assignment"), exports);
 __exportStar(require("./fee_structure"), exports);
 __exportStar(require("./fee_structure_item"), exports);
+__exportStar(require("./fee_receipt_template"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "dependencies": {
-    "cloud-ide-lms-model": "^1.0.354",
+    "cloud-ide-lms-model": "^1.0.356",
     "dotenv": "^16.5.0",
     "mongoose": "^8.15.0"
   },
@@ -9,7 +9,7 @@
     "typescript": "^5.8.3"
   },
   "name": "cloud-ide-model-schema",
-  "version": "1.1.130",
+  "version": "1.1.132",
   "description": "Pachage for schema management of Cloud IDEsys LMS",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",