Appearance
Kit: apartments (apartments)
Apartments by the night: check-in and check-out hours, the guests an apartment sleeps.
kind: apartments. 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
- costs: the price of a night — the kit's rate is the unit, never a price
- the apartments: each one's guests, and what tells it from the others (a floor, a number) — shown to visitors when they choose one; not the street address unless the client wants it printed
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 3 days 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? - Handed over at 14:00 and brought back at 12:00 on the last day (
hand_out,hand_back). - Bookable up to 365 days ahead (
horizon). - Bookable for today, with no notice (
lead: 0). - Shown to visitors: every apartment'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}"] |
apartments | resources | Квартири | Apartments | Wohnungen | apartment | "route": {"detail":"/apartments/{slug}"} |
Entries
What the trade is sold in — units, never prices.
| slug | uk | en | de | takes | sold in | at least | at most |
|---|---|---|---|---|---|---|---|
night | Ніч | Night | Nacht | 1 day | daily | 1 | 30 |
Several at once
Taken several times in one booking: night 1 to 30. 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 |
|---|---|
cancel_until | 4320 |
combine | false |
confirm | "by_hand" |
hand_back | 720 |
hand_out | 840 |
hands_over | true |
hold | 1440 |
horizon | 365 |
kind | "apartments" |
lead | 0 |
payment | "no" |
scale | "daily" |
The kit, whole
As GET /v1/kits/apartments 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": "apartments",
"version": 2,
"sum": "1fce2b5155a1",
"about": "Apartments by the night: check-in and check-out hours, the guests an apartment sleeps.",
"ask": [
"zone: the business's time zone — from its address; say it back rather than asking",
"costs: the price of a night — the kit's rate is the unit, never a price",
"the apartments: each one's guests, and what tells it from the others (a floor, a number) — shown to visitors when they choose one; not the street address unless the client wants it printed"
],
"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": "apartment",
"v": 1,
"label": {
"uk": "Квартира",
"en": "Apartment",
"de": "Wohnung",
"ru": "Квартира",
"es": "Apartamento",
"it": "Appartamento",
"pt": "Apartamento",
"fr": "Appartement"
},
"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": "seats",
"label": {
"uk": "Гостей",
"en": "Guests",
"de": "Gäste",
"ru": "Гостей",
"es": "Huéspedes",
"it": "Ospiti",
"pt": "Hóspedes",
"fr": "Personnes"
},
"kind": "number",
"min": 1,
"max": 20,
"client_editable": true,
"no_tap_target": 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": "apartments",
"label": {
"uk": "Квартири",
"en": "Apartments",
"de": "Wohnungen",
"ru": "Квартиры",
"es": "Apartamentos",
"it": "Appartamenti",
"pt": "Apartamentos",
"fr": "Appartements"
},
"one": {
"uk": "квартира",
"en": "apartment",
"de": "Wohnung",
"ru": "квартира",
"es": "apartamento",
"it": "appartamento",
"pt": "apartamento",
"fr": "appartement"
},
"icon": "lucide:building",
"prefix": "/apartments",
"type": "apartment"
}
],
"modules": {
"bookings": {
"services": "services",
"resources": "apartments"
}
}
},
"settings": {
"kind": "apartments",
"scale": "daily",
"hand_out": 840,
"hand_back": 720,
"hands_over": true,
"lead": 0,
"horizon": 365,
"confirm": "by_hand",
"hold": 1440,
"cancel_until": 4320,
"payment": "no",
"combine": false
},
"entries": [
{
"collection": "services",
"slug": "night",
"fields": {
"title": {
"uk": "Ніч",
"en": "Night",
"de": "Nacht",
"ru": "Ночь",
"es": "Noche",
"it": "Notte",
"pt": "Noite",
"fr": "Nuit"
},
"takes": 1440,
"scale": "daily",
"fewest": 1,
"most": 30
}
}
],
"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)."
}
]
}