Appearance
Kit: photo studio (studios)
A photo studio: halls by the hour, with time to set the hall up again after each session.
kind: photo_studio. 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
- costs: the price of an hour
- the halls: each one and what tells it from the others
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 12 hours 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 60 days ahead (
horizon). - No sooner than 2 hours from now (
lead). - 30 minutes kept free after each booking, to get ready for the next (
buffer). - Start times offered every 30 minutes (
slot_every). - Shown to visitors: every studio'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 | Тарифи | Rates | Tarife | tariff | "route": "none", "shown_on": ["/rates#services-{slug}"] |
studios | resources | Зали | Studios | Räume | studio | "route": {"detail":"/studios/{slug}"} |
Entries
What the trade is sold in — units, never prices.
| slug | uk | en | de | takes | sold in | at least | at most |
|---|---|---|---|---|---|---|---|
hour | Година | Hour | Stunde | 1 hour | hourly | — | 12 |
Several at once
Taken several times in one booking: hour 1 to 12. The form asks how many and sends it as count — on GET /api/availability (&count=<n>) and in POST /api/book ("count": <n>), the same number on both; the platform makes the end and the price from it. Not units, nights or days: the edge passes on only the fields it knows, so another name is dropped without a word and the stay is booked at its fewest. Bookings on the site has the rest, and the booking protocol the wire.
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 | 30 |
cancel_until | 1440 |
combine | false |
confirm | "by_hand" |
hold | 720 |
horizon | 60 |
kind | "photo_studio" |
lead | 120 |
payment | "no" |
scale | "hourly" |
slot_every | 30 |
The kit, whole
As GET /v1/kits/photo_studio 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": "photo_studio",
"version": 2,
"sum": "bab11e840d63",
"about": "A photo studio: halls by the hour, with time to set the hall up again after each session.",
"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",
"costs: the price of an hour",
"the halls: each one and what tells it from the others"
],
"catalogue": {
"blocks": [
{
"type": "tariff",
"v": 1,
"label": {
"uk": "Тариф",
"en": "Rate",
"de": "Tarif"
},
"fields": [
{
"key": "title",
"label": {
"uk": "Назва",
"en": "Name",
"de": "Name"
},
"kind": "text",
"required": true,
"max": 80,
"client_editable": true
},
{
"key": "takes",
"label": {
"uk": "Триває",
"en": "Takes",
"de": "Dauer"
},
"kind": "duration",
"required": true,
"min": 30,
"max": 43200,
"client_editable": true
},
{
"key": "costs",
"label": {
"uk": "Ціна",
"en": "Price",
"de": "Preis"
},
"kind": "money",
"client_editable": true
},
{
"key": "scale",
"label": {
"uk": "Одиниця",
"en": "Sold in",
"de": "Einheit"
},
"kind": "select",
"options": [
"hourly",
"daily"
],
"option_labels": {
"hourly": {
"uk": "години",
"en": "hours",
"de": "Stunden"
},
"daily": {
"uk": "доби",
"en": "days",
"de": "Tage"
}
},
"hint": {
"uk": "Години — у робочий час; доби — цілими днями.",
"en": "Hours — inside opening hours; days — whole days.",
"de": "Stunden — innerhalb der Öffnungszeiten; Tage — ganze Tage."
},
"client_editable": true,
"no_tap_target": true
},
{
"key": "fewest",
"label": {
"uk": "Щонайменше",
"en": "At least",
"de": "Mindestens"
},
"kind": "number",
"min": 1,
"max": 365,
"hint": {
"uk": "Скільки одиниць тарифу щонайменше за раз.",
"en": "The fewest units of this rate at once.",
"de": "Die wenigsten Einheiten dieses Tarifs auf einmal."
},
"client_editable": true,
"no_tap_target": true
},
{
"key": "most",
"label": {
"uk": "Щонайбільше",
"en": "At most",
"de": "Höchstens"
},
"kind": "number",
"min": 1,
"max": 365,
"hint": {
"uk": "Скільки одиниць тарифу щонайбільше за раз.",
"en": "The most units of this rate at once.",
"de": "Die meisten Einheiten dieses Tarifs auf einmal."
},
"client_editable": true,
"no_tap_target": true
}
]
},
{
"type": "studio",
"v": 1,
"label": {
"uk": "Зал",
"en": "Studio",
"de": "Raum",
"ru": "Зал",
"es": "Sala",
"it": "Sala",
"pt": "Sala",
"fr": "Salle"
},
"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": "cover",
"label": {
"uk": "Фото",
"en": "Photo",
"de": "Foto"
},
"kind": "media",
"accept": "image",
"client_editable": true
},
{
"key": "marks",
"label": {
"uk": "Відмітні ознаки",
"en": "Distinguishing marks",
"de": "Merkmale"
},
"kind": "text",
"max": 80,
"hint": {
"uk": "Що відрізняє від схожих: колір і номер, поверх, серійний номер.",
"en": "What tells it from its twins: colour and plate, floor, serial number.",
"de": "Was es von gleichen unterscheidet: Farbe und Kennzeichen, Stockwerk, Seriennummer."
},
"client_editable": true,
"no_tap_target": true
}
]
}
],
"collections": [
{
"name": "services",
"label": {
"uk": "Тарифи",
"en": "Rates",
"de": "Tarife",
"ru": "Тарифы",
"es": "Tarifas",
"it": "Tariffe",
"pt": "Tarifas",
"fr": "Tarifs"
},
"one": {
"uk": "тариф",
"en": "rate",
"de": "Tarif",
"ru": "тариф",
"es": "tarifa",
"it": "tariffa",
"pt": "tarifa",
"fr": "tarif"
},
"icon": "lucide:tag",
"prefix": "/rates",
"type": "tariff",
"pages": false
},
{
"name": "studios",
"label": {
"uk": "Зали",
"en": "Studios",
"de": "Räume",
"ru": "Залы",
"es": "Salas",
"it": "Sale",
"pt": "Salas",
"fr": "Salles"
},
"one": {
"uk": "зал",
"en": "studio",
"de": "Raum",
"ru": "зал",
"es": "sala",
"it": "sala",
"pt": "sala",
"fr": "salle"
},
"icon": "lucide:camera",
"prefix": "/studios",
"type": "studio"
}
],
"modules": {
"bookings": {
"services": "services",
"resources": "studios"
}
}
},
"settings": {
"kind": "photo_studio",
"scale": "hourly",
"slot_every": 30,
"buffer": 30,
"lead": 120,
"horizon": 60,
"confirm": "by_hand",
"hold": 720,
"cancel_until": 1440,
"payment": "no",
"combine": false
},
"entries": [
{
"collection": "services",
"slug": "hour",
"fields": {
"title": {
"uk": "Година",
"en": "Hour",
"de": "Stunde",
"ru": "Час",
"es": "Hora",
"it": "Ora",
"pt": "Hora",
"fr": "Heure"
},
"takes": 60,
"scale": "hourly",
"most": 12
}
}
],
"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)."
}
]
}