Skip to content

Kit: sessions (classes) ​

A studio of classes: each class keeps its timetable in its own hours and has places; a visitor books a place.

kind: sessions. What a kit is and how to lay one out: kits.

Taken whole, with the client's facts put into it; anything taken out is a decision said to the developer and written in the brief.

Ask ​

The facts only the business has. Never fill them in; what is not answered is NEEDS CLIENT.

  • zone: the business's time zone — from its address; say it back rather than asking
  • the services — the services collection, one entry per kind of class (block type course): how long a session takes and what one place costs — per: "person", so a party of two pays two places (wiki/70)
  • the classes — the sessions collection, one entry per timetable (block type session): its weekly hours, one row per session's start, and how many places it has

Taken by default — say it, get a yes ​

What this kit chose for the trade. Say each back to the developer; a «no» is a new value in the bookings settings, jtk/modules/bookings.json.

  • A booking is confirmed at once (confirm: auto) — or does the business confirm each one by hand?
  • A visitor may cancel or move their booking themselves until 12 hours before it starts; after that only the business can (cancel_until).
  • Nothing is paid online: the visitor pays on the day (payment: no) — or a deposit, or in full when booking?
  • Bookable up to 30 days ahead (horizon).
  • No sooner than an hour from now (lead).
  • Start times offered every 15 minutes (slot_every).
  • A visitor books for up to 2 at once (party).
  • Shown to visitors: every class's name and its distinguishing marks, wherever a visitor may choose one; what is booked and their prices. Nothing goes into the marks that the client would not want printed.
  • A new booking is sent where the site's enquiries go — the Telegram chat or the email a person links in the panel; an agent cannot link one. Ask which, and say it is theirs to link before the launch.

Collections ​

Where each one's entries are is its contract-3 route — and shown_on, for entries with no page of their own — as jtk create --kit writes it.

collectionthe diary'sukendean entry iswhere
servicesservicesПослугиServicesLeistungencourse"route": "none", "shown_on": ["/services#services-{slug}"]
sessionsresourcesЗаняттяClassesKursesession"route": "none", "shown_on": ["/timetable#sessions-{slug}"]

Settings ​

The keys of settings in jtk/modules/bookings.json (on contract 2, the older contract, the fields of the bookings_config block in jtk/bookings.json); the modules reference says what each does.

fieldvalue
cancel_until720
combinefalse
confirm"auto"
horizon30
kind"sessions"
lead60
party2
payment"no"
scale"hourly"
slot_every15

The kit, whole ​

As GET /v1/kits/sessions serves it and jtk create --kit reads it: in contract 2's words, which jtk create --kit puts in contract 3's (laying a kit out). Not a file to copy into a contract-3 site.

