codex-django-cli 0.2.0__py3-none-any.whl

codex_django_cli/blueprints/features/booking/booking/views.py.j2

@@ -0,0 +1,174 @@
+"""
+Booking views — public booking wizard with HTMX + Alpine.js.
+
+Solo mode (single service):
+    POST /confirm/ with service_id=<int>
+
+Multi-service mode:
+    POST /confirm/ with service_ids=<int>&service_ids=<int>&...
+    Requires a BookingPersistenceHook implementation — see wiki.md for details.
+"""
+
+from __future__ import annotations
+
+import json
+from datetime import date, datetime
+
+from django.http import HttpResponse
+from django.shortcuts import render
+from django.views.decorators.http import require_GET, require_POST
+
+from .models import Service, ServiceCategory
+from .selectors import create_booking, get_available_slots, get_calendar_data
+
+
+@require_GET
+def booking_page_view(request):
+    """Main booking page — renders the wizard shell with step 1 (services)."""
+    categories = ServiceCategory.objects.prefetch_related("services").all()
+    return render(request, "booking/booking_page.html", {
+        "categories": categories,
+    })
+
+
+@require_GET
+def get_calendar_view(request):
+    """HTMX endpoint — returns the calendar partial for a given month."""
+    service_id = request.GET.get("service_id")
+    year = int(request.GET.get("year", date.today().year))
+    month = int(request.GET.get("month", date.today().month))
+    selected = request.GET.get("selected_date")
+
+    selected_date = None
+    if selected:
+        selected_date = datetime.strptime(selected, "%Y-%m-%d").date()
+
+    calendar_data = get_calendar_data(
+        year=year,
+        month=month,
+        today=date.today(),
+        selected_date=selected_date,
+    )
+
+    return render(request, "booking/partials/step_date.html", {
+        "calendar_data": calendar_data,
+        "year": year,
+        "month": month,
+        "service_id": service_id,
+        "selected_date": selected_date,
+    })
+
+
+@require_GET
+def get_slots_view(request):
+    """HTMX endpoint — returns available time slots for a date + service.
+
+    For multi-service, pass the first (primary) service_id — the engine
+    will compute intersected availability during confirm_booking_view.
+    """
+    service_id = request.GET.get("service_id")
+    target = request.GET.get("date")
+
+    if not service_id or not target:
+        return HttpResponse("Missing parameters", status=400)
+
+    target_date = datetime.strptime(target, "%Y-%m-%d").date()
+
+    result = get_available_slots(service_ids=[int(service_id)], target_date=target_date)
+    slots = result.get_unique_start_times() if result.solutions else []
+
+    return render(request, "booking/partials/step_time.html", {
+        "slots": slots,
+        "service_id": service_id,
+        "target_date": target,
+    })
+
+
+@require_POST
+def confirm_booking_view(request):
+    """Final step — creates the booking.
+
+    Solo mode (single service_id):
+        Creates one Appointment, no persistence hook needed.
+
+    Multi-service mode (multiple service_ids):
+        Requires BookingPersistenceHook — implement it in this project
+        and pass it as persistence_hook=. See wiki.md for details.
+
+    POST parameters:
+        service_id  — single service (solo mode, legacy)
+        service_ids — one or more service ids (multi-service mode preferred)
+        date        — YYYY-MM-DD
+        time        — time string as returned by get_available_slots()
+        master_id   — optional, leave blank for "any master"
+        master_selections — optional JSON: {"<service_id>": <master_id>}
+    """
+    target = request.POST.get("date")
+    selected_time = request.POST.get("time")
+
+    # Resolve service_ids: prefer multi-value list, fall back to single service_id
+    raw_ids = request.POST.getlist("service_ids") or [request.POST.get("service_id")]
+    service_ids = [int(s) for s in raw_ids if s]
+
+    if not service_ids or not target or not selected_time:
+        return HttpResponse("Missing parameters", status=400)
+
+    if not request.user.is_authenticated:
+        return HttpResponse("Authentication required", status=401)
+
+    target_date = datetime.strptime(target, "%Y-%m-%d").date()
+
+    # master_id (solo) or master_selections JSON (multi)
+    master_id_raw = request.POST.get("master_id")
+    master_id = int(master_id_raw) if master_id_raw else None
+
+    master_selections = None
+    master_selections_raw = request.POST.get("master_selections")
+    if master_selections_raw:
+        try:
+            master_selections = {
+                int(k): (int(v) if v else None)
+                for k, v in json.loads(master_selections_raw).items()
+            }
+        except (json.JSONDecodeError, ValueError):
+            return HttpResponse("Invalid master_selections format", status=400)
+
+    persistence_hook = None
+    if len(service_ids) > 1:
+        # TODO: Implement BookingPersistenceHook for multi-service support.
+        # Example:
+        #   from .hooks import MyBookingPersistenceHook
+        #   persistence_hook = MyBookingPersistenceHook()
+        # See wiki.md — "Multi-service bookings" section for full details.
+        return HttpResponse(
+            "Multi-service booking requires BookingPersistenceHook. "
+            "See booking/wiki.md for implementation guide.",
+            status=501,
+        )
+
+    try:
+        result = create_booking(
+            service_ids=service_ids,
+            target_date=target_date,
+            selected_time=selected_time,
+            master_id=master_id,
+            master_selections=master_selections,
+            client=request.user,
+            extra_fields={"service_id": service_ids[0]},
+            persistence_hook=persistence_hook,
+        )
+    except Exception as e:
+        return render(request, "booking/partials/step_confirm.html", {
+            "error": str(e),
+            "service_ids": service_ids,
+            "date": target,
+            "time": selected_time,
+        })
+
+    # Solo mode returns a single Appointment; multi mode returns a list via hook.
+    appointments = result if isinstance(result, list) else [result]
+
+    return render(request, "booking/partials/step_confirm.html", {
+        "appointments": appointments,
+        "success": True,
+    })

