ما الذي نديره

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

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

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

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

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

البناء — ما يراقب، وما يقترح، وما يُقفل

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

# one store under watch — what raises a hand, and what it does on its own (nothing)
POST https://api.matchtopalgorithm.ai/v1/operate/stores
Authorization: MT-••••-••••-••••      — one key, one store
Content-Type: application/json

{
  "store":   "shop.yourcompany.com",
  "watch":   ["uptime", "checkout", "stock", "price_drift", "orders", "messages"],
  "on_breach": { "alert": ["telegram", "email"], "act": "propose_only" },
  "window":  "24/5",
  "clock":   "Europe/Zurich"        — the sheet arrives in your hour
}

202 Accepted
{
  "store_id":  "s_7f3a91c4",
  "watch":     "live",
  "autopilot": "off — a human signs every action"
}

"""MatchTop · a store agent — it proposes, it never ships on its own.
Standard library only. The agent raises a hand; a person decides."""

import smtplib, json
from dataclasses import dataclass


@dataclass
class Proposal:
    kind: str          # "restock" | "refund" | "reprice"
    detail: dict
    signed: bool = False   # stays False until a human says yes


def watch_stock(store, floor=3):
    """Low stock is not an order. It is a proposal that waits for a signature."""
    for item in store.low_stock(below=floor):
        yield Proposal("restock", {"sku": item.sku, "qty": item.reorder_qty})


def apply(p: Proposal):
    if not p.signed:
        raise PermissionError("no action ships without a human signature")
    store.execute(p)                      # only reachable after sign-off

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

import csv, sys


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

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

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

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

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

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