56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# WooCommerce Inventory Manager
|
|
|
|
A modern web application to manage your WooCommerce products, inventory, and plugin metadata.
|
|
|
|
## Prerequisites
|
|
- Python 3.8+
|
|
- Node.js 16+
|
|
- WooCommerce Store with REST API enabled (Consumer Key & Secret required)
|
|
|
|
## Setup & Run
|
|
|
|
### 1. Start the Backend
|
|
The backend runs on Python/FastAPI.
|
|
|
|
```bash
|
|
# Open a new terminal
|
|
pip install -r backend/requirements.txt
|
|
cd backend
|
|
python main.py
|
|
```
|
|
Server will start at `http://0.0.0.0:8000`.
|
|
|
|
### 2. Start the Frontend (Flutter)
|
|
The frontend is a unified Flutter app for Web, Android, and Windows.
|
|
|
|
```bash
|
|
# Open a new terminal
|
|
cd mobile_app
|
|
flutter pub get
|
|
flutter run -d chrome # For Web
|
|
# OR
|
|
flutter run -d windows # For PC
|
|
# OR
|
|
flutter run -d android # For Mobile
|
|
```
|
|
|
|
> **Note**: Logic for connecting to the backend varies by platform:
|
|
> * **Web/Windows**: Use `localhost:8000`
|
|
> * **Android Emulator**: Use `10.0.2.2:8000`
|
|
> * **Physical Device**: Use your computer's local IP (e.g., `192.168.1.X:8000`)
|
|
|
|
## 📂 Legacy Frontend
|
|
The old React frontend has been moved to `legacy_frontend/` and is deprecated.
|
|
|
|
## Features
|
|
- **Dashboard**: View all products, search, and manage stock.
|
|
- **Product Editor**:
|
|
- Edit standard fields (Price, SKU, Stock).
|
|
- **Images**: Drag & Drop image upload.
|
|
- **Meta Data**: View and edit hidden metadata used by plugins (e.g., Yoast, Bundles).
|
|
- **Authentication**: Secure login using your WooCommerce Consumer Key & Secret.
|
|
|
|
## Troubleshooting
|
|
- If you see "CORS" errors, ensure the backend is running.
|
|
- If images fail to upload, check your WordPress media permissions.
|