🛡️ CHAMA-SHIELD ULTRA GUIDE

Cloudflare & Heroku සම්පූර්ණ අත්පොත

5 වසරේ ළමයෙකුටත් තේරෙන සරල භාෂාවෙන් — Link කරන හැටි, 50+ Bots Auto-Scaling, Backup සහ Security රහස්‍යතාවය!

🔒

100% ආරක්ෂිත රහස්‍යතා සහතිකය (No Public Secrets)

ඔබගේ Backend URL එක, MongoDB Atlas Database URL එක සහ Heroku API Key එක කිසිවෙකුටත් පෙනෙන්නේ නැත!
සියලුම Database credentials සහ Private keys ගබඩා වන්නේ Heroku Config Vars (Server-Side Secrets) වල පමණි. Frontend Web Dashboard එක හෝ Cloudflare පිටුව හරහා කිසිදු අමුත්තෙකුට ඔබගේ Database එකට එබිකම් කළ නොහැක.

📺

1. Cloudflare Web

ටීවී එකේ Screen එක (Frontend)

ලස්සන Dashboard එක! බට්න් ඔබන්න, Settings හදන්න, Phone Number එක ගහලා Pairing Code එක ගන්න පාවිච්චි කරන්නේ මේකයි. Cloudflare එකේ නොමිලේ තියෙන නිසා 24/7 කවදාවත් හිරවෙන්නේ නෑ.

🧠

2. Heroku Dynos

Bot ගේ මොළය (Backend Engine)

WhatsApp එක ඇතුළට ගිහින් රෑ දවල් නැතුව Status බලන, Auto Reply දාන සැබෑ Bot Engine එක! C++ sharding මඟින් RAM එක 512MB වලට අඩුවෙන් තබා ගනිමින් ක්‍රියා කරයි.

🗄️

3. MongoDB Atlas

අමරණීය සේප්පුව (Permanent Vault)

සියලුම Bots ලාගේ WhatsApp Session Keys, Auto-Save Contacts සහ Settings ස්ථිරවම තැන්පත් වන Cloud Storage එකයි. Heroku App එකක් Delete උනත් මේකේ දත්ත 100% සුරක්ෂිතයි!

💡 ඔබ ඇසූ වැදගත්ම ප්‍රශ්න සහ සවිස්තර පිළිතුරු

🤖 1. Bots ලා 50+ උනොත් අලුතින් App හැදිලා ඒවට Bots ලා add වෙනවද?

ඔව්, නියත වශයෙන්ම (100% Fully Automated)!
එක Heroku Dyno එකක 512MB RAM එක crash නොවී තියාගන්න උපරිම Bots ධාරිතාව 40-50 කි. 50 පිරුණු සැනින් අපගේ herokuOrchestrator එන්ජිම මඟින් Heroku API එක හරහා ස්වයංක්‍රීයව අලුත් App එකක් (උදා: chama-worker-xxx) හදයි. 51 වන Bot ගේ සිට සියල්ලෝම අලුත් App එකට migrate වී balance වේ!
⚡ C++ Hash Sharding Engine 🛡️ Zero RAM Overflows

📊 2. Database එකේ ඉන්න Bots ලා ගාන බෙදිලා අලුත් Apps හැදෙනවද?

ඔව්! Database එකේ Bots ලා 120ක් හිටියොත්:
• App 1 (Shard 0): Bots 1 සිට 40 දක්වා (RAM ~350MB)
• App 2 (Shard 1): Bots 41 සිට 80 දක්වා (RAM ~350MB)
• App 3 (Shard 2): Bots 81 සිට 120 දක්වා (RAM ~350MB)
කිසිම App දෙකක් එකම Bot ව run කරන්න උත්සාහ කරන්නේ නැත. සියල්ලෝම සමසේ බෙදී ගොස් සාමකාමීව වැඩ කරයි!
🧩 Shard Offset Partitioning

