#🛡 BaridiGuard Bot

BaridiGuard is a specialized Telegram bot designed for the Algerian community to combat scams and build trust in BaridiMob (CCP/RIP) transactions. It acts as a reputation layer for RIP numbers, allowing users to check, report, and vouch for accounts before sending money.

• 🔍 RIP Verification: Check if a BaridiMob RIP (20 digits) is trustworthy before you send money.
• 🚨 Report Scams: Submit reports about fraudulent accounts with screenshots as evidence.
• ✅ Vouch for Merchants: Recommend trusted sellers and help them build their reputation.
• 🔔 RIP Owner Notifications: Get instantly notified if someone reports or recommends your account!
• 📊 Personal Statistics: View your trust score, stats, and complete reporting history.
• 🇩🇿 Localized Experience: Fully optimized in Algerian Darja and Arabic.

• 📬 Automatic Report Forwarding: All reports are forwarded to a central admin ID for moderation.
• ✅ Approve/Reject System: Moderate reports directly from the Telegram interface.
• 🔍 Quick RIP View: Instantly access detailed RIP profiles from report notifications.
• 🤖 Suspicious Activity Alerts: Automated monitoring for potential abuse.

If you enter your correct RIP during registration, you'll receive a notification whenever someone mentions your account. This allows you to track your standing or dispute false reports instantly.

• Once Per RIP: Each account can only report a specific RIP once (ever) to prevent spamming.
• 24h Cooldown: To ensure quality reports, users can only submit one report every 24 hours across the platform.

• Weighted Scoring: High-trust users have more influence on the risk score.
• Time Decay: Reports lose their impact over time (50% validity every 6 months), allowing users to redeem their reputation.
• Positive Weighting: Recommendations have a strong positive impact, encouraging good behavior.

• Node.js (v18 or higher recommended)
• MongoDB (Local or Cloud/Atlas)
• A Telegram Bot Token

1. Clone the repository:

   git clone https://github.com/elhadjx/baridiguard.git
   cd BaridiGuard

2. Install dependencies:

   npm install

3. Configure environment: Copy .env.example to .env and fill in your details:

   cp .env.example .env

   Required Variables:

   • BOT_TOKEN: Your Telegram bot token.
   • MONGO_URI: Your MongoDB connection string.
   • ADMIN_TELEGRAM_ID: Your personal Telegram ID for moderation features.

Development mode:

npm run dev

Production mode:

npm run build
npm start

We want BaridiGuard to be a community-driven project. Whether you are a developer, a designer, or a security researcher, your help is welcome!

Check out our CONTRIBUTING.md to get started with:

• Fixing bugs or improving the code.
• Adding new features or localizations.
• Enhancing the documentation.

We take user privacy seriously. We only store the minimum information required for the bot to function and for the community to be safe (Telegram ID, Phone, and RIP). All data is handled with care and respect for privacy.

For support or questions, reach out to:

• Telegram: @elhadjx

This project is licensed under the MIT License - see the LICENSE file for details.

صنع بـ ❤️ في الجزائر 🇩🇿