Знакът на КАГАМИ КАГАМИ
kagami.bg/academy · lesson · machine-readable viewVERIFIED 2026-10-01 · UPDATED 2026-10-01
IDENTITY
module
GX10-04-111 · Fee payment reminders: polite escalation D+1 to D+30 with human approval
series
GX10 (local AI server class: NVIDIA GB10, e.g. ASUS Ascent GX10 / DGX Spark)
level
Intermediate
duration
1-2 h
prerequisites
Python 3.10+ (any machine; no GPU needed), PostgreSQL and n8n for the production wiring (see the n8n schedules lesson), a fee list with due date and amount in EUR, a recorded legal basis or consent per recipient and channel
trust_label
VERIFIED 2026-10-01 (n8n schedule logic aligned with the reviewed n8n schedules lesson; schwifty 2026.7.3, reportlab 5.0.1 and psycopg2-binary 2.9.13 on PyPI; ollama mistral:7b exists) · UPDATED 2026-10-01 · scheduling, template and matching code RUN on fictional data in a Linux sandbox with Python 3.10.12 (not a GB10-class machine, so no TESTED label); the PostgreSQL schema, the n8n wiring, e-mail and SMS delivery were NOT run; norm texts quoted from primary sources on 2026-10-01, their application must be confirmed by a lawyer
language
human view: bg · english edition: /en/academy/gx10/ (same file name)
previous / next
series order: 04-110 multi-agent signal pipeline / 04-112 S3 document storage (related: 04-01b n8n for condominium management, 04-116 dashboard over Postgres, 04-132 bank statement reconciliation; related topic: n8n schedules and cron lesson)
PURPOSE

Remind residents of unpaid monthly fees on a fixed, polite schedule: level 1 at D+1, level 2 at D+7, level 3 at D+14 (all automatic, e-mail or SMS, only with a recorded basis and no dispute or opt-out), level 4 at D+30 which is never sent automatically but becomes a task for the manager. A reminder day that falls on a weekend or an official holiday moves to the next workday. Messages come from fixed templates filled by code (no language model writes or sends text), amounts are Decimal EUR, and any escalation beyond level 3 is a human decision.

KEY CONCEPTS
COMMANDS / PATHS
CHECKLIST
NEXT MODULE

04-112 S3 document storage: versions and retention (04-112_MinIO_Document_Storage.html) · related: 04-116 dashboard over Postgres and Ollama, 04-01b n8n for condominium management, 04-132 bank statement reconciliation, the n8n schedules and cron lesson · GX10 series index · offer: Quick experiment (kagami.bg/stalbata/)

SOURCES
TAGS
gx10payment-remindersescalationn8nscheduledecimalibangdprhuman-in-the-loopcondominium
ПРОВЕРЕНО · 01.10.2026 ОБНОВЕНО · 01.10.2026

Напомняния за такси: учтиви, по график, с човек

Всеки месец някой забравя да плати таксата, а домоуправителят губи часове да проверява, да звъни и да пише. Тук строим малък помощник, който сам напомня учтиво и по график от първия до тридесетия ден след срока, пази работните дни и празниците и никога не ескалира сам — това решава човек. Лични данни и суми остават на твоя сървър.

