109 lines
4.9 KiB
Markdown
109 lines
4.9 KiB
Markdown
|
# Supplier Portal Architecture & Module Design
|
||
|
|
|
||
|
|
This document outlines the proposed module structure, page flows, and visual architecture for the E-Commerce Supplier Portal.
|
||
|
|
|
||
|
|
## 1. System Architecture & Modules
|
||
|
|
|
||
|
|
```mermaid
|
||
|
|
graph TD
|
||
|
|
%% Styling
|
||
|
|
classDef primary fill:#1A2B45,stroke:#1A2B45,color:#fff;
|
||
|
|
classDef accent fill:#E9C46A,stroke:#E9C46A,color:#1A2B45;
|
||
|
|
classDef container fill:#FFFFFF,stroke:#1A2B45,color:#1A2B45;
|
||
|
|
classDef bg fill:#F5F0EA,stroke:#1A2B45,color:#1A2B45;
|
||
|
|
|
||
|
|
%% Modules
|
||
|
|
AuthModule["Authentication Module"]:::primary
|
||
|
|
ProfileModule["Onboarding & Profile Module"]:::primary
|
||
|
|
ProductModule["Product Management"]:::primary
|
||
|
|
DashboardModule["Analytics & Dashboard"]:::primary
|
||
|
|
FulfillmentModule["Order & Fulfillment Tracking"]:::primary
|
||
|
|
WalletModule["Payout & Wallet"]:::primary
|
||
|
|
NotificationModule["Notification System"]:::primary
|
||
|
|
|
||
|
|
%% Components
|
||
|
|
Signup["Signup Page<br/>(Email, Phone, GSTIN Init)"]:::container
|
||
|
|
Login["Login Page<br/>(OTP / Password)"]:::container
|
||
|
|
ProfileComplete["Profile Completion Page<br/>(Store Info, Pickup Address, GSTIN Verify)"]:::container
|
||
|
|
ProdUpload["Single Upload / Modify Page"]:::container
|
||
|
|
BulkUpload["Bulk Excel/CSV Upload Page"]:::container
|
||
|
|
AnalyticsDash["Sales & Earnings Analytics<br/>(Yearly, Weekly, Daily, Custom Date Filters)"]:::container
|
||
|
|
StockReports["Stock & Inventory Tracking"]:::container
|
||
|
|
ReturnsDashboard["Customer Returns Center<br/>(Requests, Tracking & Quality Checks)"]:::container
|
||
|
|
PayoutCenter["Payout / Wallet Dashboard<br/>(Outstanding Balance, Withdrawal Request)"]:::container
|
||
|
|
ItemTracking["Item Tracking Dashboard<br/>(Individual Item Status, SKUs, Serials)"]:::container
|
||
|
|
TransitTracking["Transit Tracking Dashboard<br/>(Courier Status, Carrier Integration)"]:::container
|
||
|
|
|
||
|
|
%% Relations
|
||
|
|
AuthModule --> Signup
|
||
|
|
AuthModule --> Login
|
||
|
|
Signup --> ProfileComplete
|
||
|
|
ProfileComplete --> ProfileModule
|
||
|
|
|
||
|
|
ProductModule --> ProdUpload
|
||
|
|
ProductModule --> BulkUpload
|
||
|
|
|
||
|
|
DashboardModule --> AnalyticsDash
|
||
|
|
DashboardModule --> StockReports
|
||
|
|
|
||
|
|
FulfillmentModule --> ItemTracking
|
||
|
|
FulfillmentModule --> TransitTracking
|
||
|
|
FulfillmentModule --> ReturnsDashboard
|
||
|
|
|
||
|
|
WalletModule --> PayoutCenter
|
||
|
|
```
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
## 2. Detailed Page & Module Breakdown
|
||
|
|
|
||
|
|
### A. Authentication & Onboarding Module
|
||
|
|
1. **Signup Page**
|
||
|
|
- Business Email, Password, and Mobile Number validation.
|
||
|
|
- Initial GSTIN input (for verification).
|
||
|
|
2. **Login Page**
|
||
|
|
- Credentials or OTP-based secure login.
|
||
|
|
3. **Account Profile Completion Page (Onboarding Step 2)**
|
||
|
|
- **Store Details**: Upload Store Logo/Profile Image, Store Display Name.
|
||
|
|
- **Pickup & Shipping**: Pickup Address, contact person details.
|
||
|
|
- **Regulatory Info**: Verified GSTIN, Bank Account details (for payouts).
|
||
|
|
|
||
|
|
### B. Product & Inventory Management Module
|
||
|
|
1. **Single Product Upload & Modification**
|
||
|
|
- Form-based creation (Images, Title, Description, SKU, Category, Price, Stock count).
|
||
|
|
- Real-time preview of the product card matching our theme.
|
||
|
|
2. **Bulk Product Upload & Modify**
|
||
|
|
- Excel/CSV upload template download.
|
||
|
|
- Status log showing validation warnings (e.g., missing images, pricing errors).
|
||
|
|
|
||
|
|
### C. Analytical Dashboard Module
|
||
|
|
Provides comprehensive reporting with dynamic period filters (**Yearly, Weekly, Daily, and Custom Date Range**):
|
||
|
|
1. **Sales & Earnings Reports**
|
||
|
|
- Interactive charts showing Total Sales (Gross volume) vs. Total Earned (Net margin after commissions).
|
||
|
|
2. **Stock & Inventory Status**
|
||
|
|
- Low-stock alerts, active listings count, and inactive listings.
|
||
|
|
|
||
|
|
### D. Order & Fulfillment Tracking Module
|
||
|
|
1. **Item Tracking**
|
||
|
|
- Track individual items per order (SKU details, quantity, individual packaging status).
|
||
|
|
- Flag items: *Ready to Ship*, *Shipped*, *Delivered*, *Cancelled*.
|
||
|
|
2. **Transit Tracking**
|
||
|
|
- Real-time logistic carrier updates (e.g., DHL, FedEx, Local Post tracking number integration).
|
||
|
|
- Expected Delivery Date and transit milestones display.
|
||
|
|
3. **Return Tracking & Return Requests**
|
||
|
|
- **Items Requested for Return**: Lists customer return requests, reason for return, and custom images uploaded by the customer (e.g., defective product, wrong size). Action to *Approve* or *Reject* return.
|
||
|
|
- **In-Transit Return Tracking**: Real-time logistic progress of returning items from the customer back to the supplier hub.
|
||
|
|
|
||
|
|
### E. Wallet & Financials (Payout) Module
|
||
|
|
1. **Current Outstanding Balance**
|
||
|
|
- Live ready-to-withdraw funds display.
|
||
|
|
2. **Withdrawal Interface**
|
||
|
|
- Payout history list with status tracking (Pending, Approved, Transferred).
|
||
|
|
- "Withdraw Funds" action trigger.
|
||
|
|
|
||
|
|
### F. Notifications & Account Settings
|
||
|
|
1. **Header Notification Drawer**
|
||
|
|
- Real-time notices for new orders, low inventory, return requests, and completed payouts.
|
||
|
|
2. **Profile / Account Settings Page**
|
||
|
|
- Modify existing Store Profile Image, Pickup Location details, and GSTIN certificates.
|