black12-ag/sartn

AI-powered Telegram business automation for Ethiopian entrepreneurs # SARTN — AI-Powered Telegram Business Engine 🇪🇹 -orange.svg) SARTN is an all-in-one, AI-powered business operating system and automation suite tailored for Ethiopian entrepreneurs. It operates via a unified **Telegram Bot** and an interactive, spring-animated **Telegram Mini App (TMA)** dashboard. It automates customer CRM, voice messaging, payment receipt OCR verification (TeleBirr/CBE), visually-built trigger-action automations, group moderation, and cross-channel marketing. --- ## 🌟 Key Features * **Bilingual Framework (EN + AM)**: Full localization across the Bot and Mini App, featuring advanced parsing for Romanized and Geez Amharic. * **Payment OCR & Fraud Detection**: Automated verification of screenshot receipts (TeleBirr, CBE Birr, CBE, Awash, Dashen, Abyssinia, Amole) with multi-signal fraud scoring. * **Bilingual Invoice Generator**: Generates custom PDF invoices with local tax rules (15% VAT) and downloadable links directly in the chat. * **AI Brain & 4-Key Rotation**: Intelligent intent detection and customer routing with failover key-rotation across Groq, Cerebras, Mistral, and OpenRouter. * **Voice Processing System**: Seamless speech-to-text (Whisper/Deepgram) and text-to-speech (ElevenLabs/LMNT) messaging pipelines. * **Group & Channel Automation**: Auto-welcome messages, bad word filters, anti-spam rate limiting, file scanner limits, and channel cross-posting ownership verification. * **Visual Trigger Automations**: A visual drag-and-drop workflow builder that lets owners configure custom automated message funnels. --- ## 📂 Repository Structure ```text sartn/ ├── apps/ │ ├── bot/ # grammY bot, Hono HTTP API server, and SQL migrations │ └── webapp/ # React 19 + Vite 6 + Tailwind 4 Telegram Mini App ├── packages/ │ └── shared/ # Shared TypeScript types, configuration schemas, and constants ├── deploy/ # Nginx configs, VPS setup, systemd services, and backup crons └── Brain/ # Knowledge base, …