Головна › Бібліотека › Порушення договорів

Порушення договорів

Фіксуйте та відстежуйте порушення умов договору наймачами

Огляд

Модуль порушень договору дозволяє документувати та відстежувати випадки недотримання умов орендного договору. Кожне порушення може бути пов'язане з конкретними пунктами договору та підтверджене фотодоказами.

!

Відстеження порушень

Ведіть історію всіх порушень по кожному об'єкту та договору

Прив'язка до пунктів

Вказуйте які саме пункти договору були порушені

Фотодокази

Прикріплюйте фото та документи для підтвердження порушень

Рівні серйозності

Оцінюйте серйозність порушень за шкалою від 1 до 10

Рівні серйозності

Система використовує 4 рівні серйозності для класифікації порушень:

1-3

Низький - незначні порушення, попередження

4-5

Середній - помірні порушення, потребують уваги

6-8

Високий - серйозні порушення, можуть призвести до штрафів

9-10

Критичний - підстава для розірвання договору

Процес роботи

Типовий процес документування порушення:

1

Виявлення

Власник виявляє порушення умов договору

2

Документування

Створення запису з описом, датою та рівнем серйозності

3

Докази

Прикріплення фото та прив'язка до пунктів договору

4

Сповіщення

Порушник може переглянути зафіксоване порушення

Права доступу

Різні користувачі мають різні права:

Дія Хто може
Створення порушення Власники, адміністратори
Перегляд порушення Власники, адміністратори, порушник
Редагування порушення Власники, адміністратори
Видалення порушення Власники, адміністратори
Прикріплення документів Власники, адміністратори

Automatic Overdue Payment Control

The system automatically detects late payments and creates contract violations. A daily cron job (app:payments:check-overdue) runs at 05:00 UTC and checks the previous month's payments.

How it works

  1. For each property with an active contract, the system reads RENT_PAYMENT_DAY and UTILITIES_PAYMENT_DAY + grace period from the contract blocks
  2. Finds payments made after the deadline (charge date + grace period)
  3. Groups overdue payments by deadline date
  4. Creates a ContractViolation with auto-generated description in the tenant's language
  5. Links overdue payments to the violation via violation_overdue_payments junction table

Severity rules

Days overdueSeverityLevel
1–53Low
6–145Medium
15–307High
31+9Critical

Utilities overdue always gets severity 5 (medium).

If a contract does not have RENT_PAYMENT_DAY or UTILITIES_PAYMENT_DAY blocks — no violation is created for that type.

Payment linking

Each violation can be linked to one or more overdue payments. One payment can be linked to at most one violation (UNIQUE constraint). Payments can also be linked manually when creating or editing a violation.

REST API

REST API для інтеграції з зовнішніми системами:

Примітка рівня обслуговування

GET    /api/v1/properties/{id}/violations           - Список порушень
POST   /api/v1/properties/{id}/violations           - Створити порушення
GET    /api/v1/properties/{id}/violations/{vid}     - Деталі порушення
PUT    /api/v1/properties/{id}/violations/{vid}     - Оновити порушення
DELETE /api/v1/properties/{id}/violations/{vid}     - Видалити порушення
POST   /api/v1/properties/{id}/violations/{vid}/documents      - Прикріпити документ
DELETE /api/v1/properties/{id}/violations/{vid}/documents/{did} - Відкріпити документ

GET    /api/v1/properties/{id}/violations/{vid}/overdue-payments          - List linked overdue payments
POST   /api/v1/properties/{id}/violations/{vid}/overdue-payments          - Link payments (payment_ids[])
DELETE /api/v1/properties/{id}/violations/{vid}/overdue-payments/{payId}  - Unlink payment
GET    /api/v1/properties/{id}/overdue-payments                          - List unlinked overdue payments

Приклад відповіді

{
  "data": [
    {
      "id": 1,
      "property_id": 5,
      "contract_id": 12,
      "violation_date": "2026-01-10",
      "severity": 7,
      "severity_level": "high",
      "description": "Unauthorized subletting of the property to third party",
      "violator": {
        "id": 15,
        "name": "John Tenant"
      },
      "created_by": {
        "id": 8,
        "name": "Owner Name"
      },
      "documents_count": 2,
      "blocks": [
        {
          "id": 5,
          "code": "SUBLETTING",
          "name": "Subletting Prohibition"
        }
      ],
      "created_at": "2026-01-10T14:30:00+00:00"
    }
  ],
  "total": 1,
  "page": 1,
  "totalPages": 1
}

Swagger / OpenAPI

Повна документація API доступна за адресою /api/v1/doc