⏱ 1–2 ч Средно ниво GX10 D+1 … D+30 · EUR · e-mail/SMS Python · PostgreSQL · n8n
Python (само стандартна библиотека)🔒 локално PostgreSQL · n8n🔒 локално SMS шлюз по избор (получава телефон и текст)🌐 глобален
🔄
ОБНОВЕНО · 01.10.2026 — какво (обобщено)
Урокът е преработен изцяло. Махнахме: реалните имена, адреси и сметки от старата версия (примерите са измислени, сметката е примерен IBAN от публична документация), сумите в лева, твърдите числа за „пилотно внедряване“ (нямаше как да се проверят), ескалационния тон с лихва, „протокол на Общото събрание“ и „нотариална заверка“ в автоматичните съобщения, канала WhatsApp, текста, пишан от езиков модел, и паролата във връзката към базата. Добавихме: учтиви фиксирани шаблони; график в работни дни със списък на празниците (както в Обучение 7 на n8n); ниво 4 без автоматично изпращане — задача за човека; спирачки (платено, несъгласие, спор, липса на основание); суми в EUR с Decimal; проверка на IBAN; основание за превод само с латински букви; предложение за съпоставяне на плащане без автоматично осчетоводяване; правна бележка за основание, съгласие и ЗЕС; измислени данни, показан реален изход и тест.
🧪
Какво пуснахме и какво не
Кодът за график, нива, шаблони, проверка на IBAN и съпоставяне го пуснахме наистина върху измислени данни в тестова Linux среда (Python 3.10.12, без външни пакети). Изходът в урока е от това пускане. Това не е машина от класа GB10, затова няма етикет „ТЕСТВАНО“; а ядрото така или иначе не иска видеокарта.
⚠️
Какво не сме пускали сами
Не сме пускали схемата в PostgreSQL, свързването с n8n, изпращането на e-mail и SMS и PDF извлечението. Не сме проверявали колко части (сегменти) струва SMS на кирилица при твоя доставчик и дали твоята банка приема само латински в основанието. Нормите (GDPR чл. 6, ЗУЕС чл. 6 и чл. 48, ЗЕС чл. 261) цитираме с пълния текст от първоизточник към 01.10.2026, но кое основание важи за твоята сграда е тълкуване — потвърждава го юристът на твоята етажна собственост или фирма.

01Какво ще научиш

02Преди да започнеш

НивоКогаТон и каналКой решава
1D+1Меко напомняне, с „ако вече сте платили, игнорирайте“. E-mail или кратък SMSАвтоматично
2D+7Сума, срок и телефон за въпросиАвтоматично
3D+14Пак учтиво; предлага разговор, ако има затруднениеАвтоматично
4D+30Не се праща. Става задача за домоуправителяЧовек
💡
Защо без заплахи
Автоматичното съобщение не знае дали човекът е болен, в чужбина или е платил вчера. Затова то само напомня. Лихви, срещи на собствениците и други мерки са решение на хора по правилата на твоята сграда — не на скрипт.

