Enjaz
systems / سوبر-ماركت-برو-نظام-pos-عربي
serviceمُنشَر

سوبر ماركت برو — نظام POS عربي

نظام نقاط بيع متكامل للسوبر ماركت العربي، مبني بـ Flask + Flask-Login. باركود، إدارة منتجات، عملاء بنظام نقاط الولاء، مرتجعات، تقارير، وصلاحيات.

FlaskSQLAlchemyPythonPOSLoyaltyBarcodeBootstrap
سوبر ماركت برو — نظام POS عربي

abstract

سوبر ماركت برو — نظام POS عملي للمحلات الصغيرة والمتوسطة، خفيف وسريع.

✨ الميزات: • نقطة بيع (POS) سريعة بالباركود • إدارة منتجات مع أصناف وفئات • نظام الولاء: نقاط، عملاء، خصومات • تتبّع المخزون مع تنبيه عند انخفاض الكمية • المرتجعات والاسترجاع الجزئي • تقارير المبيعات اليومية والشهرية • صلاحيات متعددة المستخدمين • قاعدة بيانات SQLite — لا تحتاج خادم

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.