King Store — POS لمحلات الملابس

نظام نقاط بيع متخصّص لمحلات الملابس مع تكامل طابعة Barcode (SDK). يدير المبيعات، المخزون، العملاء، الديون، الصيانة، والصلاحيات. واجهة عربية كاملة.

PythonFlaskSQLAlchemyFlask-LoginBarcodePOSSDK

abstract

نظام POS مصمّم خصيصاً لاحتياجات محلات الملابس والأحذية في السوق المصري/الخليجي.

🎯 الفرق عن أنظمة POS العامة: تكامل طابعة الـ Barcode، إدارة الديون، ومراقبة الصيانة.

الميزات الموسّعة: • شاشات: المبيعات، المخزون، العملاء، الديون، رأس المال، الصيانة، الإعدادات • تكامل مع printer.sdk.dll لطباعة الملصقات (Barcode + سعر + اسم منتج) • Subprocess لتشغيل طابعة الـ ZPL/EPL • Flask-Login للصلاحيات (Admin / Cashier / Developer) • SQLAlchemy ORM مع indexes للأداء على آلاف المنتجات • تقارير المبيعات اليومية والشهرية • إدارة الديون (تحصيلات، استحقاقات، جدولة) • Auto-launch المتصفح، يعمل أوفلاين

architecture

  ┌──────────────┐      ┌────────────┐      ┌─────────────┐
  │  client      │─────▶│   nginx    │─────▶│  next.js    │
  │  (browser)   │      │  (proxy)   │      │  (ssr)      │
  └──────────────┘      └─────┬──────┘      └──────┬──────┘
                              │                    │
                              ▼                    ▼
                        ┌───────────┐        ┌──────────┐
                        │ fastapi   │◀──────▶│ postgres │
                        │ (asyncio) │        │ (asyncpg)│
                        └───────────┘        └──────────┘

Stateless API behind a reverse proxy. SSR delivers HTML in under a second on warm cache. Connection pool keeps Postgres hot. JWT in HttpOnly cookie for the admin panel.

notes

SSR-first to keep TTFB < 1s on cold visits.
Type-checked end-to-end via Pydantic schemas mirrored to TS.
Migrations versioned via Alembic; zero-downtime restarts.