⚡ [PLAN] Architektura Systemu

cosmiclands.tech + Shopify + Hostinger

Schemat przepływu: zakup działki → generowanie certyfikatu PDF → tworzenie NFT → wysyłka do kupującego

Shopify
Hostinger (Node.js)
PDF / Certyfikat
NFT / Blockchain
Crypto / COSMO Token
Core / Email
Mapa / Frontend
Warstwa 1 — Frontend & Sklep
🗺️
cosmiclands.space
Strona główna, landing, mapa interaktywna działek
Hostinger Static
🛒
shop.cosmiclands.space
Sklep Shopify — produkty, klasy S/M/L/XL, kolekcje planet
Shopify
🌐
cosmiclands.tech
Nowy projekt — panel crypto, wallet, zarządzanie NFT i COSMO
Hostinger VPS
Kupujący klika „Kup działkę" → Shopify Checkout
▼
Warstwa 2 — Zdarzenie zakupu (Shopify Webhook)
Shopify Order Webhook → orders/paid
1
Klient kupuje
Checkout Shopify, płatność zatwierdzona
→
2
Webhook fires
orders/paid → POST do cosmiclands.tech/api/order
→
3
API odbiera
Hostinger Node.js sprawdza sygnaturę HMAC
→
4
Queue / Job
Zlecenie do kolejki: generuj PDF + NFT
Równoległe procesy na Hostinger
▼
Warstwa 3 — Backend Hostinger (Node.js / cosmiclands.tech)
🧾 PDF Certificate Service
Dane działki z Shopify
Planet, Plot #ID, Class, Area, Owner name, COSMO, Date
Generator PDF
puppeteer lub PDFKit — szablon HTML → PDF z QR code, podpisem, logiem
puppeteer / pdfkit
Wysyłka e-mail
SendGrid / Resend — PDF jako załącznik + link do pobrania
SendGrid API
Certyfikat fizyczny (opcja)
Trigger do zewnętrznego serwisu druku / Printful / ręcznie
⚡
🎨 NFT Minting Service
Metadata Builder
JSON: name, planet, plotID, class, area, COSMO, landscape desc, owner
ERC-721 / ERC-1155
IPFS Upload
Obraz działki + metadata.json → Pinata / NFT.Storage → CID
Pinata API
Smart Contract Mint
Mintowanie NFT do wallet kupującego lub escrow, tokenURI = IPFS CID
ethers.js / viem
COSMO Token Grant
Przypisanie tokenów COSMO per klasa (100/300/900/2700) do konta
ERC-20 COSMO
Dostarczenie do kupującego
▼
Warstwa 4 — Delivery do kupującego
📧
E-mail z PDF
Certyfikat PDF jako załącznik + link do pobrania + dane działki
SendGrid
🎴
NFT w wallet
NFT zmintowany do adresu wallet kupującego (MetaMask, etc.)
Polygon / ETH
🪙
COSMO Tokeny
Tokeny przypisane do konta w panelu cosmiclands.tech
COSMO ERC-20
📮
Certyfikat fizyczny
Papierowy certyfikat wysyłany pocztą (trigger ręczny lub automat)
Poczta
cosmiclands.tech — centrum crypto ekosystemu
▼
Warstwa 5 — cosmiclands.tech (Nowy Projekt Hostinger)
cosmiclands.tech — Crypto & NFT Hub
🔑
Wallet Connect
MetaMask, WalletConnect — login Web3
wagmi / RainbowKit
🖼️
Moje Działki (NFT)
Dashboard właściciela — lista NFT, metadane, historia
💎
COSMO Dashboard
Saldo COSMO, historia transakcji, staking (roadmap)
📜
Smart Contracts
CosmoLands NFT (ERC-721) + COSMO Token (ERC-20)
Solidity / Hardhat
🌍
API Bridge
REST API: Shopify ↔ NFT mint ↔ PDF gen ↔ DB
Node.js / Express
🗄️
Baza danych
Orders, działki, NFT status, certyfikaty, właściciele
PostgreSQL / Supabase
Stack technologiczny — podsumowanie
Frontend
React / Next.js Tailwind CSS wagmi RainbowKit
Backend
Node.js Express PostgreSQL BullMQ
PDF
Puppeteer PDFKit SendGrid Resend
NFT / Blockchain
Solidity Hardhat ethers.js Pinata IPFS Polygon
Integracja
Shopify Webhook HMAC verify REST API
Hosting
Hostinger VPS Nginx PM2 Let's Encrypt
Następne kroki — Złota Droga
1. Smart Contract (ERC-721 + ERC-20 COSMO)
2. Node.js API na Hostinger VPS
3. Shopify Webhook → /api/order
4. PDF generator (Puppeteer + szablon)
5. Frontend cosmiclands.tech (wallet + dashboard)