Contact person: Business Client

Phone:Show

Email:Show

Location: Jeddah, Saudi Arabia

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"Wholesale Store Application – Full Development Requirements
────────────────

1. Project Overview

Project Type: B2B wholesale e-commerce mobile app with an admin web dashboard.
Objective: To sell wholesale products to verified business clients (wholesalers or semi-retailers).

Platforms Required:

iOS (iPhone) mobile app

Android mobile app

Web-based Admin Dashboard (backend control panel)

Key Concept:

Prices are hidden for guest users.

Prices are visible only after admin approval of the user’s business account.

Business Flow:

Visitor can browse categories and products without prices.

To view prices or purchase, the visitor must register as a business.

Registration requires uploading commercial registration, VAT number, national ID, phone, and referral source.

Admin reviews and either approves or rejects the registration.

Once approved, the user can see prices, add products to cart, and complete orders.

Every order status change triggers a notification (in-app + optional WhatsApp message).

Source Code Ownership:

Full ownership of all source code (mobile apps, backend, admin panel, database, UI/UX design files, API documentation).

The developer/company cannot resell or reuse the same code for another client without written permission.

────────────────

2. Mobile Application (iOS + Android)

────────────────

2.1 Onboarding / Welcome Screens

Intro slider banners (editable from admin panel).

Language selection (Arabic default; English optional).

Full Arabic support (RTL layout).

2.2 Home Screen

Dynamic slider banners (offers, featured products).

Main categories.

Featured and new products.

Search bar.

2.3 Product Details Page

Each product must include:

Multiple images with zoom view.

Product name and description.

Availability status (In stock / Out of stock / Pre-order).

Minimum order quantity (MOQ).

Price display logic:

Hidden for guests or unverified users – show “Register to view wholesale prices.”

Visible for verified users only (wholesale and retail prices if applicable).

Add to Cart button:

Active only for verified users.

Unverified users get a message “Please verify your business account to place orders.”

2.4 Registration (Sign Up / KYC Verification)

Registration form fields:

Business/Company name

Commercial Registration Number

VAT Number

Owner/Manager Name

National ID / Residency number (with ID photo upload)

Mobile number (OTP verification required)

Email address

City/Region

“How did you hear about us?” (Snapchat, TikTok, Sales Rep, Friend, Other)

File uploads:

Commercial Registration copy

VAT Certificate (optional)

ID document

After submission:

Account status = “Under Review.”

User cannot view prices or place orders until approved.

SMS OTP verification required for mobile number.

2.5 Login

Login via mobile number + password.

Option for OTP login.

“Forgot Password” reset.

2.6 Shopping Cart

For verified users only.

Edit quantities, view subtotal, VAT (15%), and estimated shipping.

Proceed to checkout button.

2.7 Checkout & Payment

Payment methods required:

Online payment (Mada / Visa / Apple Pay).

Bank transfer (show bank account details + upload payment receipt).

Installment payment (optional future feature; design ready).

Cash on delivery (optional – controlled from admin).

Shipping details:

Choose saved address or add new one (Name, City, District, Street, Phone, Notes).

After confirmation:

Order summary and invoice stored under “My Orders.”

2.8 Orders (My Orders Page)

Display all previous/current orders.

Show order number, date, total, and status.

Status options:

Pending Review

Processing

Shipped (with tracking number)

Completed

Cancelled

Detailed view includes full breakdown (items, tax, payment, address).

2.9 Notifications

Push notifications for:

Order received

Status change

Order shipped

Order completed

Notifications center inside the app.

Firebase (Android) + APNs (iOS).

WhatsApp notifications (optional): must support integration with WhatsApp Business API or a third-party service.

2.10 Profile / Account Page

Show business details and verification status.

Update documents when expired (e.g., commercial registration).

Manage shipping addresses.

Logout.

UI/UX Notes:

Clean, elegant, professional B2B layout.

Arabic RTL support.

Organized product arrangement and modern design.

────────────────

3. Admin Panel (Web Dashboard)

────────────────

3.1 Admin Login

Web-based control panel with multi-user access.

Role-based permissions system.

Example roles:

Super Admin (full control)

Product Manager (manage products/prices/stock)

Order Manager (handle orders only)

Customer Support (view customers/orders only)

Accountant (verify payments and transfers)

