novafarma/docs/BACKEND_SETUP.md

🚀 Visual Asset Manager - Backend Setup

Status: ✅ FULLY FUNCTIONAL
Delete: Now actually deletes files from disk
Re-roll: API ready (image generation TBD)

---

🎯 QUICK START

1. Install Dependencies

pip3 install Flask flask-cors

2. Start Backend Server

cd /Users/davidkotnik/repos/novafarma
python3 tools/asset_backend.py

Server starts on: http://localhost:5000

3. Start Frontend Server

# In another terminal:
cd /Users/davidkotnik/repos/novafarma
python3 -m http.server 8080

Frontend URL: http://localhost:8080/tools/visual_asset_manager.html

---

✅ WHAT NOW WORKS:

🗑️ DELETE (Fully Functional!)

1. Klikni "Delete" na asset cardu
2. Confirm dialog
3. Backend dejansko izbriše datoteko iz diska
4. Auto-regenerira manifest
5. Galerija se osvež i

Flow:

Frontend → DELETE /api/asset/{id}
    ↓
Backend finds file
    ↓
os.remove() - file deleted
    ↓
Regenerate manifest
    ↓
Return success → Frontend reloads

🔄 RE-ROLL (API Ready)

1. Klikni "Re-roll"
2. Backend API endpoint ready
3. TODO: Image generation not yet implemented
4. For now: Shows placeholder message

---

🔌 API ENDPOINTS:

Health Check

GET http://localhost:5000/api/health

Get All Assets

GET http://localhost:5000/api/assets

Delete Asset

DELETE http://localhost:5000/api/asset/{asset_id}

Response:
{
  "success": true,
  "message": "Asset deleted successfully",
  "deleted_file": "assets/path/to/file.png"
}

Re-roll Asset

POST http://localhost:5000/api/asset/{asset_id}/reroll

Response:
{
  "success": true,
  "message": "Re-roll requested",
  "note": "Image generation not yet implemented"
}

Regenerate Manifest

POST http://localhost:5000/api/manifest/regenerate

Response:
{
  "success": true,
  "message": "Manifest regenerated",
  "total_assets": 1166
}

---

🎬 WORKFLOW EXAMPLE:

Delete Unwanted Asset:

1. Odpri galerijo: http://localhost:8080/tools/visual_asset_manager.html
2. Find asset: Use search or filter
3. Click Delete: Red button
4. Confirm: Dialog asks for confirmation
5. Wait: Backend deletes file (2s)
6. Auto-refresh: Gallery shows updated list

Result: File physically deleted from disk!

---

🛠️ DEVELOPMENT:

Backend Code

tools/asset_backend.py - Flask API server

Frontend Code

tools/visual_asset_manager.html - Updated with API calls

Dependencies

to ols/requirements.txt:

• Flask==3.0.0
• flask-cors==4.0.0

---

🔒 SECURITY NOTES:

⚠️ Development Only

• CORS is open (allows all origins)
• No authentication
• Debug mode enabled
• NOT for production use

For production, add:

• Authentication
• CORS restrictions
• Rate limiting
• Input validation
• HTTPS

---

🐛 TROUBLESHOOTING:

Backend not starting?

# Check if Flask installed:
pip3 show Flask

# Check port 5000 available:
lsof -ti:5000

# View backend logs:
tail -f /tmp/backend.log

Delete not working?

# Check backend is running:
curl http://localhost:5000/api/health

# Should return:
# {"status": "ok", "message": "Asset Backend API is running"}

CORS errors?

# Make sure both servers running:
# Backend: localhost:5000
# Frontend: localhost:8080

---

📊 STATUS:

Feature	Status	Notes
Backend API	✅ Running	Flask on port 5000
Delete Endpoint	✅ Working	Deletes files from disk
Re-roll Endpoint	⚠️ API Only	Image gen not implemented
Manifest Regen	✅ Working	Auto-updates after delete
Frontend Integration	✅ Working	API calls functional

---

🚀 NEXT STEPS:

1. Image Generation: Integrate Gemini API for re-roll
2. Batch Delete: Select multiple assets
3. Undo: Trash bin before permanent delete
4. Preview Changes: Show what will be deleted
5. Authentication: Add user login

---

Setup Time: ~15 min
Dependencies: Flask, flask-cors
Ready: YES ✅