codex_django_cli/blueprints/features/booking/booking/wiki.md.j2

@@ -0,0 +1,142 @@
+# Booking Module
+
+## Quick Start
+
+1. Add `"booking"` to `INSTALLED_APPS`
+2. Run migrations: `python manage.py makemigrations booking && python manage.py migrate`
+3. Add URLs to root `urls.py`:
+   ```python
+   path("booking/", include("booking.urls")),
+   ```
+4. Add cabinet URL to `cabinet/urls.py`:
+   ```python
+   from cabinet.views.booking import my_bookings_view
+   path("my/bookings/", my_bookings_view, name="my_bookings"),
+   ```
+
+## Admin Setup
+
+1. Create a `BookingSettings` model in `system/models/` extending `AbstractBookingSettings`
+2. Register it in admin — configure `step_minutes`, `default_buffer_between_minutes`, etc.
+3. Add masters via the Master admin (each master needs a linked User)
+4. Set up working days for each master (Mon-Sun schedule)
+5. Add services with durations and link them to masters
+
+## How It Works
+
+The booking wizard is a multi-step form:
+
+1. **Select Service** — client picks a service
+2. **Select Date** — calendar view, HTMX loads available dates
+3. **Select Time** — available slots rendered as buttons
+4. **Confirm** — summary and final submission
+
+All slot computation is handled by `codex_django.booking` engine via
+the adapter pattern — no booking logic lives in this app.
+
+## Customizing Templates
+
+Override any template by placing your version in your project's `templates/` dir:
+
+- `booking/booking_page.html` — main wrapper
+- `booking/partials/step_service.html` — service selection step
+- `booking/partials/step_date.html` — calendar step
+- `booking/partials/step_time.html` — time slots step
+- `booking/partials/step_confirm.html` — confirmation step
+- `cabinet/booking/my_bookings.html` — cabinet bookings list
+
+## CSS Variables
+
+The public booking templates use CSS custom properties for theming:
+
+```css
+:root {
+    --booking-primary: #2563eb;
+    --booking-primary-hover: #1d4ed8;
+    --booking-bg: #ffffff;
+    --booking-bg-secondary: #f8fafc;
+    --booking-text: #1e293b;
+    --booking-text-muted: #64748b;
+    --booking-border: #e2e8f0;
+    --booking-radius: 8px;
+    --booking-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
+}
+```
+
+Override these in your site CSS to match your brand.
+
+## URL Configuration
+
+Public booking page:
+- `GET /booking/` — wizard page
+- `GET /booking/calendar/?service_id=1&year=2026&month=3` — calendar partial (HTMX)
+- `GET /booking/slots/?service_id=1&date=2026-03-25` — time slots partial (HTMX)
+- `POST /booking/confirm/` — create booking
+
+Cabinet:
+- `GET /cabinet/my/bookings/` — client's bookings list
+
+## Multi-service Bookings
+
+By default the booking wizard runs in **solo mode** (one service per booking).
+To support booking multiple services in a single session, implement `BookingPersistenceHook`.
+
+### 1. Implement the hook
+
+Create `booking/hooks.py` in your project:
+
+```python
+from __future__ import annotations
+from typing import Any
+from .models import Appointment
+
+
+class MyBookingPersistenceHook:
+    """Persists a multi-service chain as individual Appointment rows."""
+
+    def persist_chain(
+        self,
+        solution: Any,
+        service_ids: list[int],
+        client: Any,
+        extra_fields: dict[str, Any] | None = None,
+    ) -> list[Appointment]:
+        appointments = []
+        for item in solution.items:
+            appointments.append(
+                Appointment.objects.create(
+                    master_id=item.master_id,
+                    service_id=item.service_id,
+                    start_time=item.start_time,
+                    end_time=item.end_time,
+                    client=client,
+                    **(extra_fields or {}),
+                )
+            )
+        return appointments
+```
+
+### 2. Wire it into the confirm view
+
+In `booking/views.py`, find the TODO comment and replace it:
+
+```python
+from .hooks import MyBookingPersistenceHook
+
+# inside confirm_booking_view, replace the TODO block:
+if len(service_ids) > 1:
+    persistence_hook = MyBookingPersistenceHook()
+```
+
+### 3. Update the confirm form
+
+Your form should send multiple `service_ids` values:
+
+```html
+<input type="hidden" name="service_ids" value="3">
+<input type="hidden" name="service_ids" value="7">
+<!-- optional per-service master selection as JSON -->
+<input type="hidden" name="master_selections" value='{"3": 10, "7": null}'>
+```
+
+A `null` value for a service means "any available master".

