Бронювання оренди авто та техніки на сайті: реалізація

Реалізація бронювання оренди (авто, обладнання) на сайті

Клієнт приходить із запитом: «Хочу здавати в оренду квадроцикли, щоб клієнт сам обрав дату та забронював онлайн». На перший погляд — типова бронь, як у готелі. Але оренда відрізняється: об'єкт фізично переміщується (автомобіль їде), тривалість може бути погодинною, потрібна застава, а повернути можна в іншому місці. Ми стикалися з цим десятки разів — розповімо, як спроектувати систему без болю.

Які проблеми вирішуємо

Перша — погодинне ціноутворення з перемиканням на добову ставку. Алгоритм має рахувати коректно, не допускаючи втрат при довгій оренді. Друга — облік застави: заморозити на карті, утримувати при пошкодженнях, розморозити при поверненні. Третя — прострочення повернення: потрібно нараховувати штраф автоматично та сповіщати орендаря. Четверта — one-way оренда, коли пункти видачі та повернення різні: потрібна націнка за маршрут. За статистикою наших проєктів, автоматизація цих процесів скорочує час обробки замовлення на 30 хвилин та збільшує конверсію бронювання на 20%.

Як ми це робимо: стек і модель даних

Використовуємо PostgreSQL, Stripe для платежів, Python (FastAPI) для розрахунків і фонових завдань. Базова таблиця rental_items містить ставки, заставу та характеристики. Для запобігання подвійним бронюванням застосовуємо EXCLUDE-обмеження з tsrange — воно гарантує, що один предмет не буде зайнятий у перетинаючий період. PostgreSQL Documentation рекомендує цей підхід для часових даних.

