⚙️ Fidelity Full-Stack Core (Server & Web Portal)

The central core system powering the Fidelity Ecosystem—a shared loyalty points network designed for small business networks. This repository operates as a full-stack solution, hosting both the core REST API backend and the web portal for overall business management.

---

🧩 System Architecture & Ecosystem

The multi-tier system coordinates between business (B2B) and consumer (B2C) applications:

Component	Repository	Tech Stack	Audience & Function
Full-Stack Core	This Repo	Node.js, Express, Web UI, MySQL	Core REST API server, database management, & administrative web portal
B2C Mobile App	Fidelity-App	Flutter, Dart	Consumer mobile app for end-users to earn, track, and redeem points
B2B Merchant App	Fidelity-Corp	Angular / Android	Merchant app for partner businesses to manage point rules & validate transactions

---

📸 Web Portal Preview & Screenshots

🔑 Authentication & User Management

Manager Authentication	User Directory
Manager login screen featuring phone-based authentication.	Searchable user management table supporting inline editing & deletion.

User Registration Form	Store & Merchant Directory
Admin panel to manually register new program members.	Partner store directory displaying merchant addresses & types.

---

📦 Product & Event Management

Product Catalog	Add New Product
Product inventory view linked across participating stores.	Product registration form with image upload functionality.

Event & Notification Dispatch	Batch Database Import
Event scheduling for target client groups via SMS & Push Notifications.	Excel database upload tool for bulk user and product migration.

---

✨ Key Features

• 🌐 Dual Full-Stack Architecture: Integrated Web UI dashboard combined with RESTful API endpoints.
• 🔐 Multi-Role Authentication: Dedicated auth pipelines for consumers, merchant managers, and super-admins.
• 💳 Shared Loyalty Rules Engine: Logic to allocate, validate, and transfer points across participating merchants.
• 📊 Data Import & Push Notifications: Support for bulk Excel data ingestion and SMS/push event broadcasting.

---

🚀 Quick Start

Prerequisites

• Node.js (v18+ recommended)
• MySQL server

Setup & Run

# Clone the repository
git clone [https://github.com/Sadoklaoo/Fidelity-Web-Server.git](https://github.com/Sadoklaoo/Fidelity-Web-Server.git)
cd Fidelity-Web-Server

# Install dependencies
npm install

# Start server & web interface
npm start