==============================
MANGALORE STORES
Project Setup Guide (Windows)
==============================

1. Required Software
--------------------
- PHP 8.3 or higher
- Composer 2.x
- Node.js 22 LTS or higher
- npm
- MySQL 8.0 or higher
- Git
- WAMP/XAMPP with PHP 8.3+ enabled


2. Required PHP Extensions
--------------------------
Enable these extensions in php.ini:

pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, fileinfo, curl, zip, gd, intl, bcmath, dom, xmlwriter


3. Project Setup
----------------
git clone <repo-url>
cd mangalore-store-api
composer install
npm install
npm run build
copy .env.example .env
php artisan key:generate
php artisan storage:link
php artisan migrate --seed


4. Database Setup
-----------------
- Create MySQL database: mangalore_store_api
- Update .env DB_DATABASE, DB_USERNAME, DB_PASSWORD.
- Run: php artisan migrate --seed


5. Frontend Build
-----------------
npm install
npm run build


6. Run Project
--------------
php artisan serve

Open:
http://127.0.0.1:8000


7. Common Commands
------------------
php artisan optimize:clear
php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear


8. Common Errors
----------------
- Storage link issue: Run php artisan storage:link.
- Permission issue: Make sure project folder is not read-only.
- Missing .env: Run copy .env.example .env and php artisan key:generate.
- Composer package missing: Run composer install.
- npm package missing: Run npm install.
- Database connection issue: Check MySQL is running and .env DB details are correct.
- Images not loading: Check public/storage link and APP_URL.
- Cache issue: Run php artisan optimize:clear.


9. Final Checklist
------------------
✔ Composer Installed
✔ Node Installed
✔ npm Installed
✔ Database Connected
✔ Storage Link Created
✔ Images Working
✔ Admin Login Working
✔ Customer Login Working
✔ APIs Working