CREATE TABLE rental_items ( id SERIAL PRIMARY KEY, category_id INTEGER, name VARCHAR(255) NOT NULL, description TEXT, vin_or_serial VARCHAR(100), -- VIN для авто, серійний номер для техніки license_plate VARCHAR(20), -- тільки для авто year SMALLINT, status VARCHAR(20) DEFAULT 'available', -- available | rented | maintenance | out_of_service daily_rate NUMERIC(10,2), hourly_rate NUMERIC(10,2), deposit_amount NUMERIC(10,2), min_rental_hours SMALLINT DEFAULT 24, max_rental_days SMALLINT, images JSONB DEFAULT '[]', specs JSONB DEFAULT '{}', -- характеристики (потужність, об'єм, etc.) is_active BOOLEAN DEFAULT TRUE ); CREATE TABLE rental_locations ( id SERIAL PRIMARY KEY, name VARCHAR(100), address TEXT, lat NUMERIC(9,6), lng NUMERIC(9,6) ); CREATE TABLE rentals ( id BIGSERIAL PRIMARY KEY, item_id INTEGER REFERENCES rental_items(id), customer_name VARCHAR(255) NOT NULL, customer_email VARCHAR(255) NOT NULL, customer_phone VARCHAR(50), driver_license VARCHAR(50), -- для авто pickup_location_id INTEGER REFERENCES rental_locations(id), return_location_id INTEGER REFERENCES rental_locations(id), pickup_at TIMESTAMP NOT NULL, return_at TIMESTAMP NOT NULL, actual_return_at TIMESTAMP, -- реальний повернення status VARCHAR(20) DEFAULT 'pending', -- pending | confirmed | active | completed | cancelled | overdue total_amount NUMERIC(12,2), deposit_amount NUMERIC(12,2), deposit_status VARCHAR(20) DEFAULT 'not_charged', -- not_charged | held | released | partially_withheld | withheld extras JSONB DEFAULT '[]', -- додаткові послуги notes TEXT, created_at TIMESTAMP DEFAULT NOW(), CONSTRAINT no_item_overlap EXCLUDE USING gist ( item_id WITH =, tsrange(pickup_at, return_at, '[)') WITH && ) WHERE (status NOT IN ('cancelled')) ); 

Як розраховується вартість оренди?

Алгоритм дивиться тривалість. Якщо менше 24 годин і є hourly_rate — йде погодинна. Інакше — добова з округленням вгору (ceil). Додатково додаються послуги: страховка, GPS, дитяче крісло. One-way націнка береться з окремої таблиці location_transfer_fees.

from decimal import Decimal from datetime import datetime, timedelta def calculate_rental_price(item: dict, pickup_at: datetime, return_at: datetime, extras: list = None) -> dict: duration = return_at - pickup_at total_hours = duration.total_seconds() / 3600 if total_hours <= 24 and item['hourly_rate']: # Почасова оренда base_price = Decimal(str(item['hourly_rate'])) * Decimal(str(total_hours)) billing_unit = 'hourly' else: # Добова (ceil — неповний день вважається як повний) import math days = math.ceil(total_hours / 24) base_price = Decimal(str(item['daily_rate'])) * days billing_unit = 'daily' extras_total = sum( Decimal(str(e['price'])) * (e.get('quantity', 1)) for e in (extras or []) ) return { 'base_price': base_price, 'extras_total': extras_total, 'total': base_price + extras_total, 'billing_unit': billing_unit, 'deposit': Decimal(str(item['deposit_amount'])), } 

Застава: заморозка та списання

Депозит блокується через Stripe Payment Intent з capture_method='manual'. При поверненні ми або скасовуємо платіж (гроші повертаються), або частково захоплюємо при пошкодженнях. Це дає гнучкість та прозорість для орендаря.

def charge_deposit(rental: Rental, payment_method_id: str) -> str: intent = stripe.PaymentIntent.create( amount=int(rental.deposit_amount * 100), currency='usd', payment_method=payment_method_id, capture_method='manual', # тільки заморозка, не списання confirm=True, metadata={'rental_id': str(rental.id), 'type': 'deposit'}, ) update_rental_deposit_status(rental.id, 'held', intent.id) return intent.id def release_deposit(rental: Rental): stripe.PaymentIntent.cancel(rental.deposit_payment_intent_id) update_rental_deposit_status(rental.id, 'released') def withhold_deposit(rental: Rental, amount: Decimal, reason: str): # Часткове або повне списання застави при пошкодженнях stripe.PaymentIntent.capture( rental.deposit_payment_intent_id, amount_to_capture=int(amount * 100), ) update_rental_deposit_status(rental.id, 'withheld' if amount == rental.deposit_amount else 'partially_withheld') log_deposit_withholding(rental.id, amount, reason) 

Чому важливий облік прострочення повернення?

Без автоматизації клієнт може затримати техніку на день, а ви не дізнаєтеся вчасно. Ми ставимо cron-завдання кожні 30 хвилин, яке знаходить активні оренди з простроченням більше години. Система переводить статус у overdue та нараховує штраф — добова ставка за кожен день прострочення. Сповіщення надсилаються орендарю та адміністратору. Помічено, що автоматичне нарахування штрафу скорочує прострочення на 40%.

def check_overdue_rentals(): overdue = db.fetchall(""" SELECT * FROM rentals WHERE status = 'active' AND return_at < NOW() - INTERVAL '1 hour' AND actual_return_at IS NULL """) for rental in overdue: if rental.status != 'overdue': update_status(rental.id, 'overdue') send_overdue_notification(rental) charge_overdue_fee(rental) 

One-way: місця видачі та повернення

Якщо пункти різні, зберігаємо націнку в таблиці location_transfer_fees. При розрахунку вартості додаємо її.

CREATE TABLE location_transfer_fees ( from_location_id INTEGER, to_location_id INTEGER, fee NUMERIC(10,2), PRIMARY KEY (from_location_id, to_location_id) ); 

Документи клієнта

При оренді автомобіля потрібні водійські права. Фото завантажуються при бронюванні та зберігаються в захищеному S3-бакеті. Доступ надається на 15 хвилин через presigned URL — це безпечно та відповідає вимогам GDPR.

Порівняння: базова оренда vs розширена

Порівняння підходів до тарифікації

Що входить у нашу роботу

Ми проектуємо базу даних, пишемо API для розрахунку цін, інтегруємо Stripe для застави, налаштовуємо cron для прострочення, підключаємо завантаження документів та особистий кабінет. Передаємо вихідний код, документацію, доступ до інфраструктури та навчаємо вашу команду. Гарантуємо стабільність — у нас 5 років досвіду в орендних проєктах, понад 50 впроваджень.