ما الذي نديره

المكتب الخلفي كلّه، كأربع مهامّ لا تتوقّف أبدًا — لا أداةٌ عليك أن تقودها بنفسك.

كيف يُتحكَّم فيه

الفارق ليس لوحة تحكّم برّاقة. بل المراقبة — ولا شيء يتصرّف في دفاترك من تلقاء نفسه.

مقيسٌ، لا مُدَّعى

كيف تُصان الدفاتر — لا أرقام نموٍّ مُختلَقة.

البناء — ما يعمل، وما يُقفل، وما تُرفَع إشارته

الأتمتة ليست العرض؛ بل طبقةٌ مُدارةٌ أخرى تحت المراقبة نفسها. وهذه صورته الحقيقية.
يبقى الكود بالإنجليزية — اللغة العالمية للهندسة.

# one workflow definition — the repeated steps, declared once and watched every run
name:        "invoice-to-ledger"
trigger:     "new_invoice"
steps:
  - read:    "invoice.pdf"
  - extract: ["date", "vendor", "amount", "tax"]
  - post:    "ledger.entries"
  - notify:  "book-keeper"
on_error:    "flag_human"        # never guess, never push through — raise a hand instead
schedule:   "on_arrival"

# run log — every pass is seen, not assumed
run_id: "wf_2026_11_04_0137"  status: "ok"  exceptions: 0

"""MatchTop · the close — sales and costs out, a sheet your accountant can open.
No one sits to compile it; it is a read of what is already recorded, nothing invented."""

import csv


def close(period, sales) -> str:
    """Month or quarter: one clean export, in your currency, nothing invented."""
    path = f"close-{period}.csv"
    with open(path, "w", newline="") as f:
        w = csv.writer(f)
        w.writerow(["date", "order", "item", "qty", "net", "tax", "gross"])
        for s in sales:
            w.writerow([s.date, s.order, s.item, s.qty, s.net, s.tax, s.gross])
    return path                            # handed to the accountant, not to a black box

"""MatchTop · reconciliation — two sources compared, mismatches flagged.
It never silently fixes money. A difference waits for a person."""

from dataclasses import dataclass


@dataclass
class Mismatch:
    key: str
    left: float
    right: float


def reconcile(bank, ledger) -> list:
    """Compare two sources by key; return what does not agree, for a human to decide."""
    out = []
    for key, left in bank.items():
        right = ledger.get(key)
        if right is None or round(left, 2) != round(right, 2):
            out.append(Mismatch(key, left, right))   # flagged, not fixed
    return out                                        # a human reads this list and decides

ما لا يمكن نسخه

لماذا تتفوّق أتمتةٌ مُدارة على جدولٍ عليك أن تقوده بنفسك.

سكربتٌ يعمل دون مراقبة لا يمكن أن يُؤتمَن على دفاترك — يُصلح بصمت أو يفشل بصمت، وتعلم لاحقًا. وأداةٌ لا يمكن أن تسلّمك صيغتك أنت؛ بل تسلّمك صيغتها. لهذا لا توجد قائمة أسعارٍ هنا: ننظر إلى ما يجب أن يعمل ويُقفل، ونقيسه، ونعرض ما قِسناه.

محفوظٌ بالسرّية

قبل أن يُكتَب سطرٌ واحد، كيف تُصان دفاترك وبياناتك. هذا الجزء غير قابل للتفاوض.