🔄 3. Heroku Apps ඔක්කොම Delete උනොත් ආයෙත් Start වෙන්නේ කොහොමද?

සියලුම Sessions 100% සුරක්ෂිතයි! ආයේ QR Code ගහන්න ඕන නෑ!
WhatsApp Login Keys (creds.json සහ Signal Pre-keys) කිසිවක් Heroku එක ඇතුළේ save වෙන්නේ නැත. සියල්ල තියෙන්නේ MongoDB Cloud එකේ ය.
Heroku Apps ඔක්කොම delete උනත්, අලුත් Heroku App එකක් හදලා ඔබගේ MongoDB URL එක ඇතුළත් කළ සැනින් — විනාඩි 2ක් (තත්පර 75-110) ඇතුළත සියලුම Bots ලා Auto-Connect වී Online එයි!
⏱️ 2-Minute Batch Reconnect Pipeline 🚫 No Re-Pairing Needed

🔐 4. Backend URL සහ Database URL කාටවත් පේන්නෙ නැති වෙන්න තියෙන්නේ කොහොමද?

කිසිදු URL එකක් හෝ Database Password එකක් Public තැන්පත් කර නැත:
• Database URL: ඇත්තේ Heroku Server එකේ Environment Config Vars වල පමණි (Frontend code එකේ නැත).
• Cloudflare Dashboard: පරිශීලකයා තම Backend URL එක තම Browser එකේ LocalStorage එකේ තබා ගන්නා බැවින්, අන් කිසිවෙකුට එය නොපෙනේ.
• GitHub Repositories: දෙකම Private Repositories ලෙස සුරක්ෂිත කර ඇත.
🛡️ Strict Server-Side Vault 🔒 Private Repositories

🚀 5. Bots ලා 10,000ක් (10,000 Bots) උනත් අවුලක් නැතුව වැඩ කරන්න පුළුවන්ද?

ඔව්! Enterprise Multi-Dyno Sharding Architecture එකෙන් 10,000 Bots ලා ලස්සනට Handle වෙනවා:
• ගණනය කිරීම: 10,000 Bots / Dyno එකකට 50 = Dynos 200ක Distributed Worker Grid එකක්.
• C++ Native Sharding: FNV-1a Consistent Hash Router එක මඟින් සෑම Bot කෙනෙක්වම microsecond ගණනකින් නියමිත Shard එකට route කරයි.
• Database Bulk Write: Pre-keys සහ Signal keys MongoDB එකට යවන්නේ 500 බැගින් bulkWrite queue එකකින් නිසා Database connection limit එක block වෙන්නේ නෑ.
• Micro-Batch Reconnect: සෑම Dyno එකක්ම තත්පර 75-110 ඇතුළත තමන්ට අදාළ Bots 50 දෙනා ස්වාධීනව parallel කර ගන්නා නිසා මුළු Cluster එකම එකවර Live එයි!
🌐 10,000 Bots Grid Capacity ⚡ High-Throughput Bulk Queue

📦 ZIP Files දෙක Host කරගන්නා සම්පූර්ණ පියවර (Zero Knowledge Setup)

WhatsApp එකෙන් ලැබුණු chama-shield-heroku-main.zip සහ chama-shield-cloudflare-main.zip ෆයිල් 2ක Cloud එකේ Host කරගන්නා ආකාරය පියවරෙන් පියවර මෙන්න:

PART 1

🧠 chama-shield-heroku-main.zip (Backend Bot Engine එක Host කිරීම)

මේ ZIP එක ඇතුළේ තමයි WhatsApp එකත් එක්ක Connect වෙන සැබෑ Bot Engine එක තියෙන්නේ. මේක Heroku එකේ Host කරන්නේ මෙහෙමයි:

පියවර 1: GitHub Private Repo එකක් හදන්න

github.com එකට ගිහින් New Repository එකක් හදන්න (නම: chama-shield-heroku, Private ලෙස තෝරන්න).

