clinicpro/docs/tasks/task-16-representation/database.md

پایگاه داده — تسک ۱۶: ماژول Representation

جدول: representations

(entity_type=clinic_pro, bundle=representation — از DB backup تأیید شده)

ستون	نوع	نام Drupal	توضیح
id	INT UNSIGNED AUTO_INCREMENT PK	id
uuid	CHAR(36) UNIQUE NOT NULL	uuid
domain_name	VARCHAR(255) UNIQUE NULL	field_domain_name	دامنه سایت نماینده
city_id	INT FK → categories.id NULL	field_city	entity ref → category (city bundle)
state_id	INT FK → categories.id NULL	field_state	entity ref → category (state bundle)
active	TINYINT(1) DEFAULT 1	field_active	فعال/غیرفعال
commission_percent	INT NULL	field_commission_percent	درصد کمیسیون (نوع INT نه decimal)
address	LONGTEXT NULL	field_address	آدرس نماینده
bank_account	LONGTEXT NULL	field_bank_account	اطلاعات حساب بانکی (JSON/text)
created_at	INT NOT NULL	created	Unix timestamp
updated_at	INT NOT NULL	changed	Unix timestamp

نمونه داده واقعی (از DB backup)

id=41, bundle='representation', uid=33
uuid='bc2a0518-f20d-4542-9376-c2b4fd264706'

ایندکس‌ها

CREATE UNIQUE INDEX idx_representations_domain ON representations(domain_name);
CREATE INDEX idx_representations_city ON representations(city_id);

روابط با جداول دیگر

• doctors.representation_id → representations.id (تسک ۰۵)
• appointments.representation_id → representations.id (تسک ۱۰)
• payments.representation_id → representations.id (تسک ۱۵)

کوئری‌های آماری (بر اساس ماه شمسی)

پرداخت‌های یک ماه شمسی (از RepresentationService.php)

-- startTimestamp و endTimestamp از JalaliDateService می‌آیند
SELECT SUM(p.amount) as total_price, COUNT(p.id) as count
FROM payments p
WHERE p.representation_id = :id
  AND p.status = 'received'           -- نه 'paid'!
  AND p.created_at >= :startTimestamp
  AND p.created_at < :endTimestamp

بیماران یک نماینده (total_patients)

SELECT COUNT(DISTINCT a.patient_id)
FROM appointments a
WHERE a.representation_id = :id

نوبت‌های امروز

SELECT COUNT(*)
FROM appointments a
WHERE a.representation_id = :id
  AND a.start_time >= :todayStartTimestamp
  AND a.start_time < :tomorrowStartTimestamp

نکات مهم

• domain_name شامل scheme و slash انتها است: http://yasuj-nobat.localhost:3000/
• آمار مالی از payments با status='received' است، نه paid
• محاسبه ماه/سال با تقویم شمسی انجام می‌شود (نه میلادی)
• JalaliDateService باید قبل از این تسک پیاده‌سازی شده باشد