codex_django_cli/blueprints/features/booking/cabinet/templates/cabinet/booking/my_bookings.html

@@ -0,0 +1,249 @@
+{% extends "cabinet/base_client.html" %}
+{% load i18n %}
+
+{% block title %}{% trans "My Bookings" %}{% endblock %}
+{% block page_title %}{% trans "My Bookings" %}{% endblock %}
+
+{% block sidebar_nav %}
+<li>
+  <a href="{% url 'cabinet:my_appointments' %}"
+     class="cab-nav__item d-flex align-items-center px-3 py-2 rounded mx-2
+            {% if active_section == 'my' %}cab-nav__item--active{% endif %}"
+     hx-get="{% url 'cabinet:my_appointments' %}"
+     hx-target="#cab-content"
+     hx-push-url="true"
+     style="color: var(--cab-sidebar-text); transition: background 0.15s;">
+    <span class="bi bi-calendar-check fs-5 flex-shrink-0"></span>
+    <span class="cab-nav__label ms-3" style="white-space: nowrap;">{% trans "My Appointments" %}</span>
+  </a>
+</li>
+<li>
+  <a href="{% url 'cabinet:my_bookings' %}"
+     class="cab-nav__item d-flex align-items-center px-3 py-2 rounded mx-2
+            {% if active_section == 'my_bookings' %}cab-nav__item--active{% endif %}"
+     hx-get="{% url 'cabinet:my_bookings' %}"
+     hx-target="#cab-content"
+     hx-push-url="true"
+     style="color: var(--cab-sidebar-text); transition: background 0.15s;">
+    <span class="bi bi-journal-bookmark fs-5 flex-shrink-0"></span>
+    <span class="cab-nav__label ms-3" style="white-space: nowrap;">{% trans "My Bookings" %}</span>
+  </a>
+</li>
+<li>
+  <a href="{% url 'cabinet:profile' %}"
+     class="cab-nav__item d-flex align-items-center px-3 py-2 rounded mx-2
+            {% if active_section == 'profile' %}cab-nav__item--active{% endif %}"
+     hx-get="{% url 'cabinet:profile' %}"
+     hx-target="#cab-content"
+     hx-push-url="true"
+     style="color: var(--cab-sidebar-text); transition: background 0.15s;">
+    <span class="bi bi-person fs-5 flex-shrink-0"></span>
+    <span class="cab-nav__label ms-3" style="white-space: nowrap;">{% trans "Profile" %}</span>
+  </a>
+</li>
+{% endblock %}
+
+{% block sidebar_settings_link %}
+<a href="{% url 'cabinet:settings' %}"
+   class="cab-nav__item d-flex align-items-center px-3 py-2 mx-2 rounded"
+   style="color: var(--cab-sidebar-text); transition: background 0.15s;">
+  <span class="bi bi-gear fs-5 flex-shrink-0"></span>
+  <span class="cab-nav__label ms-3" style="white-space: nowrap; font-size: 0.875rem;">{% trans "Settings" %}</span>
+</a>
+{% endblock %}
+
+{% block cabinet_content %}
+
+{# ─── Stats row ─── #}
+<div class="row g-3 mb-4">
+  <div class="col-md-4">
+    <div class="card border-0 shadow-sm h-100">
+      <div class="card-body d-flex align-items-center gap-3">
+        <div class="rounded-circle d-flex align-items-center justify-content-center"
+             style="width:48px;height:48px;background:#ede9fe;flex-shrink:0;">
+          <span class="bi bi-calendar-check fs-5" style="color:#7c3aed;"></span>
+        </div>
+        <div>
+          <div class="text-muted" style="font-size:.75rem;">{% trans "Upcoming" %}</div>
+          <div class="fw-bold fs-4">{{ stats.upcoming }}</div>
+        </div>
+      </div>
+    </div>
+  </div>
+  <div class="col-md-4">
+    <div class="card border-0 shadow-sm h-100">
+      <div class="card-body d-flex align-items-center gap-3">
+        <div class="rounded-circle d-flex align-items-center justify-content-center"
+             style="width:48px;height:48px;background:#dcfce7;flex-shrink:0;">
+          <span class="bi bi-check-circle fs-5" style="color:#16a34a;"></span>
+        </div>
+        <div>
+          <div class="text-muted" style="font-size:.75rem;">{% trans "Completed" %}</div>
+          <div class="fw-bold fs-4">{{ stats.completed }}</div>
+        </div>
+      </div>
+    </div>
+  </div>
+  <div class="col-md-4">
+    <div class="card border-0 shadow-sm h-100">
+      <div class="card-body d-flex align-items-center gap-3">
+        <div class="rounded-circle d-flex align-items-center justify-content-center"
+             style="width:48px;height:48px;background:#fee2e2;flex-shrink:0;">
+          <span class="bi bi-x-circle fs-5" style="color:#dc2626;"></span>
+        </div>
+        <div>
+          <div class="text-muted" style="font-size:.75rem;">{% trans "Cancelled" %}</div>
+          <div class="fw-bold fs-4">{{ stats.cancelled }}</div>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+
+{# ─── Status filter tabs ─── #}
+<div class="d-flex gap-2 mb-4 flex-wrap">
+  <a href="{% url 'cabinet:my_bookings' %}"
+     class="btn btn-sm {% if not status_filter %}btn-dark{% else %}btn-outline-secondary{% endif %}"
+     style="font-size:.8rem;border-radius:20px;">
+    {% trans "All" %}
+  </a>
+  <a href="{% url 'cabinet:my_bookings' %}?status=pending"
+     class="btn btn-sm {% if status_filter == 'pending' %}btn-dark{% else %}btn-outline-secondary{% endif %}"
+     style="font-size:.8rem;border-radius:20px;">
+    {% trans "Pending" %}
+  </a>
+  <a href="{% url 'cabinet:my_bookings' %}?status=confirmed"
+     class="btn btn-sm {% if status_filter == 'confirmed' %}btn-dark{% else %}btn-outline-secondary{% endif %}"
+     style="font-size:.8rem;border-radius:20px;">
+    {% trans "Confirmed" %}
+  </a>
+  <a href="{% url 'cabinet:my_bookings' %}?status=completed"
+     class="btn btn-sm {% if status_filter == 'completed' %}btn-dark{% else %}btn-outline-secondary{% endif %}"
+     style="font-size:.8rem;border-radius:20px;">
+    {% trans "Completed" %}
+  </a>
+  <a href="{% url 'cabinet:my_bookings' %}?status=cancelled"
+     class="btn btn-sm {% if status_filter == 'cancelled' %}btn-dark{% else %}btn-outline-secondary{% endif %}"
+     style="font-size:.8rem;border-radius:20px;">
+    {% trans "Cancelled" %}
+  </a>
+</div>
+
+{# ─── Bookings table ─── #}
+<div class="card border-0 shadow-sm">
+  <div class="card-header bg-white border-0 pt-3 pb-0 d-flex align-items-center justify-content-between">
+    <h6 class="fw-semibold mb-0">{% trans "My Bookings" %}</h6>
+    <a href="{% url 'booking:booking_page' %}" class="btn btn-sm btn-primary">
+      + {% trans "Book Now" %}
+    </a>
+  </div>
+  <div class="card-body p-0">
+    <table class="table table-hover mb-0">
+      <thead class="table-light">
+        <tr>
+          <th class="ps-4" style="font-size:.75rem;font-weight:600;color:#64748b;">{% trans "DATE AND TIME" %}</th>
+          <th style="font-size:.75rem;font-weight:600;color:#64748b;">{% trans "SERVICE" %}</th>
+          <th style="font-size:.75rem;font-weight:600;color:#64748b;">{% trans "SPECIALIST" %}</th>
+          <th style="font-size:.75rem;font-weight:600;color:#64748b;">{% trans "STATUS" %}</th>
+          <th></th>
+        </tr>
+      </thead>
+      <tbody>
+        {% for appt in page_obj %}
+        <tr>
+          <td class="ps-4">
+            <div class="fw-semibold">{{ appt.datetime_start|date:"j F Y" }}</div>
+            <div class="text-muted" style="font-size:.8rem;">{{ appt.datetime_start|time:"H:i" }}</div>
+          </td>
+          <td>{{ appt.service.name }}</td>
+          <td>
+            <div class="d-flex align-items-center gap-2">
+              <span class="rounded-circle d-flex align-items-center justify-content-center fw-bold text-white"
+                    style="width:28px;height:28px;background:var(--cab-primary);font-size:.7rem;">
+                {{ appt.master.name|make_list|first }}
+              </span>
+              {{ appt.master.name }}
+            </div>
+          </td>
+          <td>
+            {% if appt.status == 'confirmed' %}
+            <span class="badge" style="background:#dcfce7;color:#16a34a;">{% trans "Confirmed" %}</span>
+            {% elif appt.status == 'pending' %}
+            <span class="badge" style="background:#fef9c3;color:#ca8a04;">{% trans "Pending" %}</span>
+            {% elif appt.status == 'completed' %}
+            <span class="badge" style="background:#dcfce7;color:#16a34a;">{% trans "Completed" %}</span>
+            {% elif appt.status == 'cancelled' %}
+            <span class="badge" style="background:#fee2e2;color:#dc2626;">{% trans "Cancelled" %}</span>
+            {% elif appt.status == 'no_show' %}
+            <span class="badge" style="background:#f1f5f9;color:#64748b;">{% trans "No Show" %}</span>
+            {% else %}
+            <span class="badge" style="background:#f1f5f9;color:#64748b;">{{ appt.get_status_display }}</span>
+            {% endif %}
+          </td>
+          <td class="text-end pe-3">
+            {% if appt.status == 'pending' or appt.status == 'confirmed' %}
+            <button class="btn btn-sm btn-outline-danger"
+                    hx-post="{% url 'cabinet:cancel_booking' appt.pk %}"
+                    hx-target="#cab-content"
+                    hx-confirm="{% trans 'Cancel this booking?' %}">
+              {% trans "Cancel" %}
+            </button>
+            {% endif %}
+          </td>
+        </tr>
+        {% empty %}
+        <tr>
+          <td colspan="5" class="text-center py-5">
+            <span class="bi bi-calendar-x fs-1 text-muted d-block mb-2"></span>
+            <p class="text-muted mb-0">{% trans "No bookings found" %}</p>
+          </td>
+        </tr>
+        {% endfor %}
+      </tbody>
+    </table>
+  </div>
+
+  {% if page_obj.has_other_pages %}
+  <div class="card-footer bg-white border-0 d-flex align-items-center justify-content-between py-3 px-4">
+    <span class="text-muted" style="font-size:.8rem;">
+      {% blocktrans with start=page_obj.start_index end=page_obj.end_index total=page_obj.paginator.count %}
+        Showing {{ start }}–{{ end }} of {{ total }}
+      {% endblocktrans %}
+    </span>
+    <nav>
+      <ul class="pagination pagination-sm mb-0">
+        {% if page_obj.has_previous %}
+        <li class="page-item">
+          <a class="page-link" href="?page={{ page_obj.previous_page_number }}{% if status_filter %}&status={{ status_filter }}{% endif %}">«</a>
+        </li>
+        {% else %}
+        <li class="page-item disabled">
+          <a class="page-link" href="#">«</a>
+        </li>
+        {% endif %}
+
+        {% for num in page_obj.paginator.page_range %}
+        <li class="page-item {% if page_obj.number == num %}active{% endif %}">
+          <a class="page-link" href="?page={{ num }}{% if status_filter %}&status={{ status_filter }}{% endif %}"
+             {% if page_obj.number == num %}style="background:var(--cab-primary);border-color:var(--cab-primary);"{% endif %}>
+            {{ num }}
+          </a>
+        </li>
+        {% endfor %}
+
+        {% if page_obj.has_next %}
+        <li class="page-item">
+          <a class="page-link" href="?page={{ page_obj.next_page_number }}{% if status_filter %}&status={{ status_filter }}{% endif %}">»</a>
+        </li>
+        {% else %}
+        <li class="page-item disabled">
+          <a class="page-link" href="#">»</a>
+        </li>
+        {% endif %}
+      </ul>
+    </nav>
+  </div>
+  {% endif %}
+</div>
+
+{% endblock %}

codex_django_cli/blueprints/features/booking/cabinet/views/booking.py.j2

@@ -0,0 +1,70 @@
+"""
+Cabinet booking views — client-facing "My Bookings" page.
+"""
+
+from __future__ import annotations
+
+from django.contrib.auth.decorators import login_required
+from django.core.paginator import Paginator
+from django.http import HttpResponse
+from django.shortcuts import render
+from django.views.decorators.http import require_GET, require_POST
+
+from booking.models import Appointment
+
+
+@login_required
+@require_GET
+def my_bookings_view(request):
+    """List the current user's appointments with status filter and pagination."""
+    status_filter = request.GET.get("status", "")
+    qs = Appointment.objects.filter(client=request.user).select_related("master", "service")
+
+    if status_filter and status_filter in dict(Appointment.STATUS_CHOICES if hasattr(Appointment, "STATUS_CHOICES") else []):
+        qs = qs.filter(status=status_filter)
+
+    paginator = Paginator(qs, 10)
+    page = paginator.get_page(request.GET.get("page", 1))
+
+    # Count stats
+    user_appointments = Appointment.objects.filter(client=request.user)
+    stats = {
+        "upcoming": user_appointments.filter(status__in=["pending", "confirmed"]).count(),
+        "completed": user_appointments.filter(status="completed").count(),
+        "cancelled": user_appointments.filter(status="cancelled").count(),
+    }
+
+    return render(request, "cabinet/booking/my_bookings.html", {
+        "page_obj": page,
+        "status_filter": status_filter,
+        "stats": stats,
+        "active_section": "my_bookings",
+    })
+
+
+@login_required
+@require_POST
+def cancel_booking_view(request, pk):
+    """Cancel an appointment via HTMX."""
+    try:
+        appointment = Appointment.objects.get(pk=pk, client=request.user)
+    except Appointment.DoesNotExist:
+        return HttpResponse("Not found", status=404)
+
+    if appointment.status in ("pending", "confirmed"):
+        appointment.status = "cancelled"
+        appointment.save(update_fields=["status"])
+
+    return render(request, "cabinet/booking/my_bookings.html", {
+        "page_obj": Paginator(
+            Appointment.objects.filter(client=request.user).select_related("master", "service"),
+            10,
+        ).get_page(1),
+        "status_filter": "",
+        "stats": {
+            "upcoming": Appointment.objects.filter(client=request.user, status__in=["pending", "confirmed"]).count(),
+            "completed": Appointment.objects.filter(client=request.user, status="completed").count(),
+            "cancelled": Appointment.objects.filter(client=request.user, status="cancelled").count(),
+        },
+        "active_section": "my_bookings",
+    })

codex_django_cli/blueprints/features/booking/system/admin/booking_settings.py.j2

@@ -0,0 +1,31 @@
+from django.contrib import admin
+
+from system.models import BookingSettings
+
+
+@admin.register(BookingSettings)
+class BookingSettingsAdmin(admin.ModelAdmin):
+    fieldsets = [
+        (
+            "Time Grid",
+            {
+                "fields": [
+                    "step_minutes",
+                    "default_buffer_between_minutes",
+                    "min_advance_minutes",
+                    "max_advance_days",
+                ]
+            },
+        ),
+        (
+            "Default Working Hours",
+            {
+                "fields": [
+                    "work_start_weekdays",
+                    "work_end_weekdays",
+                    "work_start_saturday",
+                    "work_end_saturday",
+                ]
+            },
+        ),
+    ]

codex_django_cli/blueprints/features/booking/system/models/booking_settings.py.j2

@@ -0,0 +1,7 @@
+from codex_django.booking.mixins import AbstractBookingSettings
+
+
+class BookingSettings(AbstractBookingSettings):
+    class Meta:
+        verbose_name = "Booking Settings"
+        verbose_name_plural = "Booking Settings"