Appearance
Kit: clinic (doctors)
A clinic or a dental practice: appointments by the hour with a doctor, confirmed by the practice.
kind: clinic. 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
- hours: when it is open — the kit does not guess them
- the services: each one's takes and costs
- the doctors: who they are, their own hours, which services each one sees patients for
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.
- Every booking waits for the business to confirm it (
confirm: by_hand), holding its time for a day and then lapsing (hold) — or are bookings confirmed at once? - A visitor may cancel or move their booking themselves until a day 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 180 days ahead (
horizon). - No sooner than 2 hours from now (
lead). - 5 minutes kept free after each booking, to get ready for the next (
buffer). - Start times offered every 15 minutes (
slot_every). - Shown to visitors: every doctor'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 | service | "route": "none", "shown_on": ["/services#services-{slug}"] |
doctors | resources | Лікарі | Doctors | Ärztinnen und Ärzte | doctor | "route": {"detail":"/doctors/{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 |
|---|---|
buffer | 5 |
cancel_until | 1440 |
combine | false |
confirm | "by_hand" |
hold | 1440 |
horizon | 180 |
kind | "clinic" |
lead | 120 |
payment | "no" |
scale | "hourly" |
slot_every | 15 |
The kit, whole
As GET /v1/kits/clinic 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": "clinic",
"version": 3,
"sum": "a2197b365fcf",
"about": "A clinic or a dental practice: appointments by the hour with a doctor, confirmed by the practice.",
"ask": [
"zone: the business's time zone — from its address; say it back rather than asking",
"hours: when it is open — the kit does not guess them",
"the services: each one's takes and costs",
"the doctors: who they are, their own hours, which services each one sees patients for"
],
"catalogue": {
"blocks": [
{
"type": "service",
"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": 5,
"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
}
]
},
{
"type": "doctor",
"v": 1,
"label": {
"uk": "Лікар",
"en": "Doctor",
"de": "Ärztin oder Arzt",
"ru": "Врач",
"es": "Médico",
"it": "Medico",
"pt": "Médico",
"fr": "Médecin"
},
"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,
"localized": false
},
{
"key": "cover",
"label": {
"uk": "Фото",
"en": "Photo",
"de": "Foto"
},
"kind": "media",
"accept": "image",
"client_editable": 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": "service",
"pages": false
},
{
"name": "doctors",
"label": {
"uk": "Лікарі",
"en": "Doctors",
"de": "Ärztinnen und Ärzte",
"ru": "Врачи",
"es": "Médicos",
"it": "Medici",
"pt": "Médicos",
"fr": "Médecins"
},
"one": {
"uk": "лікар",
"en": "doctor",
"de": "Ärztin oder Arzt",
"ru": "врач",
"es": "médico",
"it": "medico",
"pt": "médico",
"fr": "médecin"
},
"icon": "lucide:stethoscope",
"prefix": "/doctors",
"type": "doctor"
}
],
"modules": {
"bookings": {
"services": "services",
"resources": "doctors"
}
}
},
"settings": {
"kind": "clinic",
"scale": "hourly",
"slot_every": 15,
"buffer": 5,
"lead": 120,
"horizon": 180,
"confirm": "by_hand",
"hold": 1440,
"cancel_until": 1440,
"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 doctor's name is the same in every language: on a contract-3 site the `title` of the `doctor` type says `\"localized\": false`, so it is not counted as words to translate — add it to your schema; a contract-2 schema has no such key and leaves it out (12 November 2026)."
}
]
}