monicka-booking 0.1.0__py3-none-any.whl

monicka_booking/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

monicka_booking/admin.py

@@ -0,0 +1,23 @@
+from django.contrib import admin
+
+from .models import BookingWidgetConfig
+
+
+@admin.register(BookingWidgetConfig)
+class BookingWidgetConfigAdmin(admin.ModelAdmin):
+    fieldsets = (
+        ("API", {"fields": ("api_base_url", "primary_clinic_id"),
+                 "description": "Set MONICKA_API_KEY in the website environment. The secret is never stored or shown here."}),
+        ("Appearance", {"fields": ("title", "introduction", "theme", "font_scale", "currency_label")}),
+        ("Contact", {"fields": ("show_phone_support", "support_phone")}),
+    )
+    readonly_fields = ("updated_at",)
+
+    def has_add_permission(self, request):
+        return not BookingWidgetConfig.objects.exists() and super().has_add_permission(request)
+
+    def has_delete_permission(self, request, obj=None):
+        return False
+
+    def has_module_permission(self, request):
+        return request.user.is_staff

monicka_booking/apps.py

@@ -0,0 +1,7 @@
+from django.apps import AppConfig
+
+
+class MonickaBookingConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "monicka_booking"
+    verbose_name = "Monicka appointment booking"

monicka_booking/client.py

@@ -0,0 +1,66 @@
+from urllib.parse import urljoin
+
+import requests
+from django.conf import settings
+
+
+class MonickaAPIError(Exception):
+    def __init__(self, status_code=None):
+        self.status_code = status_code
+        super().__init__("The booking service is temporarily unavailable.")
+
+
+class MonickaAPIClient:
+    def __init__(self, config, *, session=None, api_key=None):
+        self.config = config
+        self.session = session or requests.Session()
+        self.api_key = api_key if api_key is not None else getattr(settings, "MONICKA_API_KEY", "")
+
+    @property
+    def configured(self):
+        return bool(self.api_key and self.config.primary_clinic_id)
+
+    def _request(self, method, path, **kwargs):
+        if not self.configured:
+            raise MonickaAPIError()
+        base = self.config.api_base_url.rstrip("/") + "/"
+        try:
+            response = self.session.request(method, urljoin(base, path.lstrip("/")),
+                headers={"X-Clinic-API-Key": self.api_key, "Accept": "application/json"},
+                timeout=(3.05, 15), **kwargs)
+            response.raise_for_status()
+            return response.json()
+        except (requests.RequestException, ValueError) as exc:
+            status = getattr(getattr(exc, "response", None), "status_code", None)
+            raise MonickaAPIError(status) from None
+
+    def catalog(self):
+        data = self._request("GET", "/api/plugin/catalog/")
+        if data.get("home_clinic_id") != self.config.primary_clinic_id:
+            raise MonickaAPIError()
+        return data
+
+    def availability(self, *, clinic, therapist, start, end):
+        return self._request("GET", "/api/plugin/availability/", params={
+            "clinic": clinic, "therapist": therapist, "start": start, "end": end})
+
+    def slots(self, *, clinic, therapist, date):
+        return self._request("GET", "/api/slots/", params={
+            "clinic": clinic, "therapist": therapist, "date": date})
+
+    def book(self, payload):
+        return self._request("POST", "/api/bookings/", json=payload)
+
+    def confirmation(self, code):
+        return self._request("GET", f"/api/plugin/confirmation/{code}/")
+
+    def assessment_assignments(self, *, code, phone):
+        return self._request("POST", "/api/plugin/assessments/", json={"code": code, "phone": phone})
+
+    def assessment_questionnaire(self, *, code, phone, assessment_type):
+        return self._request("POST", f"/api/plugin/assessments/{assessment_type}/form/",
+            json={"code": code, "phone": phone})
+
+    def submit_assessment(self, *, code, phone, assessment_type, answers):
+        return self._request("POST", f"/api/plugin/assessments/{assessment_type}/",
+            json={"action": "submit", "code": code, "phone": phone, "answers": answers})

monicka_booking/migrations/0001_initial.py

@@ -0,0 +1,19 @@
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+    dependencies = []
+    operations = [migrations.CreateModel(name="BookingWidgetConfig", fields=[
+        ("id", models.PositiveSmallIntegerField(default=1, editable=False, primary_key=True, serialize=False)),
+        ("api_base_url", models.URLField(default="https://api.monicka.ir")),
+        ("primary_clinic_id", models.PositiveIntegerField(blank=True, help_text="The clinic ID for the API key installed on this website.", null=True)),
+        ("title", models.CharField(default="رزرو نوبت", max_length=120)),
+        ("introduction", models.CharField(blank=True, default="درمانگر را انتخاب کنید و زمان مناسب را پیدا کنید.", max_length=240)),
+        ("theme", models.CharField(choices=[("ivory", "Ivory"), ("sage", "Sage"), ("blue", "Blue")], default="ivory", max_length=12)),
+        ("font_scale", models.PositiveSmallIntegerField(choices=[(100, "Normal"), (112, "Large"), (125, "Extra large")], default=100)),
+        ("currency_label", models.CharField(default="ریال", max_length=16)),
+        ("show_phone_support", models.BooleanField(default=False)),
+        ("support_phone", models.CharField(blank=True, max_length=32)),
+        ("updated_at", models.DateTimeField(auto_now=True)),
+    ], options={"verbose_name": "booking page settings", "verbose_name_plural": "booking page settings"})]

monicka_booking/migrations/0002_alter_bookingwidgetconfig_currency_label.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.2.17 on 2026-09-30 13:24
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('monicka_booking', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='bookingwidgetconfig',
+            name='currency_label',
+            field=models.CharField(default='ریال', help_text='Label only. Keep this consistent with the API and gateway currency.', max_length=16),
+        ),
+    ]

monicka_booking/migrations/__init__.py

@@ -0,0 +1 @@
+

monicka_booking/models.py

