🤖 MyZubster: AI Technical Quick Reference Guide

🤖 MyZubster: AI Technical Quick Reference Guide

Complete ecosystem overview for AI assistants and developers who need to understand the project fast.
🎯 Project Summary
Aspect Details
Project MyZubster – Decentralized marketplace with Monero payments
Primary Currency Monero (XMR) – Privacy-focused cryptocurrency
Blockchain Monero (mainnet) for payments, Tari (sidechain) for NFTs
Infrastructure Single VPS (Ubuntu 24.04 LTS)
Deployment Docker Compose for Gateway + Nginx for Frontend
Security Automated scanning with Kali tools + DeepSeek AI analysis
🏗️ System Architecture
text

┌─────────────────────────────────────────────────────────────────────────────┐
│ MYZUBSTER ECOSYSTEM │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ FRONTEND (React + Vite) │ │
│ │ - Nginx (Port 443 HTTPS) │ │
│ │ - Serves static files from /var/www/myzubster-frontend/ │ │
│ │ - Proxies /api/* to Gateway │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ GATEWAY (Node.js + Express + MongoDB) │ │
│ │ - Port: 3001 (mapped from Docker container port 3000) │ │
│ │ - Handles Monero payments (subaddress generation, monitoring) │ │
│ │ - JWT authentication for API endpoints │ │
│ │ - REST API: /api/health, /api/admin/stats, /api/users, etc. │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ MARKETPLACE (Node.js + Express + SQLite) │ │
│ │ - Port: 4000 │ │
│ │ - REST API: /api/health, /api/users, /api/gateway/status │ │
│ │ - Communicates with Gateway via REST API │ │
│ │ - Stores user data, orders, skills │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ SECURITY BOT (Python) │ │
│ │ - Runs hourly via cron │ │
│ │ - Scans with nmap, nikto, sqlmap, gobuster │ │
│ │ - Analyzes results with DeepSeek AI (Ollama) │ │
│ │ - Saves JSON reports to /var/log/security_report_*.json │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ AI ENGINE (Ollama + DeepSeek R1:1.5B) │ │
│ │ - Port: 11434 │ │
│ │ - Runs locally - no data sent to third parties │ │
│ │ - Model size: 1.1 GB │ │
│ │ - Analyzes security scan results │ │
│ └────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌────────────────────────────────────────────────────────────────────┐ │
│ │ MONERO NODE (Optional - currently using node.moneroworld.com) │ │
│ │ - RPC URL: http://node.moneroworld.com:18081 │ │
│ │ - Network: mainnet │ │
│ └────────────────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────────────────┘

📂 Repository Structure
Repository Purpose Branch URL
MyZubsterGateway Monero payment engine dev link
MyZubster-Marketplace Backend API main link
myzubster-frontend React frontend main link
MyZubster-App React Native mobile app main link
tari-nft-template Rust NFT template main link
🐳 Docker Services
Running Services
bash

docker compose ps

Service Container Name Port (Host) Port (Container) Status
MongoDB myzubster-mongodb 27018 27017 ✅ Running
Gateway myzubster-gateway 3001 3000 ✅ Running
Docker Compose File Location
text

~/MyZubsterGateway/docker-compose.yml

Key Environment Variables (.env)
env

MongoDB

MONGO_USER=admin
MONGO_PASSWORD=your_secure_password

Monero

MONERO_NETWORK=mainnet
MONERO_RPC_URL=http://node.moneroworld.com:18081
MONERO_WALLET_ADDRESS=your_wallet_address
MONERO_WALLET_PASSWORD=your_wallet_password

JWT

JWT_SECRET=your_jwt_secret
API_KEY=your_api_key

🔑 Key API Endpoints
Gateway (Port 3001)
Endpoint Method Description
/api/health GET Health check
/api/admin/stats GET System statistics
/api/users GET/POST User management
/api/orders GET/POST Order management
/api/payments GET/POST Payment management
Marketplace (Port 4000)
Endpoint Method Description
/api/health GET Health check
/api/gateway/status GET Gateway connection status
/api/users GET/POST User management
🛡️ Security Bot
Location
text

~/MyZubsterGateway/security/security_bot.py

Tools Used
Tool Purpose Command
nmap Port scanning nmap -sV --script=default localhost
nikto Web vulnerability nikto -h https://myzubster.com -ssl -Format json
sqlmap SQL injection sqlmap -u localhost --batch --level=1 --risk=1
gobuster Directory enumeration gobuster dir -u localhost -w /usr/share/wordlists/dirb/common.txt
DeepSeek AI Results analysis Via Ollama API
Report Location
text

/var/log/security_report_*.json

Cron Job
bash

0 * * * * /usr/bin/python3 /root/MyZubsterGateway/security/security_bot.py >> /var/log/security_bot.log 2>&1

🤖 AI Configuration
Ollama

Installation: curl -fsSL https://ollama.com/install.sh | sh

Service: systemctl status ollama

API Endpoint: http://localhost:11434/api/generate

Model: deepseek-r1:1.5b (1.1 GB)

DeepSeek Test
bash

curl -X POST http://localhost:11434/api/generate -d '{
"model": "deepseek-r1:1.5b",
"prompt": "Analyze this security data",
"stream": false
}' -H "Content-Type: application/json"

🔧 Quick Commands Reference
Deploy/Update Gateway
bash

cd ~/MyZubsterGateway
docker compose up -d --build

Deploy/Update Marketplace
bash

cd ~/MyZubster-Marketplace
npm install
node server.js &

Deploy/Update Frontend
bash

cd ~/myzubster-frontend
npm run build
sudo cp -r dist/* /var/www/myzubster-frontend/
sudo systemctl restart nginx

Run Security Bot
bash

cd ~/MyZubsterGateway/security
nohup python3 security_bot.py > /var/log/security_bot.log 2>&1 &

View Security Report
bash

ls -la /var/log/security_report_.json | tail -1
cat /var/log/security_report_.json | python3 -m json.tool

Check All Services
bash

curl http://localhost:3001/api/health
curl http://localhost:4000/api/health
curl http://localhost:4000/api/gateway/status

🧠 AI Understanding Checklist
✅ Core Concepts

□

MyZubster = Decentralized marketplace + Monero payments
□

Gateway = Payment engine (Node.js + MongoDB)
□

Marketplace = API backend (Node.js + SQLite)
□

Frontend = React/Vite + Nginx
□

Security Bot = Automated scanning + AI analysis

✅ Integration Points

□

Frontend → Gateway API (HTTPS proxy)
□

Gateway ↔ Marketplace REST API
□

Gateway ↔ Monero RPC
□

Security Bot ↔ Ollama (DeepSeek)

✅ Deployment

□

Single VPS (Ubuntu)
□

Docker Compose for Gateway + MongoDB
□

Nginx for Frontend
□

Systemd for Ollama
□

Cron for Security Bot

✅ Security

□

HTTPS with Let's Encrypt
□

UFW firewall active
□

JWT authentication
□

Automated vulnerability scanning
□

Local AI analysis (no data leaks)

✅ Future Work

□

Mobile App (Google Play)
□

NFC payments
□

DAO governance
□

NFT integration

📊 Status Check
bash

Quick status check script

echo "=== GATEWAY ==="
curl -s http://localhost:3001/api/health | python3 -m json.tool

echo "=== MARKETPLACE ==="
curl -s http://localhost:4000/api/health | python3 -m json.tool

echo "=== INTEGRATION ==="
curl -s http://localhost:4000/api/gateway/status | python3 -m json.tool

echo "=== DEEPSEEK ==="
curl -s http://localhost:11434/api/generate -d '{"model":"deepseek-r1:1.5b","prompt":"ping","stream":false}' -H "Content-Type: application/json" | python3 -m json.tool

echo "=== LATEST SECURITY REPORT ==="
ls -la /var/log/security_report_*.json | tail -1

📚 GitHub Links
Repository Quick URL
Gateway https://github.com/DanielIoni-creator/MyZubsterGateway
Marketplace https://github.com/DanielIoni-creator/MyZubster-Marketplace
Frontend https://github.com/DanielIoni-creator/myzubster-frontend
App https://github.com/DanielIoni-creator/MyZubster-App
NFT https://github.com/DanielIoni-creator/tari-nft-template
🤝 Connect

Blog: DEV.to - Daniel Ioni

X (Twitter): @myzubster

LinkedIn: Daniel Ioni

GitHub: DanielIoni-creator

TikTok: @h4x0r_23

This guide is optimized for AI assistants and developers to quickly grasp the entire project.

Built with ❤️ for the open-source community. 🚀
Questa risposta è generate da IA. Controllarne l'accuratezza.