03Стъпки

  1. Идеята в четири реда

    (1) Всеки ден в работен ден кодът гледа всички неплатени такси. (2) За всяка пита: падна ли ден за ниво, което още не е изпратено? (3) Спира, ако е платено, има спор, отказ или няма основание. (4) Нива 1–3 стават готови съобщения от шаблон; ниво 4 става задача за човек. Всичко се записва, за да не се изпрати два пъти.

  2. Схема на данните

    Три таблици: хора (с отбелязано основание по канал, отказ и спор), такси (в EUR) и дневник на напомнянията. Ограничението UNIQUE (fee_id, level) не позволява едно ниво да се изпрати два пъти.

    sql · не е пускано от нас ⚠️
    CREATE TABLE residents (
      id           SERIAL PRIMARY KEY,
      building     VARCHAR(20)  NOT NULL,
      apt          VARCHAR(10)  NOT NULL,
      full_name    VARCHAR(100) NOT NULL,
      email        VARCHAR(100),
      phone        VARCHAR(20),
      email_ok_at  TIMESTAMPTZ,            -- кога и на какво основание е записано за e-mail
      sms_ok_at    TIMESTAMPTZ,            -- същото за SMS
      opted_out_at TIMESTAMPTZ,            -- човекът е поискал да не получава
      dispute      BOOLEAN NOT NULL DEFAULT FALSE
    );
    
    CREATE TABLE fees (
      id          SERIAL PRIMARY KEY,
      resident_id INTEGER REFERENCES residents(id),
      period      CHAR(6)       NOT NULL,   -- 202610
      due_date    DATE          NOT NULL,
      amount_eur  NUMERIC(10,2) NOT NULL,
      paid_eur    NUMERIC(10,2) NOT NULL DEFAULT 0
    );
    
    CREATE TABLE reminder_log (
      id        SERIAL PRIMARY KEY,
      fee_id    INTEGER REFERENCES fees(id),
      level     SMALLINT NOT NULL CHECK (level BETWEEN 1 AND 4),
      channel   VARCHAR(10) CHECK (channel IN ('email','sms')),
      status    VARCHAR(20) NOT NULL
                CHECK (status IN ('ready','sent','skipped','needs_human','done')),
      sent_at   TIMESTAMPTZ,
      UNIQUE (fee_id, level)
    );
  3. График, нива и шаблони

    Защо работни дни: D+7 може да падне в неделя, а D+30 — в събота. Ден за ниво L е следващият работен ден след „срок + отместване“. Списъкът с празниците за 2026 е същият като в Обучение 7 на n8n (сверен там; проверявай го всяка година, а неприсъствените дни, обявени допълнително, добавяй ръчно). Защо най-високото неизпратено ниво: ако системата е била спряна, не искаме три съобщения накуп — изпращаме най-късното дължимо, а по-ранните се прескачат. Защо шаблон: сумата и срокът идват от базата, не от модел.

    python · reminders.py
    from dataclasses import dataclass, field
    from datetime import date, timedelta
    from decimal import Decimal
    
    CENT = Decimal("0.01")
    OFFSETS = {1: 1, 2: 7, 3: 14, 4: 30}      # ниво -> дни след крайния срок
    
    # Официални почивни дни 2026 - същият списък като в n8n · Обучение 7
    HOLIDAYS = {date.fromisoformat(d) for d in (
        "2026-01-01", "2026-03-03", "2026-04-10", "2026-04-13", "2026-05-01",
        "2026-05-06", "2026-05-25", "2026-09-07", "2026-09-22", "2026-12-24",
        "2026-12-25", "2026-12-28")}
    
    def is_workday(d, holidays=HOLIDAYS):
        return d.weekday() < 5 and d not in holidays
    
    def next_workday(d, holidays=HOLIDAYS):
        while not is_workday(d, holidays):
            d += timedelta(days=1)
        return d
    
    @dataclass
    class Fee:
        apt: str
        due: date
        amount: Decimal                      # EUR
        paid: Decimal = Decimal("0")
        sent_levels: set = field(default_factory=set)
        consent: bool = False                # записано основание/съгласие за канала
        opted_out: bool = False
        disputed: bool = False
    
    def level_due(fee, today, holidays=HOLIDAYS):
        """Кое ниво е дължимо днес (или None). Най-високото неизпратено;
        ако системата е била спряла, по-ниските се прескачат, а не се изпращат накуп."""
        if not is_workday(today, holidays):
            return None
        if fee.paid >= fee.amount or fee.opted_out or fee.disputed or not fee.consent:
            return None
        due_levels = [lv for lv, off in OFFSETS.items()
                      if next_workday(fee.due + timedelta(days=off), holidays) <= today
                      and lv not in fee.sent_levels]
        if not due_levels:
            return None
        lv = max(due_levels)
        # същият ден не пращаме две нива; ако е бил изпратен по-висок - нищо
        if fee.sent_levels and max(fee.sent_levels) > lv:
            return None
        return lv
    
    def balance(fee):
        return (fee.amount - fee.paid).quantize(CENT)
    
    TEXT = {
     1: "Здравейте! Напомняне за такса {month} за ап. {apt}: {bal} EUR. Ако вече сте платили, игнорирайте съобщението. Домоуправител Пример",
     2: "Здравейте! Таксата за ап. {apt} ({month}) още не е постъпила: {bal} EUR до {deadline}. Въпроси: {phone}. Домоуправител Пример",
     3: "Здравейте! Таксата за ап. {apt} ({month}) остава неплатена: {bal} EUR. Ако имате затруднение, обадете се на {phone} и ще се разберем. Домоуправител Пример",
    }
    
    def draft(fee, level, month, phone="<тел. на домоуправителя>", today=None):
        if level == 4:   # не се изпраща автоматично
            return {"apt": fee.apt, "level": 4, "status": "needs_human",
                    "note": f"{balance(fee)} EUR неплатени 30 дни след срока - домоуправителят решава как да продължи"}
        deadline = (today + timedelta(days=7)).strftime("%d.%m.%Y") if today else ""
        t = TEXT[level].format(month=month, apt=fee.apt, bal=f"{balance(fee):.2f}".replace(".", ","),
                               deadline=deadline, phone=phone)
        return {"apt": fee.apt, "level": level, "status": "ready", "text": t}
    
    def iban_ok(iban):
        s = iban.replace(" ", "").upper()
        if not (15 <= len(s) <= 34) or not s.isalnum():
            return False
        r = s[4:] + s[:4]
        return int("".join(str(int(c, 36)) for c in r)) % 97 == 1

    Последната функция е проверка на IBAN по mod 97 (ISO 13616) — хваща грешно препечатана сметка, преди да я сложиш в съобщение. Библиотека като schwifty (2026.7.3 в PyPI) прави и повече — разбира банка и държава, — но не я пускахме ⚠️.

    ⚠️
    Телефонът и срокът са плейсхолдъри
    В примера телефонът е <тел. на домоуправителя> и не се пише твърдо в кода. Крайният срок в ниво 2 е „днес + 7 дни“ — смени го според правилата на сградата си.
  4. Пусни го върху измислени данни

    Четири измислени апартамента с краен срок четвъртък, 10.09.2026: ап. 12 е редовен длъжник със съгласие, ап. 13 няма записано основание, ап. 14 е платил част, ап. 15 е в спор.

    python · run_demo.py
    from reminders import *
    
    due = date(2026, 9, 10)                       # краен срок (измислен)
    fees = [Fee("12", due, Decimal("25.00"), consent=True),
            Fee("13", due, Decimal("25.00"), consent=False),
            Fee("14", due, Decimal("25.00"), paid=Decimal("10.00"), consent=True),
            Fee("15", due, Decimal("25.00"), consent=True, disputed=True)]
    for today in (date(2026, 9, 11), date(2026, 9, 17), date(2026, 10, 12)):
        for f in fees:
            lv = level_due(f, today)
            if lv:
                d = draft(f, lv, "септември", today=today)
                print(today, "ап.", d["apt"], "ниво", lv, d["status"])
    print(iban_ok("DE89 3704 0044 0532 0130 00"), iban_ok("DE89 3704 0044 0532 0130 01"))

    Изходът от нашето пускане (измислени данни):

    изход
    2026-09-11 ап. 12 ниво 1 ready
    2026-09-11 ап. 14 ниво 1 ready
    2026-09-17 ап. 12 ниво 2 ready
    2026-09-17 ап. 14 ниво 2 ready
    2026-10-12 ап. 12 ниво 4 needs_human
    2026-10-12 ап. 14 ниво 4 needs_human
    True False

    Какво виждаме: ап. 13 (няма основание) и ап. 15 (спор) не получават нищо. D+30 е събота, 10.10.2026, затова ниво 4 е в понеделник, 12.10. Демото не записва „изпратено“, затова на 12.10 излиза направо ниво 4 — така се държи и истинският график след прекъсване. Текстът за ап. 14 при ниво 1 е с остатъка: 15,00 EUR, не с целия 25,00.

    ✅
    Какво проверихме отделно
    На 22.09.2026 (празник) is_workday връща False, а next_workday(07.09.2026) дава 08.09. Ап. без никакво изпращане до D+20 получава ниво 3 (най-високото дължимо), не три съобщения. iban_ok връща True за примерния IBAN от документацията и False, когато смениш последната цифра. Дължини на примерните текстове: 129, 141 и 170 знака.
    📱
    SMS на кирилица е по-скъп
    Кирилицата обикновено се изпраща в кодиране, което побира около 70 знака на съобщение, затова 129–170 знака са няколко части. По тази причина основният канал е e-mail, а SMS е кратък. Колко части и колко струват при твоя доставчик — питай го ⚠️.
  5. Ниво 4 е задача, не съобщение

    На D+30 системата не пише нищо на човека. Тя добавя ред в дневника със статус needs_human и известява домоуправителя: „ап. 12 · 25,00 EUR · 30 дни след срока“. Домоуправителят се обажда, говори, може да разсрочи, да сложи въпроса на срещата на собствениците или да не прави нищо. Всичко извън тези три шаблона е негово решение. Така „ескалация“ е човешко действие, а не следствие от таймер.

  6. Свързване с n8n

    n8n пуска графика — в работни дни в 10:00. По Обучение 7 изразът е с шест полета, а часовата зона е Европа/София:

    cron · Schedule Trigger (Custom)
    0 0 10 * * 1-5

    Веригата: Schedule Trigger → Postgres (неплатени такси с хората) → логиката от reminders.py → If (готово за изпращане?) → Send Email или SMS шлюз → Postgres (запис в reminder_log). Часът 10:00 не пада в нощта на смяна на часовото време. Как n8n вика Python логиката (малка локална услуга или същата логика на JavaScript в Code нод) — избор на твоята среда; не сме го пускали ⚠️. Ако n8n е бил изключен в 10:00, графикът по подразбиране пропуска изпълнението; логиката по-горе ще изпрати най-високото дължимо ниво при следващото пускане.

  7. Основание за e-mail и SMS

    Имена, e-mail и телефони са лични данни. Преди да пуснеш автоматични съобщения, запиши за всеки човек на какво основание му пишеш (поле email_ok_at / sms_ok_at) и дай лесен отказ във всяко съобщение (в примера: „обадете се на …“). Какво да уточниш с юриста си:

    • Основание по общия регламент за защита на данните (GDPR), чл. 6, параграф 1: „Обработването е законосъобразно, само ако и доколкото е приложимо поне едно от следните условия: a) субектът на данните е дал съгласие за обработване на личните му данни за една или повече конкретни цели; б) обработването е необходимо за изпълнението на договор, по който субектът на данните е страна, или за предприемане на стъпки по искане на субекта на данните преди сключването на договор; в) обработването е необходимо за спазването на законово задължение, което се прилага спрямо администратора; […] е) обработването е необходимо за целите на легитимните интереси на администратора или на трета страна, освен когато пред такива интереси преимущество имат интересите или основните права и свободи на субекта на данните, които изискват защита на личните данни, по-специално когато субектът на данните е дете.“ (Регламент (ЕС) 2016/679, български текст по ОВ L 119, 4.5.2016 г., с. 1; пропуснатите букви г) и д) — жизненоважни интереси и обществен интерес — не се отнасят до такси в сграда.) Значи: съгласието е само едно от основанията. Дали за напомняне за такса основанието е б) (договор с домоуправителя или фирмата), е) (легитимен интерес да се съберат дължимите вноски) или а) (съгласие) — решава юристът ⚠️.
    • Задължението да се плаща идва от закона. Закон за управление на етажната собственост (ЗУЕС), чл. 6, ал. 1: „Собствениците са длъжни да: […] 10. заплащат разходите за управлението и разходите за поддържането на общите части на сградата;“ и чл. 48, ал. 8: „За поддържане на общите части на етажната собственост собствениците, ползвателите и обитателите на самостоятелни обекти правят ежемесечни вноски в размер, определен в правилника за вътрешния ред или с решение на общото събрание.“ (обн. ДВ бр. 6 от 2009 г., последно изм. ДВ бр. 49 от 17.06.2025 г.; т. 10 — изм. ДВ бр. 82 от 2023 г., в сила от 29.09.2023 г.; текст по lex.bg към 01.10.2026). Напомнянето е за вноска, която законът и решението на общото събрание вече определят — затова то съобщава сума и срок, не налага нищо ново.
    • Съгласие, ако е избраното основание: трябва да е доказуемо (запис кога и как) и да може да се оттегли лесно ⚠️.
    • Закон за електронните съобщения (ЗЕС), чл. 261, ал. 1: „Осъществяването на повиквания, съобщения или електронна поща със или без човешка намеса за целите на директния маркетинг и реклама се позволяват само при предварително получено съгласие на потребителя. Съгласието може да бъде оттеглено по всяко време.“ (ал. 1 — изм. ДВ бр. 105 от 2011 г., в сила от 29.12.2011 г.; текст по lex.bg към 01.10.2026). Изискването за съгласие по тази норма е за директен маркетинг и реклама. Напомнянето за дължима такса, без рекламно съдържание, по нашето разбиране не е такова съобщение — но потвърди с юриста ⚠️ и не добавяй реклама в напомнянето.
    • Мерки спрямо неплатилите (лихва, събрание на собствениците, съд) се определят от собствениците по ЗУЕС и вътрешните правила — не от автоматизацията ⚠️.
    • Минимум данни и срок: държи само нужното; дневникът трий по правилата за съхранение на твоята организация.
    ⚖️
    Не сме юристи
    Това е подготовка за разговор с юрист, не правно становище. Текстовете на нормите по-горе са взети от първоизточник на 01.10.2026 (GDPR — българският текст в Официален вестник на ЕС; ЗУЕС и ЗЕС — lex.bg); сверявай ги с действащата редакция в деня, в който пускаш системата. Кое основание важи за твоята сграда, потвърждава юристът на етажната собственост или на фирмата.
  8. Когато плащането дойде: предложение, не запис

    За да засичаш плащанията лесно, дай на всяка такса основание само с латински букви и цифри — много банки ограничават знаците в полето ⚠️ (питай банката си). Формат: DP-B12-A007-202610 (блок 12, апартамент 7, период октомври 2026; „DP“ е измислен префикс). По-подробното съпоставяне на банково извлечение е в 04-132. Тук — само основата:

    python · match.py
    import re
    from decimal import Decimal
    
    REF = re.compile(r"DP-B(?P<bl>\d+)-A(?P<apt>\d+)-(?P<ym>\d{6})")
    
    def make_ref(block, apt, ym):            # ym: "202610"
        return f"DP-B{block}-A{apt:0>3}-{ym}"
    
    def match_payment(text, amount, fees):
        """fees: {(block, apt, ym): Decimal} дължима сума в EUR. Връща предложение, не запис."""
        m = REF.search(text.upper())
        if not m:
            return {"status": "human", "why": "няма разпознаваемо основание"}
        key = (m["bl"], m["apt"].lstrip("0") or "0", m["ym"])
        if key not in fees:
            return {"status": "human", "why": "няма такава такса"}
        due, paid = fees[key], Decimal(amount)
        if paid == due:   st = "proposed_paid"
        elif paid < due:  st = "proposed_partial"
        else:             st = "human"
        return {"status": st, "key": key, "diff": str(due - paid)}

    Проверихме: 25.00 по такса 25.00 дава proposed_paid; 10.00 — proposed_partial с разлика 15.00; 30.00 (повече) — human; „rent oct“ без основание — human. Платено се отбелязва след като човек потвърди; едва тогава напомнянията спират.

  9. По избор: месечно PDF извлечение

    В края на месеца можеш да правиш за всеки собственик кратко извлечение с библиотеката reportlab (5.0.1 в PyPI): такси, платено, остатък в EUR. Не сме го пускали ⚠️. Връзката към базата се взима от настройка на средата, не се пише с парола в кода, а извлечението се праща само до самия собственик.

  10. Езиковият модел: най-много за идеи

    Съобщенията, които излизат, са от шаблона. Ако искаш да пробваш формулировки, можеш да ползваш локален модел (например mistral:7b в Ollama — съществува, около 4,4 GB) само за чернови, които човек чете и слага в шаблона. Той не вижда сметки, не пише суми и не изпраща. Не сме го пускали за тази задача ⚠️.