Price Editor (edit prices only)

3.2 Dashboard Overview

Total new orders (daily).

New pending customers.

Sales summary (daily / weekly / monthly).

Low stock alerts.

3.3 Customer Management

List of all users.

Account status: Rejected / Pending / Approved.

Approve or Reject button.

When approved: send in-app + WhatsApp notification.

Edit customer info.

Internal notes (not visible to user).

Important:
Only “Approved” users can view prices in the app.

3.4 Product Management

Add / edit / delete products.

Upload multiple images.

Fields:

Arabic & English name

Arabic & English description

SKU / Barcode

Category (main + sub)

Availability (In stock / Out of stock / On demand)

MOQ (minimum order quantity)

Wholesale price

Retail price (optional)

Purchase cost (internal only)

Stock quantity

Product ranking / featured toggle

3.5 Categories

Create / edit / delete categories.

Sort order for display priority.

3.6 Banners / Sliders

Manage home banners.

Fields: Image, Title, Description, Link, Status (on/off), Sort order.

3.7 Order Management

View orders list with filter by status.

View full order details.

Change order status (Pending → Processing → Shipped → Completed → Cancelled).

Add tracking number & shipping company.

Send automatic notifications.

Print / Download invoice PDF.

3.8 Payments

Display all payment methods used.

For bank transfers:

Show uploaded receipt.

Mark as “Confirmed” or “Rejected.”

Internal accountant note.

Mark order as “Payment Received.”

3.9 Notifications / Broadcast Messages

Send manual notifications (Push) to:

All verified users.

Selected customers.

Customers by city or segment.

Message fields: title, content, optional image.

Prepare structure to support WhatsApp messages (integration later).

3.10 Settings

Bank account details.

VAT percentage (e.g., 15%).

Minimum order amount.

Terms & Conditions.

Return Policy.

Toggle Cash on Delivery + specify allowed cities.

3.11 Admin Users & Permissions

Add new admin users.

Assign custom permissions (per page or section).

Activity Log (Audit Trail):

Who edited prices?

Who approved customers?

Who changed order status?

Who deleted a product?

────────────────

4. Technical Requirements

────────────────

4.1 Technology Stack

Mobile: Flutter or React Native (cross-platform).

Backend: Laravel / Node.js / Django (Web-based, RESTful).

Database: MySQL or PostgreSQL.

API: RESTful or GraphQL with proper documentation (Postman / Swagger).

4.2 Security

Passwords encrypted (BCrypt or stronger).

Secure file uploads (commercial docs, IDs) – no public access without authentication.

File type validation (block .exe, .php, etc.).

Input validation for all forms.

4.3 Performance

Fast product browsing with caching.

Supports thousands of SKUs.

Search by product name or SKU.

Pagination or lazy loading.

4.4 Language & Design

Full RTL (Arabic) support.

Clean, responsive, and professional design.

Mobile-responsive admin dashboard.

4.5 Invoicing & Tax

Every order stored with breakdown:

Items, prices, discounts (if any), VAT (15%), total.

Customer can view invoice from app.

Admin can print/download invoices.

────────────────

5. ERP / Accounting Integration

────────────────

The system must be API-ready for integration with any external accounting system.

Required endpoints/webhooks:

Send new orders automatically to accounting software.

Fetch products, prices, and stock levels from accounting to app.

Update stock levels automatically when changed in ERP.

Even if not implemented immediately, the backend must be designed to support these connections easily later.

────────────────

6. Notifications

────────────────

Mandatory notifications:

Order created

Order status changed

Order shipped (with tracking number)

Order completed

Channels:

Push notifications (Firebase / APNs).

Stored in in-app “Notifications” section.

WhatsApp API integration ready (optional).

────────────────

7. Delivery & Handover Requirements

────────────────

Upon final delivery, the developer must provide:

Full source code (mobile + backend + admin).

Full database (schema + SQL dump).

Full UI/UX design files (Figma or XD).

Full documentation:

App publishing on App Store & Play Store

Push notification setup

Payment gateway configuration

API & webhook documentation

Super Admin account credentials.

Functional role/permission system.

Full RTL Arabic interface without layout issues.

VAT shown clearly on all invoices.

Prices hidden from unverified users.

Activity Log (Audit Trail) enabled to track all admin actions.

────────────────" (client-provided description)