json
{
  "kind": "sessions",
  "version": 3,
  "sum": "653bde6d50b3",
  "about": "A studio of classes: each class keeps its timetable in its own hours and has places; a visitor books a place.",
  "ask": [
    "zone: the business's time zone — from its address; say it back rather than asking",
    "the services — the `services` collection, one entry per kind of class (block type `course`): how long a session takes and what one place costs — `per: \"person\"`, so a party of two pays two places (wiki/70)",
    "the classes — the `sessions` collection, one entry per timetable (block type `session`): its weekly hours, one row per session's start, and how many places it has"
  ],
  "catalogue": {
    "blocks": [
      {
        "type": "course",
        "v": 1,
        "label": {
          "uk": "Послуга",
          "en": "Service",
          "de": "Leistung",
          "ru": "Услуга",
          "es": "Servicio",
          "it": "Servizio",
          "pt": "Serviço",
          "fr": "Prestation"
        },
        "fields": [
          {
            "key": "title",
            "label": {
              "uk": "Назва",
              "en": "Name",
              "de": "Name",
              "ru": "Название",
              "es": "Nombre",
              "it": "Nome",
              "pt": "Nome",
              "fr": "Nom"
            },
            "kind": "text",
            "required": true,
            "max": 80,
            "client_editable": true
          },
          {
            "key": "takes",
            "label": {
              "uk": "Триває",
              "en": "Takes",
              "de": "Dauer",
              "ru": "Длится",
              "es": "Duración",
              "it": "Durata",
              "pt": "Duração",
              "fr": "Durée"
            },
            "kind": "duration",
            "required": true,
            "min": 15,
            "max": 480,
            "client_editable": true
          },
          {
            "key": "costs",
            "label": {
              "uk": "Ціна",
              "en": "Price",
              "de": "Preis",
              "ru": "Цена",
              "es": "Precio",
              "it": "Prezzo",
              "pt": "Preço",
              "fr": "Prix"
            },
            "kind": "money",
            "client_editable": true
          },
          {
            "key": "per",
            "label": {
              "uk": "Ціна за",
              "en": "Priced per",
              "de": "Preis pro",
              "ru": "Цена за",
              "es": "Precio por",
              "it": "Prezzo per",
              "pt": "Preço por",
              "fr": "Prix par"
            },
            "hint": {
              "uk": "«Особу» — ціна множиться на кількість людей: місце на занятті. «Запис» — раз, скільки б їх не було.",
              "en": "«Person» — the price times the people: a place in a class. «Booking» — once, whatever the party.",
              "de": "«Person» — der Preis mal die Personen: ein Platz im Kurs. «Buchung» — einmal, egal wie viele.",
              "ru": "«Человека» — цена умножается на число людей: место на занятии. «Запись» — один раз, сколько бы их ни было.",
              "es": "«Persona»: el precio por el número de personas, una plaza en la clase. «Reserva»: una vez, sean cuantos sean.",
              "it": "«Persona»: il prezzo per il numero di persone, un posto nel corso. «Prenotazione»: una volta, quanti che siano.",
              "pt": "«Pessoa» — o preço vezes as pessoas: um lugar na aula. «Reserva» — uma vez, sejam quantos forem.",
              "fr": "« Personne » : le prix multiplié par le nombre de personnes, une place au cours. « Réservation » : une fois, quel que soit le groupe."
            },
            "kind": "select",
            "options": [
              "booking",
              "person"
            ],
            "client_editable": true
          }
        ]
      },
      {
        "type": "session",
        "v": 1,
        "label": {
          "uk": "Заняття",
          "en": "Class",
          "de": "Kurs",
          "ru": "Класс",
          "es": "Clase",
          "it": "Classe",
          "pt": "Classe",
          "fr": "Catégorie"
        },
        "fields": [
          {
            "key": "title",
            "label": {
              "uk": "Назва",
              "en": "Name",
              "de": "Name",
              "ru": "Название",
              "es": "Nombre",
              "it": "Nome",
              "pt": "Nome",
              "fr": "Nom"
            },
            "kind": "text",
            "required": true,
            "max": 80,
            "client_editable": true
          },
          {
            "key": "spots",
            "label": {
              "uk": "Місць",
              "en": "Places",
              "de": "Plätze",
              "ru": "Мест",
              "es": "Plazas",
              "it": "Posti",
              "pt": "Lugares",
              "fr": "Places"
            },
            "kind": "number",
            "min": 1,
            "max": 100,
            "required": true,
            "client_editable": true,
            "no_tap_target": true
          },
          {
            "key": "hours",
            "label": {
              "uk": "Власні години",
              "en": "Own hours",
              "de": "Eigene Zeiten",
              "ru": "Свои часы",
              "es": "Horario propio",
              "it": "Orari propri",
              "pt": "Horário próprio",
              "fr": "Horaires propres"
            },
            "kind": "list",
            "max": 21,
            "client_editable": true,
            "of": [
              {
                "key": "day",
                "label": {
                  "uk": "День",
                  "en": "Day",
                  "de": "Tag",
                  "ru": "Сутки",
                  "es": "Día",
                  "it": "Giorno",
                  "pt": "Dia",
                  "fr": "Jour"
                },
                "kind": "select",
                "options": [
                  "monday",
                  "tuesday",
                  "wednesday",
                  "thursday",
                  "friday",
                  "saturday",
                  "sunday"
                ],
                "required": true,
                "client_editable": true,
                "no_tap_target": true
              },
              {
                "key": "opens",
                "label": {
                  "uk": "Відкриття",
                  "en": "Opens",
                  "de": "Öffnet",
                  "ru": "Открытие",
                  "es": "Abre",
                  "it": "Apre",
                  "pt": "Abre",
                  "fr": "Ouverture"
                },
                "kind": "time_of_day",
                "required": true,
                "client_editable": true,
                "no_tap_target": true
              },
              {
                "key": "closes",
                "label": {
                  "uk": "Закриття",
                  "en": "Closes",
                  "de": "Schliesst",
                  "ru": "Закрытие",
                  "es": "Cierra",
                  "it": "Chiude",
                  "pt": "Fecha",
                  "fr": "Fermeture"
                },
                "kind": "time_of_day",
                "required": true,
                "client_editable": true,
                "no_tap_target": true
              }
            ]
          },
          {
            "key": "does",
            "label": {
              "uk": "Що робить",
              "en": "Does",
              "de": "Macht",
              "ru": "Что делает",
              "es": "Realiza",
              "it": "Esegue",
              "pt": "Faz",
              "fr": "Prestations assurées"
            },
            "kind": "list",
            "max": 40,
            "client_editable": true,
            "of": [
              {
                "key": "service",
                "label": {
                  "uk": "Послуга",
                  "en": "Service",
                  "de": "Leistung",
                  "ru": "Услуга",
                  "es": "Servicio",
                  "it": "Servizio",
                  "pt": "Serviço",
                  "fr": "Prestation"
                },
                "kind": "ref",
                "ref": "services",
                "required": true,
                "client_editable": true,
                "no_tap_target": true
              }
            ]
          }
        ]
      }
    ],
    "collections": [
      {
        "name": "services",
        "label": {
          "uk": "Послуги",
          "en": "Services",
          "de": "Leistungen",
          "ru": "Услуги",
          "es": "Servicios",
          "it": "Servizi",
          "pt": "Serviços",
          "fr": "Prestations"
        },
        "one": {
          "uk": "послуга",
          "en": "service",
          "de": "Leistung",
          "ru": "услуга",
          "es": "servicio",
          "it": "servizio",
          "pt": "serviço",
          "fr": "prestation"
        },
        "icon": "lucide:list",
        "prefix": "/services",
        "type": "course",
        "pages": false
      },
      {
        "name": "sessions",
        "label": {
          "uk": "Заняття",
          "en": "Classes",
          "de": "Kurse",
          "ru": "Занятия",
          "es": "Clases",
          "it": "Lezioni",
          "pt": "Aulas",
          "fr": "Cours"
        },
        "one": {
          "uk": "заняття",
          "en": "class",
          "de": "Kurs",
          "ru": "занятие",
          "es": "clase",
          "it": "lezione",
          "pt": "aula",
          "fr": "cours"
        },
        "icon": "lucide:calendar-days",
        "prefix": "/timetable",
        "type": "session",
        "pages": false
      }
    ],
    "modules": {
      "bookings": {
        "services": "services",
        "resources": "sessions"
      }
    }
  },
  "settings": {
    "kind": "sessions",
    "scale": "hourly",
    "slot_every": 15,
    "lead": 60,
    "horizon": 30,
    "party": 2,
    "confirm": "auto",
    "cancel_until": 720,
    "payment": "no",
    "combine": false
  },
  "entries": [],
  "changes": [
    {
      "from": "1",
      "says": "Five more languages: every label, collection name and rate of the kit now says ru, es, it, pt and fr beside uk, en and de (7 October 2026)."
    },
    {
      "from": "2",
      "says": "A class is priced per place: the course type carries `per`, and a party of two pays two places where before the engine charged once (8 October 2026, wiki/70)."
    }
  ]
}