Core Features & Functionality

1. Vendor Subscription Management
   Vendors are required to pay a yearly subscription fee for using the dropshipping app on Sella. This subscription is managed through Sella's OAuth system. Once a vendor’s subscription expires, their access to the system is revoked until they renew it. During this period, their Sella API tokens may no longer be valid, and they might need to re-enter their credentials to reconnect their store with the dropshipping platform.

2. Pricing Notifications (PLANNED)
   Vendors receive a bulk price, typically 15% lower than the retail price listed on our Magento website. If any significant price changes occur (e.g., due to changes in raw material costs), vendors will be notified 24 hours in advance if they have added the product to their list. These price updates are sent via the Filament notification system.

3. Product Availability and Inventory Management
   The product inventory on the dropshipping platform is separate from the stock on the Magento website but is updated regularly. The admin sets the initial stock, and vendors can manage their inventory once an order is processed. Each time a vendor sets an order to Processing, the product inventory is updated both on the dropshipping website and on Sella.

4. Wallet System
   Vendors maintain a wallet balance that is deducted whenever an order is processed. If a vendor’s wallet does not have enough funds, they cannot proceed with processing the order until they top up their balance. The platform supports payment processing through ClickPay, and the vendor is notified when their wallet is successfully funded.

5. Order Lifecycle

   • Manual and Automatic Order Creation: Orders are created when a customer purchases a product from the vendor’s Sella store. These orders are then processed on the dropshipping platform.
   • Order Status Management: The admin sets the order to Shipped once the product is dispatched from the warehouse. Once the product reaches the customer, the admin updates the order status to Delivered.
   • Return Management: Vendors can create return requests for their customers. The admin evaluates the return and can approve or refuse it, triggering a refund to the vendor’s wallet and restoring the product stock.

6. Notifications
   The platform uses Filament’s Notification Class to send out notifications in various scenarios:

   • When a vendor's wallet is funded.
   • When product details (name, description, price) are updated.
   • When orders are created, canceled, or processed.
   • When returns are created, approved, or canceled.
   • When admin actions (e.g., product imports, transactions) occur.

   Notifications are sent to the relevant users (vendors or admins) based on these actions, ensuring that users are informed of any necessary changes.

7. Admin Dashboard
   The admin has a separate dashboard that includes the following pages:

   • Dashboard: Overview of system activity and performance.
   • Orders: Management of all orders across the platform.
   • Products: Management of product listings, stock, and visibility settings.
   • Returns: Review and manage vendor return requests.
   • Transactions and Wallets: Overview of financial transactions and wallet statuses.
   • User Management: Create, update, or remove vendor and customer profiles.