@@ -0,0 +1,55 @@
+from django.core.exceptions import ValidationError
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+from urllib.parse import urlsplit
+
+
+class BookingWidgetConfig(models.Model):
+    class Theme(models.TextChoices):
+        IVORY = "ivory", _("Ivory")
+        SAGE = "sage", _("Sage")
+        BLUE = "blue", _("Blue")
+
+    class FontScale(models.IntegerChoices):
+        NORMAL = 100, _("Normal")
+        LARGE = 112, _("Large")
+        EXTRA_LARGE = 125, _("Extra large")
+
+    id = models.PositiveSmallIntegerField(primary_key=True, default=1, editable=False)
+    api_base_url = models.URLField(default="https://api.monicka.ir")
+    primary_clinic_id = models.PositiveIntegerField(null=True, blank=True,
+        help_text=_("The clinic ID for the API key installed on this website."))
+    title = models.CharField(max_length=120, default=_("رزرو نوبت"))
+    introduction = models.CharField(max_length=240, blank=True,
+        default=_("درمانگر را انتخاب کنید و زمان مناسب را پیدا کنید."))
+    theme = models.CharField(max_length=12, choices=Theme.choices, default=Theme.IVORY)
+    font_scale = models.PositiveSmallIntegerField(choices=FontScale.choices, default=FontScale.NORMAL)
+    currency_label = models.CharField(max_length=16, default=_("ریال"),
+        help_text=_("Label only. Keep this consistent with the API and gateway currency."))
+    show_phone_support = models.BooleanField(default=False)
+    support_phone = models.CharField(max_length=32, blank=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name = _("booking page settings")
+        verbose_name_plural = _("booking page settings")
+
+    def clean(self):
+        parts = urlsplit(self.api_base_url)
+        if parts.scheme != "https" and parts.hostname not in {"localhost", "127.0.0.1"}:
+            raise ValidationError({"api_base_url": _("Use HTTPS for the Monicka API outside local development.")})
+        if parts.query or parts.fragment or parts.path not in ("", "/"):
+            raise ValidationError({"api_base_url": _("Enter the API origin, without a path, query, or fragment.")})
+
+    def save(self, *args, **kwargs):
+        self.pk = 1
+        self.full_clean()
+        return super().save(*args, **kwargs)
+
+    @classmethod
+    def get_solo(cls):
+        config, _ = cls.objects.get_or_create(pk=1)
+        return config
+
+    def __str__(self):
+        return str(_("Monicka booking page"))

monicka_booking/static/monicka_booking/assessment.js

@@ -0,0 +1,48 @@
+(() => {
+  const form = document.getElementById("assessment-form");
+  if (!form) return;
+  const pages = [...form.querySelectorAll(".assessment-question")];
+  const previous = document.getElementById("assessment-prev");
+  const next = document.getElementById("assessment-next");
+  const submit = document.getElementById("assessment-submit");
+  const progress = document.getElementById("assessment-progress");
+  const label = document.getElementById("assessment-progress-label");
+  const live = document.getElementById("assessment-live");
+  let current = 0;
+  function show(index, announce = true) {
+    current = index;
+    pages.forEach((page, i) => { page.hidden = i !== current; });
+    previous.disabled = current === 0;
+    next.hidden = current === pages.length - 1;
+    submit.hidden = current !== pages.length - 1;
+    progress.value = current + 1;
+    label.textContent = `پرسش ${current + 1} از ${pages.length}`;
+    if (announce) {
+      live.textContent = label.textContent;
+      pages[current].querySelector("legend").setAttribute("tabindex", "-1");
+      pages[current].querySelector("legend").focus({preventScroll: true});
+      pages[current].scrollIntoView({behavior: "smooth", block: "start"});
+    }
+  }
+  next.addEventListener("click", () => {
+    const answer = pages[current].querySelector("input[type=radio]:checked");
+    if (!answer) {
+      const first = pages[current].querySelector("input[type=radio]");
+      first.focus();
+      live.textContent = "لطفاً به این پرسش پاسخ دهید.";
+      return;
+    }
+    show(Math.min(current + 1, pages.length - 1));
+  });
+  previous.addEventListener("click", () => show(Math.max(current - 1, 0)));
+  form.addEventListener("submit", event => {
+    const unanswered = pages.findIndex(page => !page.querySelector("input[type=radio]:checked"));
+    if (unanswered !== -1) {
+      event.preventDefault();
+      show(unanswered);
+      live.textContent = "هنوز به همه پرسش‌ها پاسخ نداده‌اید.";
+      pages[unanswered].querySelector("input[type=radio]").focus();
+    }
+  });
+  show(0, false);
+})();

monicka_booking/static/monicka_booking/booking.css

@@ -0,0 +1,5 @@
+:root{font-family:Tahoma,Arial,sans-serif;color:#20302c;background:#fff;font-size:var(--font-scale,100%);line-height:1.65}*{box-sizing:border-box}body{margin:0;background:var(--page);--page:#fffefa;--surface:#fff;--ink:#202b29;--muted:#53615e;--border:#cbd3cf;--accent:#365e50;--accent-ink:#fff;--soft:#edf3ef;color:var(--ink)}body.theme-sage{--page:#f7faf8;--accent:#315c4b;--soft:#eaf2ed}body.theme-blue{--page:#f8fbff;--accent:#24537c;--soft:#eaf2f8}.page-shell{max-width:1080px;margin:auto;padding:clamp(16px,4vw,42px)}.skip-link{position:absolute;top:-100px;right:12px;background:#fff;padding:12px;z-index:4}.skip-link:focus{top:12px}.page-heading{padding:14px 0 26px}.page-heading h1{font-size:clamp(1.7rem,4vw,2.5rem);margin:.15em 0}.page-heading p{color:var(--muted);margin:.3em 0}.eyebrow{font-size:.9rem;font-weight:bold;color:var(--accent)}.steps ol{display:flex;gap:10px;list-style:none;padding:0;margin:0 0 18px}.steps li{flex:1;border-bottom:3px solid var(--border);padding:8px;color:var(--muted)}.steps li.current{border-color:var(--accent);color:var(--ink);font-weight:bold}.panel{background:var(--surface);border:1px solid var(--border);border-radius:16px;padding:clamp(18px,3vw,30px);margin:16px 0;box-shadow:0 4px 18px #1f332510}.panel h2{font-size:1.35rem;margin-top:0}.filters{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:14px}label{display:grid;gap:6px;font-weight:600}input,select{width:100%;min-height:48px;border:1px solid #687571;border-radius:8px;padding:10px 12px;background:#fff;color:#15201d;font:inherit}input:focus,select:focus,button:focus-visible,a:focus-visible{outline:3px solid #cd8b25;outline-offset:2px}.therapist-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,270px),1fr));gap:14px;margin-top:20px}.therapist-card{border:1px solid var(--border);border-radius:12px;padding:18px;display:flex;flex-direction:column;gap:8px}.therapist-card h3{margin:0}.therapist-card p{margin:0;color:var(--muted)}.tag{display:inline-block;background:var(--soft);border-radius:20px;padding:3px 10px;margin:3px}.button{font:inherit;font-weight:bold;border:0;border-radius:8px;padding:10px 16px;min-height:48px;cursor:pointer;text-decoration:none;display:inline-flex;align-items:center;justify-content:center}.primary{background:var(--accent);color:var(--accent-ink)}.secondary{background:var(--soft);color:var(--ink);border:1px solid var(--border)}.section-top,.calendar-head{display:flex;align-items:center;justify-content:space-between;gap:12px}.section-top p{color:var(--muted)}.branch-row{display:flex;align-items:center;gap:12px;max-width:460px;margin:18px 0}.branch-row select{flex:1}.calendar-head{margin:22px 0 12px}.calendar-head h3{margin:0;text-align:center}.calendar-grid{display:grid;grid-template-columns:repeat(7,minmax(0,1fr));gap:6px}.weekday{text-align:center;color:var(--muted);font-weight:bold;padding:7px 0}.day{min-height:48px;border:1px solid var(--border);border-radius:7px;background:#fff;color:var(--ink);font:inherit}.day.available{background:var(--soft);border-color:var(--accent);font-weight:bold;cursor:pointer}.day.selected{background:var(--accent);color:#fff}.day:disabled{color:#89928f;background:#f3f4f3}.slot-list{display:flex;flex-wrap:wrap;gap:10px}.slot-button{border:1px solid var(--accent);background:#fff;border-radius:8px;padding:10px 16px;min-height:48px;font:inherit;cursor:pointer}.slot-button[aria-pressed=true]{background:var(--accent);color:white}form{display:grid;gap:16px}fieldset{border:1px solid var(--border);border-radius:10px;padding:16px}legend{font-weight:bold;padding:0 6px}.participant-row{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-bottom:12px}.hint,.muted{color:var(--muted);font-size:.92rem}.notice{background:var(--soft);border-right:4px solid var(--accent);padding:12px 16px;border-radius:6px}.notice.error{background:#fff3f0;border-color:#ad3527;color:#641c15}.result{max-width:680px;margin:8vh auto}.confirmation{display:grid;gap:5px;background:var(--soft);padding:18px;border-radius:10px;margin:20px 0}.confirmation strong{font-size:1.6rem;letter-spacing:.08em}.support{padding:16px;text-align:center}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}[hidden]{display:none!important}@media(max-width:560px){.steps ol{font-size:.88rem}.steps li{padding:5px 2px}.section-top{align-items:flex-start;flex-direction:column}.calendar-head{gap:5px}.calendar-head .button{padding:8px}.calendar-grid{gap:3px}.day{min-height:42px;padding:2px}.weekday{font-size:.8rem}.participant-row{grid-template-columns:1fr}.page-shell{padding:14px}}@media(prefers-reduced-motion:reduce){*,*::before,*::after{scroll-behavior:auto!important;animation-duration:.01ms!important;transition-duration:.01ms!important}}
+/* Questionnaire pages share the booking app's restrained, legible visual system. */
+.assessment-unavailable{margin-top:1.5rem;padding:1rem 1.2rem;border:1px solid #956124;border-right:5px solid #956124;border-radius:.75rem;background:#fff8e9;color:#49340f}.assessment-unavailable h2{margin:.1rem 0;font-size:1.1rem}.assessment-unavailable p{line-height:1.9}.assessment-unavailable ul{margin-bottom:.25rem}
+.assessment-panel{max-width:54rem;margin-inline:auto}.assessment-access-form{display:grid;gap:.8rem;max-width:32rem;margin-top:2rem}.assessment-access-form input{font:inherit;font-size:1.1rem;min-height:3.25rem;padding:.7rem 1rem;border:1px solid #ccd7e1;border-radius:.8rem}.assessment-access-form label{font-weight:650;margin-top:.5rem}.assessment-list{list-style:none;padding:0;margin:1.5rem 0}.assessment-list li{display:flex;align-items:center;justify-content:space-between;gap:1rem;padding:1.1rem 0;border-bottom:1px solid #e6ebf0}.assessment-list h2{font-size:1.15rem;margin:0}.assessment-list p{margin:.35rem 0;color:#596b7b}.assessment-progress{display:grid;gap:.6rem;margin:2rem 0 1.5rem;font-weight:650}.assessment-progress progress{width:100%;height:.65rem;accent-color:#557fae}.assessment-question{border:0;padding:0;margin:0;min-height:16rem}.assessment-question legend{font-size:1.3rem;line-height:1.9;font-weight:650;width:100%;margin-bottom:1.25rem}.question-number{display:block;color:#557fae;font-size:.95rem;margin-bottom:.25rem}.assessment-choices{display:grid;gap:.7rem}.assessment-choice{display:flex;align-items:flex-start;gap:.8rem;padding:.85rem 1rem;border-radius:.85rem;background:#f5f8fb;cursor:pointer;font-size:1.05rem;line-height:1.9}.assessment-choice:focus-within{outline:3px solid #557fae;outline-offset:2px}.assessment-choice input{width:1.25rem;height:1.25rem;margin-top:.45rem;accent-color:#557fae;flex:none}.assessment-nav{display:flex;justify-content:space-between;gap:1rem;margin-top:2rem}.assessment-nav button[hidden]{display:none}.assessment-question[hidden]{display:none}.visually-hidden{position:absolute!important;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}@media(max-width:640px){.assessment-list li{align-items:flex-start;flex-direction:column}.assessment-nav{position:sticky;bottom:.5rem;background:#fff;padding:.65rem;border-radius:1rem;box-shadow:0 6px 24px #182b3a1c}.assessment-nav .button{flex:1}.assessment-question legend{font-size:1.15rem}}
+.monicka-powered{display:flex;justify-content:center;padding:18px 12px 28px}.monicka-powered a{display:inline-flex;align-items:center;gap:10px;color:#58675f;text-decoration:none}.monicka-powered img{width:36px;height:36px;object-fit:contain}.monicka-powered span{display:grid;line-height:1.25}.monicka-powered small{color:#6e7b74;font-size:.78rem}.monicka-powered strong{color:#355d4e;font-size:1rem;font-weight:700}.monicka-powered a:hover strong{text-decoration:underline}

monicka_booking/static/monicka_booking/booking.js

@@ -0,0 +1,32 @@
+(() => {
+  'use strict';
+  const catalog = JSON.parse(document.getElementById('monicka-catalog').textContent);
+  const url = id => JSON.parse(document.getElementById(id).textContent);
+  const availabilityUrl=url('availability-url'), slotsUrl=url('slots-url'), currency=url('currency-label');
+  const specialScope=url('booking-scope'), invalidScope=url('booking-scope-invalid');
+  if(invalidScope)return;
+  const $=id=>document.getElementById(id), state={therapist:null,branch:null,date:null,duration:'',branchFilter:'',month:null,available:new Set()};
+  const fa=new Intl.DateTimeFormat('fa-IR-u-ca-persian-nu-latn',{year:'numeric',month:'numeric',day:'numeric'});
+  const faMonth=new Intl.DateTimeFormat('fa-IR-u-ca-persian',{year:'numeric',month:'long'});
+  const parts=d=>Object.fromEntries(fa.formatToParts(d).map(p=>[p.type,p.value]));
+  const jdate=d=>{const p=parts(d);return `${p.year}/${String(p.month).padStart(2,'0')}/${String(p.day).padStart(2,'0')}`};
+  const jm=d=>{const p=parts(d);return {year:+p.year,month:+p.month}};
+  const say=t=>$('live-message').textContent=t;
+  const sections={therapist:'therapist',calendar:'calendar',details:'details'};
+  function show(section){Object.keys(sections).forEach(s=>$(`step-${sections[s]}`).hidden=s!==section);document.querySelectorAll('[data-step-label]').forEach((e,i)=>e.classList.toggle('current',i===['therapist','calendar','details'].indexOf(section)));}
+  function eligibleBranches(t){return t.branches.filter(b=>(!state.branchFilter||b.clinic_id===+state.branchFilter)&&(!state.duration||b.allowed_durations.includes(+state.duration)))}
+  function renderTherapists(){const q=$('therapist-search').value.toLocaleLowerCase('fa').trim(),list=$('therapist-list');list.replaceChildren();catalog.therapists.filter(t=>(!q||`${t.full_name} ${t.short_bio||''} ${(t.specialties||[]).join(' ')}`.toLocaleLowerCase('fa').includes(q))&&eligibleBranches(t).length>0).forEach(t=>{const card=document.createElement('article');card.className='therapist-card';const h=document.createElement('h3');h.textContent=t.full_name;card.append(h);if(t.short_bio){const p=document.createElement('p');p.textContent=t.short_bio;card.append(p)}(t.specialties||[]).forEach(s=>{const tag=document.createElement('span');tag.className='tag';tag.textContent=s;card.append(tag)});if(catalog.branches.length>1){const label=document.createElement('p');label.className='muted';label.textContent='شعبه‌ها';card.append(label);const tags=document.createElement('div');t.branches.forEach(branch=>{const tag=document.createElement('span');tag.className='tag';tag.textContent=branch.clinic_name;tags.append(tag)});card.append(tags)}const b=document.createElement('button');b.type='button';b.className='button primary';b.textContent='انتخاب درمانگر';b.onclick=()=>selectTherapist(t);card.append(b);list.append(card)});if(!list.children.length)list.textContent='درمانگری با این مشخصات پیدا نشد.';}
+  function initFilters(){const branchFilter=$('branch-filter');if(branchFilter){branchFilter.onchange=()=>{state.branchFilter=branchFilter.value;renderTherapists()}}[...new Set(catalog.therapists.flatMap(t=>t.branches.flatMap(b=>b.allowed_durations)))].sort((a,b)=>a-b).forEach(n=>{const o=document.createElement('option');o.value=n;o.textContent=`${n} دقیقه`;$('duration-filter').append(o)});$('therapist-search').oninput=renderTherapists;$('duration-filter').onchange=()=>{state.duration=$('duration-filter').value;renderTherapists()};}
+  function selectTherapist(t,clinicId=null){state.therapist=t;const branches=clinicId===null?eligibleBranches(t):t.branches.filter(b=>b.clinic_id===clinicId);if(!branches.length)return;state.branch=branches[0];$('selected-therapist').textContent=`${t.full_name} · ${state.branch.clinic_name}`;const row=$('branch-row'),sel=$('branch-select');sel.replaceChildren();branches.forEach(b=>{const o=document.createElement('option');o.value=b.clinic_id;o.textContent=b.clinic_name;sel.append(o)});row.hidden=branches.length<2||clinicId!==null;sel.onchange=()=>{state.branch=branches.find(b=>b.clinic_id===+sel.value);state.date=null;$('slot-area').hidden=true;loadAvailability()};state.month=jm(new Date());show('calendar');loadAvailability();}
+  function findFirstDay(m){const now=new Date();for(let i=-500;i<500;i++){const d=new Date(now);d.setDate(d.getDate()+i);const p=parts(d),x=jm(d);if(x.year===m.year&&x.month===m.month&&+p.day===1)return d}return null}
+  function addMonth(m,n){const i=m.year*12+m.month-1+n;return {year:Math.floor(i/12),month:i%12+1}}
+  function bounds(){const first=findFirstDay(state.month);if(!first)return null;const start=new Date(first);start.setDate(first.getDate()-((first.getDay()+1)%7));const days=Array.from({length:42},(_,i)=>{const d=new Date(start);d.setDate(start.getDate()+i);return d});return {first,days}}
+  async function loadAvailability(){const b=bounds();if(!b)return;state.available.clear();const today=new Date();today.setHours(0,0,0,0);const begin=new Date(Math.max(b.first.getTime(),today.getTime()+86400000));const limit=new Date(today);limit.setDate(limit.getDate()+(+state.branch.booking_days||20));const end=new Date(Math.min(b.days[41].getTime(),limit.getTime()));if(begin<=end){try{const u=new URL(availabilityUrl,location.href);u.search=new URLSearchParams({clinic:state.branch.clinic_id,therapist:state.therapist.id,start:jdate(begin),end:jdate(end)});const r=await fetch(u,{headers:{Accept:'application/json'}});if(!r.ok)throw Error();(await r.json()).available_days.forEach(x=>state.available.add(x.date))}catch{say('روزهای آزاد بارگذاری نشد. دوباره تلاش کنید.')}}drawMonth(state.month)}
+  function drawMonth(m){state.month=m;const b=bounds();if(!b)return;$('month-label').textContent=faMonth.format(b.first);const grid=document.querySelector('.calendar-grid');grid.querySelectorAll('.day').forEach(x=>x.remove());const today=new Date();today.setHours(0,0,0,0);const horizon=new Date(today);horizon.setDate(horizon.getDate()+(+state.branch.booking_days||20));b.days.forEach(d=>{const p=parts(d),x=jm(d),same=x.year===m.year&&x.month===m.month,j=jdate(d),button=document.createElement('button');button.type='button';button.className='day';button.textContent=p.day;button.setAttribute('role','gridcell');button.setAttribute('aria-label',`${p.day} ${faMonth.format(d)}`);const avail=state.available.has(j);button.disabled=!same||!avail||d<=today||d>horizon;button.classList.toggle('available',avail&&!button.disabled);button.setAttribute('aria-pressed',state.date===j?'true':'false');button.onclick=()=>selectDate(j);grid.append(button)});const monthIdx=m.year*12+m.month-1,now=jm(today),maxDays=+state.branch.booking_days||20,last=jm(horizon);$('previous-month').disabled=monthIdx<=now.year*12+now.month-1;$('next-month').disabled=monthIdx>=last.year*12+last.month-1;}
+  async function selectDate(date){state.date=date;$('slot-area').hidden=false;$('slot-list').textContent='در حال دریافت ساعت‌های آزاد…';try{const u=new URL(slotsUrl,location.href);u.search=new URLSearchParams({clinic:state.branch.clinic_id,therapist:state.therapist.id,date});const r=await fetch(u,{headers:{Accept:'application/json'}});if(!r.ok)throw Error();const data=await r.json(),list=$('slot-list');list.replaceChildren();data.slots.filter(s=>!state.duration||s.duration_minutes===+state.duration).forEach(s=>(s.available_rooms||[]).forEach(room=>{const button=document.createElement('button');button.type='button';button.className='slot-button';button.textContent=`${new Intl.DateTimeFormat('fa-IR',{hour:'2-digit',minute:'2-digit',timeZone:'Asia/Tehran'}).format(new Date(s.start))} — ${s.duration_minutes} دقیقه`;button.onclick=()=>chooseSlot(s,button);list.append(button)}));if(!list.children.length)list.textContent='برای این روز ساعتی باقی نمانده است.'}catch{$('slot-list').textContent='دریافت ساعت‌ها ممکن نشد. دوباره تلاش کنید.'}}
+  function feeLabel(rawBase,minutes,perMinute,minimum){const [whole='',fraction='']=String(rawBase).split('.'),cents=BigInt(whole)*100n+BigInt((fraction+'00').slice(0,2));let total=cents;if(perMinute&&minutes>minimum){const numerator=cents*BigInt(minutes);total=numerator/60n;const remainder=numerator%60n;if(remainder*2n>60n||(remainder*2n===60n&&total%2n===1n))total+=1n}const integer=(total/100n).toLocaleString('fa-IR'),decimal=new Intl.NumberFormat('fa-IR',{minimumIntegerDigits:2,useGrouping:false}).format(Number(total%100n));return `${integer}٫${decimal}`}
+  function chooseSlot(s,button){document.querySelectorAll('.slot-button').forEach(b=>b.setAttribute('aria-pressed','false'));button.setAttribute('aria-pressed','true');$('form-clinic').value=state.branch.clinic_id;$('form-therapist').value=state.therapist.id;$('form-starts-at').value=s.start;$('form-duration').value=s.duration_minutes;const policy=state.therapist.branches.find(b=>b.clinic_id===state.branch.clinic_id),amount=feeLabel(policy.base_fee,s.duration_minutes,policy.calculate_per_minute,policy.minimum_length_of_appointments);$('booking-summary').textContent=`${state.therapist.full_name}، ${state.branch.clinic_name}، ${jdate(new Date(s.start))}، ${s.duration_minutes} دقیقه، مبلغ ${amount} ${currency}`;show('details')}
+  $('previous-month').onclick=()=>{state.month=addMonth(state.month,-1);loadAvailability()};$('next-month').onclick=()=>{state.month=addMonth(state.month,1);loadAvailability()};document.querySelectorAll('[data-back]').forEach(b=>b.onclick=()=>show(b.dataset.back));$('add-participant').onclick=()=>{const row=document.createElement('div');row.className='participant-row';const name=document.createElement('label');name.textContent='نام همراه';const ni=document.createElement('input');ni.name='participant_name';ni.maxLength=200;name.append(ni);const phone=document.createElement('label');phone.textContent='شماره همراه';const pi=document.createElement('input');pi.name='participant_phone';pi.inputMode='tel';pi.pattern='[+0-9۰-۹٠-٩\\- ]{10,16}';phone.append(pi);row.append(name,phone);$('participants').append(row)};
+  initFilters();renderTherapists();
+  if(specialScope){const therapist=catalog.therapists.find(t=>t.id===specialScope.therapist_id);if(therapist)selectTherapist(therapist,specialScope.clinic_id)}
+})();

monicka_booking/templates/monicka_booking/assessment_access.html

@@ -0,0 +1,17 @@
+{% extends "monicka_booking/base.html" %}
+{% block content %}
+<section class="panel assessment-panel" aria-labelledby="assessment-access-title">
+  <p class="eyebrow">آزمون‌های شما</p>
+  <h1 id="assessment-access-title">ورود به آزمون</h1>
+  <p>برای دیدن آزمون‌های اختصاص‌یافته، کد پیگیری نوبت و شماره همراه ثبت‌شده را وارد کنید.</p>
+  {% if error %}<p class="notice error" role="alert">{{ error }}</p>{% endif %}
+  <form method="post" action="{% url 'monicka_booking:assessments-list' %}" class="assessment-access-form">
+    {% csrf_token %}
+    <label for="confirmation-code">کد پیگیری نوبت</label>
+    <input id="confirmation-code" name="confirmation_code" autocomplete="off" dir="ltr" required maxlength="12">
+    <label for="assessment-phone">شماره همراه</label>
+    <input id="assessment-phone" name="phone" type="tel" inputmode="tel" autocomplete="tel" dir="ltr" required>
+    <button class="button primary" type="submit">نمایش آزمون‌ها</button>
+  </form>
+</section>
+{% endblock %}

monicka_booking/templates/monicka_booking/assessment_complete.html

@@ -0,0 +1,8 @@
+{% extends "monicka_booking/base.html" %}
+{% block content %}
+<section class="panel result" aria-labelledby="assessment-complete-title" role="status">
+  <p class="eyebrow">ثبت پاسخ‌ها</p>
+  <h1 id="assessment-complete-title">{% if result.status == 'already_completed' %}این آزمون پیش‌تر ثبت شده است{% else %}پاسخ‌های شما با موفقیت ثبت شد{% endif %}</h1>
+  <p>نتیجه برای درمانگر شما ثبت شد. برای بررسی یا تفسیر نتیجه با کلینیک تماس بگیرید.</p>
+</section>
+{% endblock %}

monicka_booking/templates/monicka_booking/assessment_form.html

@@ -0,0 +1,34 @@
+{% extends "monicka_booking/base.html" %}
+{% load static %}
+{% block content %}
+<section class="panel assessment-panel" aria-labelledby="assessment-title">
+  <p class="eyebrow">پاسخ‌گویی به آزمون</p>
+  <h1 id="assessment-title">{{ form.title }}</h1>
+  <p>به همه پرسش‌ها پاسخ دهید. پاسخ‌ها پس از ثبت برای درمانگر شما ارسال می‌شوند.</p>
+  <form method="post" action="{% url 'monicka_booking:assessment-submit' form.type %}" id="assessment-form">
+    {% csrf_token %}
+    <input type="hidden" name="confirmation_code" value="{{ confirmation_code }}">
+    <input type="hidden" name="phone" value="{{ phone }}">
+    <input type="hidden" name="question_count" value="{{ form.question_count }}">
+    <div class="assessment-progress" aria-label="پیشرفت آزمون"><span id="assessment-progress-label">پرسش ۱ از {{ form.question_count }}</span><progress id="assessment-progress" max="{{ form.question_count }}" value="1">۱ از {{ form.question_count }}</progress></div>
+    <div id="assessment-live" class="visually-hidden" aria-live="polite" aria-atomic="true"></div>
+    {% for question in form.questions %}
+    <fieldset class="assessment-question" data-question="{{ forloop.counter }}" {% if not forloop.first %}hidden{% endif %}>
+      <legend><span class="question-number">پرسش {{ forloop.counter }}</span>{{ question.text }}</legend>
+      <div class="assessment-choices">
+        {% for choice in question.choices %}
+        <label class="assessment-choice"><input type="radio" name="q{{ question.number }}" value="{{ choice.value }}" required><span>{{ choice.label }}</span></label>
+        {% endfor %}
+      </div>
+    </fieldset>
+    {% endfor %}
+    <div class="assessment-nav">
+      <button class="button secondary" type="button" id="assessment-prev" disabled>پرسش پیشین</button>
+      <button class="button primary" type="button" id="assessment-next">پرسش بعدی</button>
+      <button class="button primary" type="submit" id="assessment-submit" hidden>ثبت پاسخ‌ها</button>
+    </div>
+    <noscript><p>برای پاسخ‌گویی بدون جاوااسکریپت، همه پرسش‌ها در همین صفحه نمایش داده می‌شوند.</p></noscript>
+  </form>
+</section>
+<script src="{% static 'monicka_booking/assessment.js' %}" defer></script>
+{% endblock %}

monicka_booking/templates/monicka_booking/assessments.html

@@ -0,0 +1,30 @@
+{% extends "monicka_booking/base.html" %}
+{% block content %}
+<section class="panel assessment-panel" aria-labelledby="assessment-list-title">
+  <p class="eyebrow">آزمون‌های شما</p>
+  <h1 id="assessment-list-title">آزمون‌های اختصاص‌یافته</h1>
+  {% if assessments %}
+    <ul class="assessment-list">
+      {% for assessment in assessments %}
+      <li>
+        <div><h2>{{ assessment.title }}</h2><p>{{ assessment.question_count }} پرسش</p></div>
+        <form method="post" action="{% url 'monicka_booking:assessment-form' assessment.type %}">
+          {% csrf_token %}<input type="hidden" name="confirmation_code" value="{{ confirmation_code }}"><input type="hidden" name="phone" value="{{ phone }}">
+          <button class="button primary" type="submit">شروع آزمون</button>
+        </form>
+      </li>
+      {% endfor %}
+    </ul>
+  {% endif %}
+  {% if unavailable_assessments %}
+    <aside class="assessment-unavailable" role="status" aria-live="polite">
+      <h2>نیازمند پیگیری کلینیک</h2>
+      <p>برخی آزمون‌های اختصاص‌یافته هنوز امکان تکمیل آنلاین ندارند. برای پیگیری با کلینیک تماس بگیرید.</p>
+      <ul>{% for assessment in unavailable_assessments %}<li>{{ assessment.title }}</li>{% endfor %}</ul>
+    </aside>
+  {% endif %}
+  {% if not assessments and not unavailable_assessments %}
+    <p role="status">در حال حاضر آزمون تکمیل‌نشده‌ای برای شما فعال نیست.</p>
+  {% endif %}
+</section>
+{% endblock %}

monicka_booking/templates/monicka_booking/base.html

@@ -0,0 +1,20 @@
+{% load static %}<!doctype html>
+<html lang="fa" dir="rtl">
+<head>
+  <meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
+  <meta name="color-scheme" content="light">
+  <title>{% block title %}{{ config.title|default:"رزرو نوبت" }}{% endblock %}</title>
+  <link rel="stylesheet" href="{% static 'monicka_booking/booking.css' %}">
+</head>
+<body class="theme-{{ config.theme|default:'ivory' }}" style="--font-scale: {{ config.font_scale|default:100 }}%">
+  <a class="skip-link" href="#main">رفتن به محتوای اصلی</a>
+  <main id="main" class="page-shell">{% block content %}{% endblock %}</main>
+  <footer class="monicka-powered">
+    <a href="https://www.monicka.ir/" target="_blank" rel="noopener noreferrer">
+      <img src="{% static 'monicka_booking/monicka-logo.png' %}" alt="نشان مونیکا">
+      <span><small>توانمند از</small><strong>مونیکا</strong></span>
+    </a>
+  </footer>
+  {% block scripts %}{% endblock %}
+</body>
+</html>

monicka_booking/templates/monicka_booking/booking.html

@@ -0,0 +1,45 @@
+{% extends "monicka_booking/base.html" %}{% load static %}
+{% block content %}
+<header class="page-heading"><p class="eyebrow">نوبت‌دهی آنلاین</p><h1>{{ config.title }}</h1><p>{{ config.introduction }}</p></header>
+{% if unavailable %}<div class="notice error" role="alert">در حال حاضر دریافت فهرست درمانگران ممکن نیست. لطفاً کمی بعد دوباره تلاش کنید.</div>{% endif %}
+{% if invalid_scope %}<div class="notice error" role="alert">پیوند رزرو معتبر نیست یا این درمانگر در شعبهٔ انتخاب‌شده فعالیت ندارد. لطفاً پیوند را از وب‌سایت کلینیک دوباره باز کنید.</div>{% endif %}
+<div id="live-message" class="sr-only" role="status" aria-live="polite"></div>
+{% if not invalid_scope %}<nav class="steps" aria-label="مراحل رزرو"><ol><li {% if not special_mode %}class="current"{% endif %} data-step-label="1">درمانگر و شعبه</li><li {% if special_mode %}class="current"{% endif %} data-step-label="2">روز و ساعت</li><li data-step-label="3">اطلاعات رزرو</li></ol></nav>{% endif %}
+{% if not invalid_scope %}<section class="panel" id="step-therapist" aria-labelledby="therapist-title" {% if special_mode %}hidden{% endif %}>
+  <h2 id="therapist-title">درمانگر خود را انتخاب کنید</h2>
+  <div class="filters">
+    <label>جست‌وجوی نام یا تخصص<input id="therapist-search" type="search" autocomplete="off"></label>
+    {% if catalog.branches|length > 1 %}<label id="branch-filter-wrap">شعبه<select id="branch-filter"><option value="">همه شعبه‌ها</option>{% for branch in catalog.branches %}<option value="{{ branch.id }}">{{ branch.name }}</option>{% endfor %}</select></label>{% endif %}
+    <label>مدت جلسه<select id="duration-filter"><option value="">همه مدت‌ها</option></select></label>
+  </div>
+  <div id="therapist-list" class="therapist-grid" aria-live="polite">
+    {% for therapist in catalog.therapists %}<article class="therapist-card"><h3>{{ therapist.full_name }}</h3>{% if therapist.short_bio %}<p>{{ therapist.short_bio }}</p>{% endif %}<div>{% for specialty in therapist.specialties %}<span class="tag">{{ specialty }}</span>{% endfor %}</div>{% if catalog.branches|length > 1 %}<p class="muted">شعبه‌ها</p><div>{% for branch in therapist.branches %}<span class="tag">{{ branch.clinic_name }}</span>{% endfor %}</div>{% endif %}<button type="button" class="button primary" data-therapist-id="{{ therapist.id }}">انتخاب درمانگر</button></article>{% empty %}<p>درمانگری برای نمایش وجود ندارد.</p>{% endfor %}
+  </div>
+</section>
+<section class="panel" id="step-calendar" aria-labelledby="calendar-title" {% if not special_mode %}hidden{% endif %}>
+  <div class="section-top"><div><h2 id="calendar-title">انتخاب روز و ساعت</h2><p id="selected-therapist"></p></div>{% if not special_mode %}<button type="button" class="button secondary" data-back="therapist">تغییر درمانگر</button>{% endif %}</div>
+  <div class="branch-row" id="branch-row" hidden><label for="branch-select">شعبه</label><select id="branch-select"></select></div>
+  <div class="calendar-head"><button type="button" id="previous-month" class="button secondary" aria-label="ماه قبل">ماه قبل</button><h3 id="month-label" aria-live="polite"></h3><button type="button" id="next-month" class="button secondary" aria-label="ماه بعد">ماه بعد</button></div>
+  <div class="calendar-grid" role="grid" aria-label="تقویم شمسی"><div class="weekday">شنبه</div><div class="weekday">یکشنبه</div><div class="weekday">دوشنبه</div><div class="weekday">سه‌شنبه</div><div class="weekday">چهارشنبه</div><div class="weekday">پنجشنبه</div><div class="weekday">جمعه</div></div>
+  <p id="calendar-help" class="muted">روزهای دارای نوبت با دکمه قابل انتخاب هستند.</p>
+  <div id="slot-area" hidden><h3>ساعت‌های آزاد</h3><div id="slot-list" class="slot-list"></div></div>
+</section>
+<section class="panel" id="step-details" aria-labelledby="details-title" hidden>
+  <div class="section-top"><div><h2 id="details-title">اطلاعات رزرو</h2><p id="booking-summary"></p></div><button type="button" class="button secondary" data-back="calendar">تغییر ساعت</button></div>
+  <form method="post" action="{{ submit_url }}" id="booking-form">{% csrf_token %}
+    <input type="hidden" name="clinic" id="form-clinic"><input type="hidden" name="therapist" id="form-therapist"><input type="hidden" name="starts_at" id="form-starts-at"><input type="hidden" name="duration_minutes" id="form-duration"><input type="hidden" name="idempotency_key" value="{{ idempotency_key }}"><input type="hidden" name="booking_scope" value="{{ scope_token }}">
+    <label>نام و نام خانوادگی رزروکننده<input name="patient_name" required maxlength="200" autocomplete="name"></label>
+    <label>شماره تلفن همراه<input name="patient_phone" required inputmode="tel" autocomplete="tel" pattern="[+0-9۰-۹٠-٩\- ]{10,16}" aria-describedby="phone-hint"><span id="phone-hint" class="hint">شماره تلفن همراه ایران را وارد کنید.</span></label>
+    <label>نوع جلسه<select name="session_type"><option value="in_person">حضوری</option><option value="online">آنلاین</option></select><span class="hint">برای هر دو نوع جلسه، اتاق مناسب به‌صورت خودکار رزرو می‌شود.</span></label>
+    <fieldset><legend>افراد همراه در همین جلسه <span class="muted">(در صورت نیاز)</span></legend><div id="participants"></div><button type="button" id="add-participant" class="button secondary">افزودن همراه</button></fieldset>
+    <p class="notice">پرداخت امن در صفحه درگاه بانکی انجام می‌شود. برای رزرو گروهی، نام و شماره هر فرد را وارد کنید.</p>
+    <button class="button primary" type="submit">ادامه به پرداخت</button>
+  </form>
+</section>
+{% endif %}
+{% if config.show_phone_support and config.support_phone %}<footer class="support">نیاز به راهنمایی دارید؟ <a href="tel:{{ config.support_phone|urlencode }}">{{ config.support_phone }}</a></footer>{% endif %}
+{{ catalog|json_script:"monicka-catalog" }}
+{{ special_scope|json_script:"booking-scope" }}{{ invalid_scope|json_script:"booking-scope-invalid" }}
+{{ availability_url|json_script:"availability-url" }}{{ slots_url|json_script:"slots-url" }}{{ config.currency_label|json_script:"currency-label" }}
+{% endblock %}
+{% block scripts %}<script src="{% static 'monicka_booking/booking.js' %}" defer></script>{% endblock %}

monicka_booking/templates/monicka_booking/complete.html

@@ -0,0 +1 @@
+{% extends "monicka_booking/base.html" %}{% block content %}<section class="panel result" aria-labelledby="complete-title"><p class="eyebrow">پیگیری نوبت</p><h1 id="complete-title">{% if booking.status == 'paid' %}پرداخت و رزرو شما ثبت شد{% elif booking.status == 'awaiting_payment' %}پرداخت در حال بررسی است{% elif booking.status == 'payment_failed' %}پرداخت تأیید نشد{% else %}وضعیت رزرو{% endif %}</h1><p>درمانگر: {{ booking.therapist }}</p><p>شعبه: {{ booking.clinic }}</p><p>وضعیت: {{ booking.get_status_display|default:booking.status }}</p><div class="confirmation"><span>کد پیگیری شما</span><strong dir="ltr">{{ booking.confirmation_code }}</strong></div><p>این کد را برای پیگیری نزد خود نگه دارید.</p></section>{% endblock %}

monicka_booking/templates/monicka_booking/error.html

@@ -0,0 +1 @@
+{% extends "monicka_booking/base.html" %}{% block content %}<section class="panel result"><p class="eyebrow">رزرو نوبت</p><h1>تکمیل درخواست ممکن نشد</h1><p>ارتباط با سامانه رزرو برقرار نشد یا اطلاعات درخواست کامل نیست. لطفاً دوباره تلاش کنید یا با کلینیک تماس بگیرید.</p>{% if confirmation_code %}<p>کد پیگیری: <strong dir="ltr">{{ confirmation_code }}</strong></p>{% endif %}<a class="button primary" href="{% url 'monicka_booking:booking' %}">بازگشت به نوبت‌دهی</a></section>{% endblock %}

monicka_booking/templates/monicka_booking/gateway.html

@@ -0,0 +1 @@
+{% extends "monicka_booking/base.html" %}{% block content %}<section class="panel result"><p class="eyebrow">پرداخت امن</p><h1>در حال انتقال به درگاه بانکی</h1><p>برای ادامه، دکمه زیر را انتخاب کنید. پس از پرداخت به این صفحه بازمی‌گردید.</p><form id="gateway-form" method="{{ gateway.method|default:'post'|lower }}" action="{{ gateway.url }}" autocomplete="off">{% for name, value in gateway.params.items %}<input type="hidden" name="{{ name }}" value="{{ value }}">{% endfor %}<button class="button primary" type="submit">ورود به درگاه بانکی</button></form>{% if confirmation_code %}<p class="muted">کد پیگیری: <strong dir="ltr">{{ confirmation_code }}</strong></p>{% endif %}</section>{% endblock %}

monicka_booking/urls.py

@@ -0,0 +1,17 @@
+from django.urls import path
+
+from . import views
+
+app_name = "monicka_booking"
+
+urlpatterns = [
+    path("", views.booking_page, name="booking"),
+    path("availability/", views.availability, name="availability"),
+    path("slots/", views.slots, name="slots"),
+    path("submit/", views.submit_booking, name="submit"),
+    path("complete/", views.complete, name="complete"),
+    path("assessments/", views.assessments_access, name="assessments-access"),
+    path("assessments/list/", views.assessments_list, name="assessments-list"),
+    path("assessments/<slug:assessment_type>/", views.assessment_form, name="assessment-form"),
+    path("assessments/<slug:assessment_type>/submit/", views.assessment_submit, name="assessment-submit"),
+]

monicka_booking/views.py

@@ -0,0 +1,196 @@
+import uuid
+
+from django.core import signing
+from django.core.signing import BadSignature
+from django.http import JsonResponse
+from django.shortcuts import redirect, render
+from django.urls import reverse
+from django.views.decorators.http import require_GET, require_POST
+
+from .client import MonickaAPIClient, MonickaAPIError
+from .models import BookingWidgetConfig
+
+
+def _client():
+    config = BookingWidgetConfig.get_solo()
+    return config, MonickaAPIClient(config)
+
+
+def _error_response():
+    return JsonResponse({"error": "سرویس رزرو موقتاً در دسترس نیست. کمی بعد دوباره تلاش کنید."}, status=503)
+
+
+@require_GET
+def booking_page(request):
+    config, api = _client()
+    scope_requested = "therapist" in request.GET or "clinic" in request.GET
+    scope = None
+    invalid_scope = False
+    try:
+        catalog = api.catalog()
+    except MonickaAPIError:
+        catalog = {"branches": [], "therapists": []}
+        unavailable = True
+    else:
+        unavailable = False
+        if scope_requested:
+            therapist_id = request.GET.get("therapist", "")
+            clinic_id = request.GET.get("clinic", "")
+            if not (therapist_id.isascii() and therapist_id.isdecimal()
+                    and clinic_id.isascii() and clinic_id.isdecimal()):
+                invalid_scope = True
+            else:
+                therapist_id, clinic_id = int(therapist_id), int(clinic_id)
+                therapist = next((item for item in catalog.get("therapists", [])
+                                  if item.get("id") == therapist_id), None)
+                branch = next((item for item in (therapist or {}).get("branches", [])
+                               if item.get("clinic_id") == clinic_id), None)
+                if therapist and branch:
+                    scope = {"therapist_id": therapist_id, "clinic_id": clinic_id}
+                    catalog = {
+                        **catalog,
+                        "branches": [branch],
+                        "therapists": [{**therapist, "branches": [branch]}],
+                    }
+                else:
+                    invalid_scope = True
+            if invalid_scope:
+                catalog = {**catalog, "branches": [], "therapists": []}
+    scope_token = signing.dumps(scope, salt="monicka-booking-scope") if scope else ""
+    return render(request, "monicka_booking/booking.html", {
+        "config": config, "catalog": catalog, "unavailable": unavailable,
+        "special_mode": scope is not None, "special_scope": scope,
+        "scope_token": scope_token, "invalid_scope": invalid_scope,
+        "availability_url": reverse("monicka_booking:availability"),
+        "slots_url": reverse("monicka_booking:slots"),
+        "submit_url": reverse("monicka_booking:submit"),
+        "idempotency_key": uuid.uuid4(),
+    })
+
+
+@require_GET
+def availability(request):
+    config, api = _client()
+    try:
+        data = api.availability(clinic=request.GET["clinic"], therapist=request.GET["therapist"],
+            start=request.GET["start"], end=request.GET["end"])
+    except (MonickaAPIError, KeyError, ValueError):
+        return _error_response()
+    return JsonResponse(data)
+
+
+@require_GET
+def slots(request):
+    _, api = _client()
+    try:
+        data = api.slots(clinic=request.GET["clinic"], therapist=request.GET["therapist"], date=request.GET["date"])
+    except (MonickaAPIError, KeyError, ValueError):
+        return _error_response()
+    return JsonResponse({"slots": data})
+
+
+@require_POST
+def submit_booking(request):
+    try:
+        starts_at = request.POST["starts_at"]
+        scope_token = request.POST.get("booking_scope", "")
+        if scope_token:
+            scope = signing.loads(scope_token, salt="monicka-booking-scope")
+            if (int(request.POST["clinic"]) != scope["clinic_id"]
+                    or int(request.POST["therapist"]) != scope["therapist_id"]):
+                return render(request, "monicka_booking/error.html", status=400)
+        payload = {
+            "clinic": int(request.POST["clinic"]), "therapist": int(request.POST["therapist"]),
+            "patient_name": request.POST["patient_name"].strip(),
+            "patient_phone": request.POST["patient_phone"].strip(),
+            "duration_minutes": int(request.POST["duration_minutes"]), "starts_at": starts_at,
+            "idempotency_key": request.POST.get("idempotency_key") or str(uuid.uuid4()),
+            "session_type": request.POST.get("session_type", "in_person"),
+            "return_url": request.build_absolute_uri(reverse("monicka_booking:complete")),
+        }
+        names = request.POST.getlist("participant_name")
+        phones = request.POST.getlist("participant_phone")
+        if len(names) != len(phones):
+            return render(request, "monicka_booking/error.html", status=400)
+        payload["participant_contacts"] = [{"patient_name": name.strip(), "patient_phone": phone.strip()}
+            for name, phone in zip(names, phones) if name.strip() or phone.strip()]
+        _, api = _client()
+        response = api.book(payload)
+    except BadSignature:
+        return render(request, "monicka_booking/error.html", status=400)
+    except (MonickaAPIError, KeyError, TypeError, ValueError):
+        return render(request, "monicka_booking/error.html", status=503)
+    gateway = response.get("gateway")
+    if gateway and gateway.get("url"):
+        return render(request, "monicka_booking/gateway.html", {"gateway": gateway, "confirmation_code": response.get("confirmation_code")})
+    return redirect(f"{reverse('monicka_booking:complete')}?confirmation={response.get('confirmation_code', '')}")
+
+
+@require_GET
+def complete(request):
+    code = request.GET.get("confirmation", "").strip().upper()
+    if not code:
+        return render(request, "monicka_booking/error.html", status=400)
+    _, api = _client()
+    try:
+        booking = api.confirmation(code)
+    except MonickaAPIError:
+        return render(request, "monicka_booking/error.html", {"confirmation_code": code}, status=503)
+    return render(request, "monicka_booking/complete.html", {"booking": booking})
+
+
+@require_GET
+def assessments_access(request):
+    return render(request, "monicka_booking/assessment_access.html")
+
+
+@require_POST
+def assessments_list(request):
+    code = request.POST.get("confirmation_code", "").strip().upper()
+    phone = request.POST.get("phone", "").strip()
+    if not code or not phone:
+        return render(request, "monicka_booking/error.html", status=400)
+    _, api = _client()
+    try:
+        data = api.assessment_assignments(code=code, phone=phone)
+    except MonickaAPIError as exc:
+        return render(request, "monicka_booking/assessment_access.html", {
+            "error": "کد پیگیری یا شماره همراه درست نیست، یا آزمونی برای شما فعال نشده است."},
+            status=403 if exc.status_code in (401, 403, 404) else 503)
+    return render(request, "monicka_booking/assessments.html", {
+        "assessments": data.get("assessments", []),
+        "unavailable_assessments": data.get("unavailable_assessments", []),
+        "confirmation_code": code, "phone": phone})
+
+
+@require_POST
+def assessment_form(request, assessment_type):
+    code = request.POST.get("confirmation_code", "").strip().upper()
+    phone = request.POST.get("phone", "").strip()
+    if not code or not phone:
+        return render(request, "monicka_booking/error.html", status=400)
+    _, api = _client()
+    try:
+        form = api.assessment_questionnaire(code=code, phone=phone, assessment_type=assessment_type)
+    except MonickaAPIError as exc:
+        return render(request, "monicka_booking/error.html", status=403 if exc.status_code in (401, 403, 404) else 503)
+    return render(request, "monicka_booking/assessment_form.html", {
+        "form": form, "confirmation_code": code, "phone": phone})
+
+
+@require_POST
+def assessment_submit(request, assessment_type):
+    code = request.POST.get("confirmation_code", "").strip().upper()
+    phone = request.POST.get("phone", "").strip()
+    try:
+        count = int(request.POST.get("question_count", "0"))
+        answers = [int(request.POST[f"q{number}"]) for number in range(1, count + 1)]
+    except (ValueError, KeyError):
+        return render(request, "monicka_booking/error.html", status=400)
+    _, api = _client()
+    try:
+        result = api.submit_assessment(code=code, phone=phone,
+            assessment_type=assessment_type, answers=answers)
+    except MonickaAPIError as exc:
+        return render(request, "monicka_booking/error.html", status=400 if exc.status_code == 400 else 503)
+    return render(request, "monicka_booking/assessment_complete.html", {"result": result})

monicka_booking-0.1.0.dist-info/METADATA

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: monicka-booking
+Version: 0.1.0
+Summary: Accessible Persian clinic booking pages for Monicka API
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: Django<6,>=4.2
+Requires-Dist: requests<3,>=2.31
+Provides-Extra: test
+Requires-Dist: pytest<9,>=8; extra == "test"
+Requires-Dist: pytest-django<5,>=4.8; extra == "test"
+
+# Monicka Booking
+
+An accessible, Persian right-to-left booking app for Django clinic websites. It is a server-rendered Django app distributed as a pip package; it does not expose clinic API keys to the visitor's browser and uses no JavaScript framework or external font service.
+
+## Install
+
+```sh
+pip install monicka-booking
+```
+
+Add the app, set its API key in the website process environment, and mount its URLs:
+
+```python
+# settings.py
+INSTALLED_APPS += ["monicka_booking"]
+MONICKA_API_KEY = "<the clinic API key>"  # Prefer an environment variable/secret manager.
+```
+
+```python
+# urls.py
+from django.urls import include, path
+
+urlpatterns += [path("booking/", include("monicka_booking.urls"))]
+```
+
+Then run `python manage.py migrate`. A staff user can configure title, colors, text size, displayed currency label, and optional support phone in Django admin under **Booking page settings**. Set the API origin and home clinic ID there. The API key is intentionally configured outside admin and is never sent to the browser.
+
+## API setup
+
+Issue a clinic API key in Monicka and set the key's home clinic `website_url` to this site's HTTPS origin (including the same origin used by the plugin payment return URL). Set each clinic's `plugin_booking_days` in API admin. The default booking window is 20 future days. All clinics with the same owner are offered as branches in one catalog. Therapist profile fields (short bio and specialties) are maintained in API admin.
+
+The package talks to the API over HTTPS using `X-Clinic-API-Key`. Website hosting must allow outbound HTTPS requests to the configured API. The payment callback returns to the plugin completion page, where the package verifies the confirmation code server-to-server before showing appointment status.
+
+### Direct therapist booking links
+
+To link directly to one therapist at one branch, use the regular booking URL with both public IDs:
+
+```text
+/booking/?therapist=133&clinic=5
+```
+
+The plugin checks that this therapist is actually offered at that clinic before entering the calendar step. The page then contains only that therapist and branch, skips the therapist/branch directory, and continues through the normal availability, booking, and payment checks. Invalid or mismatched IDs show an error instead of opening the full directory. These IDs are selectors, not credentials; do not put a patient's name, phone number, or other personal details in a URL. The API still validates every selected time and booking.
+
+## Booking flow and accessibility
+
+The initial therapist catalog is server-rendered. JavaScript progressively loads the Jalali calendar's available days and slots from same-origin Django views; dates and slots are always validated again by the API at booking time. The responsive UI uses semantic form labels, keyboard-operable buttons, visible focus rings, large controls, live status announcements, high-contrast light themes, adjustable type size, and reduced-motion support.
+
+Theme choices are intentionally CSS-variable based so future themes can be added without introducing a UI framework. The calendar uses the browser's built-in Persian calendar formatter.
+
+## Development
+
+```sh
+pip install -e '.[test]'
+python -m django test --settings tests.settings
+```
+
+You can also run the source checkout as a standalone local Django site without installing `monicka-booking`. Use an existing Python environment with Django and Requests available:
+
+```sh
+export PYTHONPATH="$PWD/src"
+DJANGO_PYTHON="/path/to/python-with-django"
+"$DJANGO_PYTHON" -m django migrate --settings tests.dev_settings
+"$DJANGO_PYTHON" -m django createsuperuser --settings tests.dev_settings
+"$DJANGO_PYTHON" -m django runserver 127.0.0.1:8000 --settings tests.dev_settings
+```
+
+Open `http://localhost:8000/booking/` for the booking page or `/admin/` to configure its title and theme. This local setup uses a persistent SQLite database at `dev.sqlite3`; the test settings continue to use an in-memory database. Without `MONICKA_API_KEY` and a reachable API the page shows its friendly unavailable state. To try real slots and payment handoff, point it at a staging API and test gateway. A production project supplies its own Django settings, database, and admin configuration.

monicka_booking-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+monicka_booking/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+monicka_booking/admin.py,sha256=gjH91uoefiQwAGNMKdJfZ5gFq2UwP_QLYqsvlJ1awes,898
+monicka_booking/apps.py,sha256=zptjrq2ARBjQr9Q9V-lGWxaZyIpJd3ErkLEG-IqZ_Gw,210
+monicka_booking/client.py,sha256=LUZdSPhaDIygMFUzwMGElUtzOKXGLyTAJF9Ql_DP0wk,2773
+monicka_booking/models.py,sha256=z84rZpYcNXZrZSBCYQA0GTtCZAhw7RRs9jYHc1H62zI,2504
+monicka_booking/urls.py,sha256=nnuPprBO__sLiIf3bfhVAIahv7Kd-Vzin6QTe03bpeQ,740
+monicka_booking/views.py,sha256=Kh5NEbeX9d5WzzUr689zfG6h-4VJ37exIS8Ox-6A-98,8751
+monicka_booking/migrations/0001_initial.py,sha256=7vsltIVlF7JC-Ltbj7dBYHrh04WyOcJF3vldNJsYsvM,1457
+monicka_booking/migrations/0002_alter_bookingwidgetconfig_currency_label.py,sha256=oG2n3EVYp7BN-YTWHhiRcmGPRfKlAT5ycwNHpKo04K8,506
+monicka_booking/migrations/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+monicka_booking/static/monicka_booking/assessment.js,sha256=95YvznpRuDLTgLr2WjkdDCE9v8Ttu0PTVRFHyqHj2gY,2117
+monicka_booking/static/monicka_booking/booking.css,sha256=jcy8GvIQGKpHT7S3k60NM7Eb0WLjx6fHFbLn61z98PY,7772
+monicka_booking/static/monicka_booking/booking.js,sha256=Cm93mTi2yqmkgPsYuvjxQjdSguVXwlL8rXCp33Py9Bc,10363
+monicka_booking/static/monicka_booking/monicka-logo.png,sha256=0dra11Nw8Td_-d2lHCMk5_3mJKK9TH32a00WuVx1cCw,73664
+monicka_booking/templates/monicka_booking/assessment_access.html,sha256=24Ur8s67cATGi6tohfc1zc6AkLJrmOL3VqfUC3Iw_Ko,1120
+monicka_booking/templates/monicka_booking/assessment_complete.html,sha256=yb_hhHE5YBnXXiFMfIkY4zB7oYkH4f2DVlyHRhf0rsI,592
+monicka_booking/templates/monicka_booking/assessment_form.html,sha256=o3adY5lr7r9u3Rj-_v_vmDaRxNGyjmNRu-g_YZ-NDSg,2407
+monicka_booking/templates/monicka_booking/assessments.html,sha256=Rv--09A_4_QyVjOAliaXwZlD70T0PLr4VXimZY_ZuXU,1607
+monicka_booking/templates/monicka_booking/base.html,sha256=px-eawdvFZgQc96oXm8nuqAxaH021fw0HwKoHPQwiFM,1019
+monicka_booking/templates/monicka_booking/booking.html,sha256=NSbgVFULxVLYYxxNVd2RYsXjm9nx0AU2irD1GUsPovU,6928
+monicka_booking/templates/monicka_booking/complete.html,sha256=qgTREUxRbXWxAiUVRmCAzwRO2_-7qabXVYpXg-sbCDQ,863
+monicka_booking/templates/monicka_booking/error.html,sha256=q-qVmHQqhudVoL_pLLls-pC_p30eY2XKc0Nsyel35Gc,634
+monicka_booking/templates/monicka_booking/gateway.html,sha256=5Zvd0TTReYhycgJaYnKHlQuR1wGG-Bt0qPv_9e7x7aA,818
+monicka_booking-0.1.0.dist-info/METADATA,sha256=2KerO-tIHkCF4euWYk0RMxzpZtoATFaaKNo_KlkN4sI,4640
+monicka_booking-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+monicka_booking-0.1.0.dist-info/top_level.txt,sha256=YYSFIy-3am7GWKAT9CVV6cfsSZCa035mbZsnp-X4Qgc,16
+monicka_booking-0.1.0.dist-info/RECORD,,

monicka_booking-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

monicka_booking-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+monicka_booking