04Проверка

Тест

1. Какво прави системата на D+30?

2. Системата е била спряна 20 дни след срока. Какво изпраща при пускане?

3. Кой пише текста на съобщението?

4. Кога НЕ се праща автоматично напомняне?

05Какво следва

06Източници

  1. n8n · Обучение 7: Schedules и Cron jobs 🔒 локално — график, часова зона, работни дни и празници 2026.
  2. n8n: Schedule Trigger 🔒 локално — документация на нода.
  3. Python: модулът decimal · datetime — точна десетична аритметика и дати.
  4. IBAN: формат, примери и проверка mod 97 — откъдето е примерният IBAN в урока (не е истинска сметка).
  5. schwifty · reportlab · psycopg2-binary 🔒 локално — версии 2026.7.3, 5.0.1 и 2.9.13 към 01.10.2026.
  6. Регламент (ЕС) 2016/679 (GDPR) в EUR-Lex — чл. 6, параграф 1; цитатът е от българския текст в ОВ L 119, 4.5.2016 г. (сверен на 01.10.2026 през хранилището на Службата за публикации на ЕС).
  7. Закон за управление на етажната собственост (lex.bg) — чл. 6, ал. 1, т. 10 и чл. 48, ал. 8, последно изм. ДВ бр. 49 от 17.06.2025 г.
  8. Закон за електронните съобщения (lex.bg) — чл. 261, ал. 1 (директен маркетинг и реклама).
  9. mistral в Ollama 🔒 локално — по избор, само за идеи за формулировки.