full app

models/UserModel.js

@@ -572,13 +572,31 @@ const userSchema = new mongoose.Schema({
     maxLength: 512,
     default: null
   },
+  // کد یکتای معرفی‌کننده — با اولین درخواستِ GET /users/referral-code به‌صورت lazy
+  // ساخته می‌شه (referralController.js)، نه از قبل برای همه‌ی کاربرها. unique+sparse
+  // چون این کد توی لینکِ عمومیِ اشتراک‌گذاری میره و باید واقعاً غیرتکراری باشه
   referral_code: {
     type: String,
     trim: true,
     minLength: 1,
     maxLength: 512,
+    default: null,
+    unique: true,
+    sparse: true
+  },
+  // کاربری که این کاربر رو با لینکِ معرفی‌اش وارد اپ کرده — فقط توی اولین مرحله‌ی
+  // ثبت‌نام (POST /register با mobile) ست می‌شه، دیگه هیچ‌جا عوض نمی‌شه
+  referred_by: {
+    type: mongoose.Schema.Types.ObjectId,
+    ref: 'User',
     default: null
   },
+  // جلوگیری از پرداخت دوباره‌ی پاداشِ معرفی — با تکمیلِ ثبت‌نام (userTypeController)
+  // یک‌بار true می‌شه؛ اگه این مرحله به هر دلیلی دوباره صدا زده بشه، پرداختِ تکراری نمی‌شه
+  referral_rewarded: {
+    type: Boolean,
+    default: false
+  },
   shop_id: {
     type: mongoose.Schema.Types.ObjectId,
     ref: 'Shop',
@@ -643,6 +661,13 @@ const userSchema = new mongoose.Schema({
     type: Date,
     default: null
   },
+  // تعداد بیلبورد رایگانی که این کاربر تا الان ثبت کرده — سقف کلی (نه روزانه) طبق
+  // utils/billboardFreeLimit.js، مستقل از daily_free_request که بین پروژه/بیلبورد/
+  // درخواست مشترکه
+  free_billboard_count: {
+    type: Number,
+    default: 0
+  },
   blocked_by: [{
     type: mongoose.Schema.Types.ObjectId,
     ref: 'User'