Mahmoud Mohsen
Mahmoud Mohsen Business systems

Selected work 01

Retail Intelligence Layer

Designed an adapter-based monitoring layer for legacy POS systems, giving business owners real-time operational visibility without changing their existing workflows.

Live
  • Python
  • SQL Server
  • FastAPI
  • PostgreSQL
  • Supabase
  • n8n
Sector
Retail
Size
Small to medium retail business (single store with expansion-ready architecture)
My role
Designed and Built
Period
2026

Context

The business already relied on a legacy desktop POS system for daily operations. Sales, inventory, and customer activity were stored locally, making it difficult for owners to monitor business performance remotely. Replacing the existing POS system was not commercially practical because it would disrupt daily operations and require staff retraining.

Business problem

Retail businesses rely on legacy POS systems that lock operational data inside desktop software. Owners lose visibility as soon as they leave the store, making inventory, sales, and staff activity difficult to monitor remotely.

Constraints

No public API available. Existing POS system could not be modified. Business operations could not be interrupted. Staff workflows had to remain unchanged. Integration had to be read-only to eliminate operational risk. The solution needed to work over ordinary internet connections without exposing the client's local network.

The decision

Instead of replacing the client's POS system, I designed a read-only adapter architecture that translates each POS schema into a common operational model. This preserved existing workflows while enabling centralized monitoring and reporting.

Solution

Built an adapter-based monitoring layer that extracts operational data from existing POS systems using read-only integrations, synchronizes it securely to a centralized platform, and delivers dashboards, alerts, and automated reports without modifying the original software.

Highlights

  • Adapter-based architecture
  • Read-only SQL integration
  • Operational dashboards
  • Inventory alerts
  • WhatsApp reporting
  • Secure synchronization

Decision spread

What exists

Adapter-based POS integration · Read-only SQL synchronization · Secure cloud synchronization · Operational dashboard · Inventory monitoring · Sales reporting · WhatsApp notifications · Centralized business monitoring platform

Deliberately not built

POS replacement · Direct database modifications · Write access to customer systems · Vendor-specific integrations · Workflow changes for store employees. These were intentionally excluded to minimize operational risk and maximize compatibility with existing business infrastructure.

The tradeoff accepted

A read-only architecture cannot directly correct or modify operational data inside the POS system. The platform focuses on visibility, monitoring, and decision support rather than operational control. This tradeoff significantly reduces deployment risk while improving long-term maintainability.

Evidence

A complete operational flow from a legacy POS database through the adapter layer, secure synchronization, centralized dashboard, and automated business notifications without modifying the original POS software.

Retail Intelligence Layer — monitoring architecture Operational data flows one way from a legacy SQL Server POS database on the client site, through a read-only adapter layer, across a boundary to the owner's VPS, where an incremental synchronization service feeds a secure cloud API. The API serves both a central operational dashboard and automated WhatsApp reporting. No path writes back to the client system. Client systems Centralized platform read-only, no write access 01 Legacy SQL Server POS database 02 Read-only adapter layer 03 Incremental synchronization 04 Secure cloud API 05 Central operational dashboard 06 Automated WhatsApp reporting
Legacy POS monitoring architecture showing how operational data is extracted, synchronized, and transformed into business intelligence without replacing the existing retail system.
  1. 01 Legacy SQL Server POS database
  2. 02 Read-only adapter layer
  3. 03 Incremental synchronization service
  4. 04 Secure cloud API
  5. 05 Central operational dashboard
  6. 06 Automated WhatsApp reporting

Technical

Building a reusable adapter architecture capable of supporting multiple legacy POS systems without requiring API access or changes to the customer's existing software.