Appearance
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
servicescollection, one entry per kind of class (block typecourse): 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
sessionscollection, one entry per timetable (block typesession): 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.
| collection | the diary's | uk | en | de | an entry is | where |
|---|---|---|---|---|---|---|
services | services | Послуги | Services | Leistungen | course | "route": "none", "shown_on": ["/services#services-{slug}"] |
sessions | resources | Заняття | Classes | Kurse | session | "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.
| field | value |
|---|---|
cancel_until | 720 |
combine | false |
confirm | "auto" |
horizon | 30 |
kind | "sessions" |
lead | 60 |
party | 2 |
payment | "no" |
scale | "hourly" |
slot_every | 15 |
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)."
}
]
}