පියවර 2: ZIP එක Extract කර GitHub එකට Upload කරන්න

chama-shield-heroku-main.zip එක Extract කර, ඒ ඇතුළේ තියෙන ෆයිල්ස් ඔක්කොම GitHub එකේ "uploading an existing file" ඔබලා drag & drop කර Commit changes දෙන්න.

පියවර 3: Heroku එකේ Deploy කරන්න

heroku.com Dashboard එකට ගිහින් New App එකක් හදන්න (Region: Europe). Deploy Tab එකට ගොස් GitHub තෝරා ඔයාගේ Repo එක Search කර Connect කර Deploy Branch ඔබන්න.

පියවර 4: Config Vars (Database URL) ඇතුළත් කරන්න

Heroku හි Settings ➔ Reveal Config Vars වෙත ගොස්:
• MONGODB_URL = ඔබගේ MongoDB Atlas URL එක
• HEROKU_API_KEY = ඔබගේ Heroku Account API Key එක
ඇතුළත් කරන්න. විනාඩි 2න් Bot Backend එක සජීවීව ක්‍රියාත්මක වේ!

PART 2

📺 chama-shield-cloudflare-main.zip (Web Dashboard එක Host කිරීම)

මේ තියෙන්නේ ඔයාගේ Dark Cyber Hacker Web Dashboard එක! මේක Cloudflare Pages වල 100% නොමිලේ 24/7 Host කරගන්නේ මෙහෙමයි:

පියවර 1: GitHub එකේ chama-shield-cloudflare හදන්න

GitHub එකේ අලුත් Private Repository එකක් හදන්න (නම: chama-shield-cloudflare).

පියවර 2: ZIP එක Extract කර Upload කරන්න

chama-shield-cloudflare-main.zip එක Extract කර එහි ඇති ෆයිල්ස් (package.json, src, index.html ආදිය) GitHub එකට Upload කර Commit කරන්න.

පියවර 3: Cloudflare Dashboard එකෙන් Connect කරන්න

dash.cloudflare.com වෙත ගොස් Workers & Pages ➔ Create application ➔ Pages ➔ Connect to Git ඔබන්න.

පියවර 4: Build Settings තෝරා Deploy කරන්න

• Framework preset: Vite
• Build command: npm run build
• Build output directory: dist
Save and Deploy ඔබන්න. තත්පර 30කින් ඔබගේ Web Dashboard එක *.pages.dev link එකක් සමඟ සජීවීව ක්‍රියාත්මක වේ!

🔗 Cloudflare සහ Heroku සම්බන්ධ කරන පියවර 3

Heroku එකේ Bot URL එක ලබාගන්න

ඔබගේ Heroku Dashboard එකට ගොස් Backend App එක තෝරා Open app බොත්තම ඔබන්න. Browser එකේ උඩින් ඇති link එක copy කරගන්න.

https://your-bot-name.herokuapp.com

Cloudflare Dashboard එකට ඇතුළත් කරන්න

Cloudflare Web Dashboard එකට ගොස් ඉහළින් ඇති "Heroku Backend Link" කොටුවට copy කරගත් URL එක paste කරන්න.

Backend URL: [ https://your-bot-name.herokuapp.com ]

"Connect & Save" ඔබන්න!

එපමණයි! බොත්තම ඔබූ වහාම තිරය කොළ පැහැයෙන් Connected ✅ වී ඔබගේ Heroku Backend Bot එක සහ Cloudflare Web Dashboard එක සම්පූර්ණයෙන්ම ක්‍රියාත්මක වේ!

🧪 Live Link Tester (සම්බන්ධතාවය පරික්ෂා කරන්න)

ඔබගේ Heroku Bot URL එක මෙතනට ඇතුළත් කර "Test Connection" ඔබා සජීවීව පරීක්ෂා කරන්න: