woocommerce_inventory/README.md

1.6 KiB

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.

# 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.

# 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.