Master Blueprint Hub
Architecture Blueprint • Production v137

Teme Astegni: Zero-Cost Ecosystem

Enterprise Management & Software Architecture Manual for Ethiopia's high-speed home tutoring dispatch engine. Operates at $0.00 fixed infrastructure cost using a 4-tier storage topology, 4 dedicated Telegram hubs, and an automated commission engine.

v137-LIVE Copy Version
EXECUTIVE VIEW MODE:
CORE OPERATING BLUEPRINT

How It Works in Practice: The Automated 3-Stage Pipeline

Zero Spreadsheet Fatigue • Founder Financial Shield

Admins work 100% inside the web dashboard. The silent background engine synchronizes with Google Sheets and Telegram, ensuring zero staff tampering and instant revenue logging.

flowchart TD subgraph AdminDesk["1. What Your Admins See (teme-admin.html)"] A1["📞 Incoming Parent Request
(Bole, Kazanchis, CMC)"] --> A2["🎓 Filter High-CGPA Tutors
(AAU / AASTU / ASTU)"] A2 --> A3["⚡ Click 'Confirm Match & Dispatch'
(1-Day Home Trial Scheduled)"] end subgraph SilentEngine["2. Silent Background Automation Engine"] A3 --> B1["Trigger Secure Webhook API
(Google Apps Script Engine)"] B1 --> B2["Append Row to Matches_Ledger
[Date, Parent, Tutor, Fee, Commission]"] A3 --> B3["Post Dispatch to Toutor Matches
(Telegram Supergroup ID: -1004357940585)"] B2 --> B4["🧹 Auto-Prune from Firestore Hot Desk
(Storage Returns to Zero KB)"] end subgraph MasterVault["3. Private Master Vault (Owner Access Only)"] B2 --> C1["👑 Founder (Ashenafi Girma)
ashenafitobe@gmail.com"] C1 --> C2["📊 Live Telebirr / CBE Revenue Analytics
(30% Month 1 + 200 ETB Month 2+)"] C1 --> C3["📑 1-Click Excel / CSV Export
(Certified Tax & Business Filing)"] end style AdminDesk fill:#0f172a,stroke:#38bdf8,stroke-width:1.5px,color:#fff style SilentEngine fill:#1e102e,stroke:#a855f7,stroke-width:1.5px,color:#fff style MasterVault fill:#06231a,stroke:#10b981,stroke-width:1.5px,color:#fff
💡 What This Is Automated 3-Stage Highway
Unified 3-Tier Enterprise Operations Highway

Clean separation of powers between your daily university dispatchers, the automated synchronization layer, and your private founder financial vault.

🛡️ Zero Database Confusion: Admins operate only inside the browser UI. They never touch raw databases, JSON files, or Google Sheet permissions.
⚡ Tamper-Proof Audit Trail: Every dispatch writes an append-only row into Matches_Ledger with date, tutor, parent fee, and commission.
🧹 Storage Quota Recycling: Dispatched leads are automatically pruned from the Firestore Hot Desk, resetting live database storage to 0 KB.
⚡ System State: Fully Connected & Operating
⚡ What You Need To Do SOP & Action Guide
Admin Staff
Dispatch from Cockpit: Open teme-admin.html, review parent inquiries (Bole, Kazanchis, CMC), filter vetted tutors, and click "Confirm Match & Dispatch". Never use notebooks or private scratchpads.
Founder / Owner
Monitor Master Ledger: Bookmark the Google Sheets Matches_Ledger. Review your live 30% first-month commission and 200 ETB recurring monthly retainers without staff interference.
Automated Engine
Zero Manual Labor: The silent engine streams matches to Telegram Hub #4, appends the Google Sheet, and cleans the live database in under 400ms.
Launch Admin Cockpit
DATA TOPOLOGY & CLOUD ARCHITECTURE

Four-Tier Zero-Cost Storage Dataflow

95% Bandwidth Compression • 0.00 ETB Cost

Heavy photo binaries never touch Firestore. Client PWAs compress photos on the user's phone, streaming high-res images to Telegram and micro-JSON text to Firestore.

flowchart LR User["👨‍👩‍👧 Parent / 🎓 Tutor
Client Smartphone"] -->|1. Upload Photo + Text| PWA["📱 Tier 1: Client Edge PWA
(Canvas 75% Image Compression)
6 MB -> 180 KB (95% saved)"] PWA -->|2a. High-Res Photos & IDs| TG["📸 Tier 3: Telegram Cloud Vault
(@ethio21_official_bot)
Unlimited Free Media Hosting"] PWA -->|2b. Light Text Only < 1.2 KB| FS["⚡ Tier 2: Firestore Hot Desk
(Sub-100ms Live Dispatch)
Free 50k Reads / 20k Writes"] FS -->|3. Match Confirmed| Admin["🛡️ Admin Cockpit
(teme-admin.html)"] Admin -->|4. Permanent Archive| GS["📗 Tier 4: Master Ledger
(Google Sheets Matches_Ledger)
Permanent Revenue Archive"] GS -.->|5. Prune Temporary Lead| FS style PWA fill:#0c4a6e,stroke:#38bdf8,stroke-width:1.5px,color:#fff style TG fill:#4c1d95,stroke:#a855f7,stroke-width:1.5px,color:#fff style FS fill:#78350f,stroke:#fbbf24,stroke-width:1.5px,color:#fff style GS fill:#064e3b,stroke:#34d399,stroke-width:1.5px,color:#fff
TIER 1 • CLIENT EDGE
HTML5 Canvas Engine

Downsamples photos to 1200px before uploading. Prevents network timeouts in Ethiopia.

TIER 2 • REALTIME DESK
Cloud Firestore

Holds ~1 KB JSON text only. Zero photo strings. Syncs in under 100ms within Spark quota.

TIER 3 • PERMANENT VAULT
Telegram Cloud API

Unlimited free media storage for Fayda IDs, Grade Reports, and Payment receipts.

TIER 4 • MASTER LEDGER
Google Sheets Ledger

Permanent audited revenue archive (Matches_Ledger). Holds only finalized paid pairings.

💡 What This Is 4-Tier Storage Topology
Zero-Cost Scalable Storage Architecture

High-efficiency cloud architecture designed for Ethiopia. Heavy photos are completely isolated from the database, guaranteeing $0.00 infrastructure bills even with 400,000 users.

📱 Tier 1 (Client Canvas): Compresses 6 MB photos to 180 KB right on the user's phone, avoiding mobile network drops in Addis Ababa.
⚡ Tier 2 (Firestore Hot Desk): Holds tiny text only (<1.2 KB), allowing 50,000 free operations daily with instant real-time sync.
📸 Tier 3 (Telegram Cloud Vault): Acts as an unlimited free media store for National IDs and bank receipts.
📗 Tier 4 (Google Sheets Ledger): Permanent historical financial record requiring 0 Firestore reads or storage bytes.
💰 Monthly Hosting Cost: 0.00 ETB / 0.00 USD
⚡ What You Need To Do Operational Protocol
Founder Protocol
Zero Server Maintenance: You do not need to buy AWS servers, configure Docker, or pay database subscriptions. The 4-tier pipeline runs 100% serverless.
Admin Staff
Use Web Dashboard Normally: When you view or match tutors, the app streams images directly from Telegram and text from Firestore seamlessly behind the scenes.
Automated Engine
Automatic Compression: Every uploaded document or payment receipt is automatically compressed by 95% on the edge before cloud storage.
95% Data Savings Active

Four Dedicated Telegram Hubs (@ethio21_official_bot)

All dispatch notifications, document audits, and payment verifications flow into these verified channels.

KYC & TUTORS Channel #1
🎓 Tutors Hub

Vetted university applicant profiles, student IDs, Fayda verification, and GPA records.

Chat ID -1004410573815
Join Tutors Hub
CLIENT REQUESTS Channel #2
👨‍👩‍👧 Parents Hub

Inbound tutor requests from parents across Addis Ababa: subjects, child grade, and location.

Chat ID -1003632707084
Join Parents Hub
FINANCIAL KYC Channel #3
💳 Parents Payments

Deposit screenshots, Telebirr/CBE receipts, and registration fees sent by families.

Chat ID -1004427351129
Join Payments Hub
ACTIVE CONTRACTS Channel #4
🤝 Toutor Matches

Official matchmaking dispatches, confirmed pairings, trial contracts, and commission terms.

Chat ID -1004357940585
Join Matches Hub
💡 What This Is 4 Operational Hubs
Command & Control Telegram Hubs

All inbound leads, applicant credentials, payment screenshots, and confirmed match pairings are routed in real-time into 4 dedicated, invite-only Telegram channels.

🎓 Hub #1 (Tutors Hub): Student IDs, Fayda biometric verification, and academic transcripts from university applicants.
👨‍👩‍👧 Hub #2 (Parents Hub): Live stream of inbound home tutoring requests across Addis Ababa (grade, subjects, location).
💳 Hub #3 (Parents Payments): Audited channel receiving Telebirr and CBE transaction screenshots directly from families.
🤝 Hub #4 (Toutor Matches): Real-time dispatch bulletin broadcasting confirmed pairings, trial dates, and commission terms.
🤖 Powered by @ethio21_official_bot
⚡ What You Need To Do Founder & Staff Playbook
Founder & Staff
Join All 4 Channels: Click the purple "Join Hub" buttons on the cards above to join each channel from your smartphone or desktop Telegram app.
Founder Protocol
Pin & Unmute Alerts: Pin the 4 channels to the top of your Telegram screen. Enable sound notifications for instant response to new client leads.
Billing Officer
Reconcile in Hub #3: Check payment screenshots in Hub #3 against your Telebirr / CBE app before authorizing dispatchers to share contact information.
Open @ethio21_official_bot
BUSINESS OPERATIONS & COMMISSION LIFECYCLE

Exact Commission Formula: 30% Month 1 • 200 ETB / Child Month 2+

The system uses a transparent compound model. If a tutor teaches 2 children in one household, Month 2+ commission is 400 ETB.

flowchart TD P1["1. Parent Requests Home Tutor
(Subject, Grade, Days/Week)"] --> P2["2. Dispatcher Matches Vetted Candidate
(Agreed Hourly Rate: 200 - 600 ETB/hr • Monthly: e.g., 3,000 ETB)"] P2 --> P3["3. 1-Day Trial Session Conducted
(Parent Approves Match)"] P3 --> P4["4. Parent Submits Telebirr/CBE Receipt
(Verified in Parents Payments Hub)"] P4 --> M1["★ MONTH 1 SETTLEMENT
30% of Agreed Tutor Fee
3,000 ETB * 0.30 = 900 ETB"] M1 --> M2["★ MONTH 2+ RECURRING SETTLEMENT
Fixed 200 ETB per Matched Child / Month
2 Children = 400 ETB / Month
Auto-Renews on 25th of Every Month"] M2 --> LEDGER["Permanent Entry in Matches_Ledger
[Timestamp, Parent ID, Tutor ID, Monthly Fee, Commission, Status]"] style M1 fill:#312e81,stroke:#6366f1,stroke-width:2px,color:#fff style M2 fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff style LEDGER fill:#1e102e,stroke:#a855f7,stroke-width:2px,color:#fff

🧮 Live Match Commission Calculator

Month 1 Commission (30%): 900 ETB
Month 2+ Commission (200 ETB/child): 400 ETB / mo
6-Month Total Lifetime Value: 2,900 ETB
💡 What This Is Compound Commission Engine
Commission Formula & Lifetime Value Architecture

Teme Astegni's high-margin monetization engine: 30% upfront placement commission followed by a predictable 200 ETB / child recurring monthly retainer.

⏱️ Standard Hourly Rates Matrix: KG–Gr 4: 200–400 ETB/hr • Gr 5–8: 250–450 ETB/hr • Gr 9–12: 400–600 ETB/hr based on Basic, Silver, and Golden tutor academic tiers.
💎 Month 1 (30% Placement Fee): Paid after the 1-Day Trial is approved (e.g., 3,000 ETB tutor fee = 900 ETB platform revenue).
🔁 Month 2+ (200 ETB / Child): Low-friction recurring fee. 2 children in 1 home = 400 ETB / month ongoing retainer.
📈 Compound Household LTV: A 2-student family generates ~2,900 ETB across 6 months with zero recurring marketing cost.
💵 Recurring Settlement: 25th of Every Month
⚡ What You Need To Do Billing SOP & Cashflow Protocol
Billing Specialist
Invoice Month 1 After Trial: Once parent approves the 1-Day Trial, issue the 30% invoice immediately via Telebirr or CBE.
Admin Staff
Trigger Month 2 Retainer (25th): On the 25th of each month, message the family to confirm tutor continuity and collect 200 ETB/child.
Founder / Owner
Use Live Calculator: Use the tool above to model projections. All revenue reconciles automatically to your private Google Sheet ledger.
30% + 200 ETB Model Locked
ORGANIZATIONAL SCALE & HUMAN OPS

Team Sizing & Growth Hierarchy: Campus Student Model

Zero Office Rent • Part-Time Shifts

University student founder model balancing class timetables with high-velocity operations.

flowchart TD Founder["👑 Student Founder (Master Strategy & Ledger Oversight)"] subgraph Phase1["PHASE 1: BOOTSTRAP (1 – 50 Families) • 3 Student Employees"] P1A["📞 Lead Parent Dispatcher
(1:00 PM – 4:00 PM Shift)"] P1B["🛡️ Tutor Vetting Officer
(4:00 PM – 7:00 PM Shift)"] P1C["💳 Billing & Renewal Specialist
(Evening Payment Reconciliation)"] end subgraph Phase2["PHASE 2: REGIONAL SCALE (50 – 200 Families) • 5 Student Employees"] P2A["👥 Dispatcher A (8 AM – 1 PM)"] P2B["👥 Dispatcher B (1 PM – 6 PM)"] P2C["📢 2x Campus Dorm Ambassadors
(Engineering & Science Blocks)"] P2D["🎯 Operations & Customer Care Lead
(Quality & Dispute Resolution)"] end subgraph Phase3["PHASE 3: MULTI-CAMPUS (200 – 500+ Families) • 8–10 Student Employees"] P3A["🎓 AAU Flagship Leads (4-Kilo / 5-Kilo)"] P3B["⚡ AASTU & ASTU STEM Leads"] P3C["🌍 Regional Branches (Hawassa, Jimma, Bahir Dar)"] end Founder --> Phase1 Phase1 -.->|Scale Trigger 50+ Families| Phase2 Phase2 -.->|Scale Trigger 200+ Families| Phase3 style Phase1 fill:#0c4a6e,stroke:#38bdf8,stroke-width:1.5px,color:#fff style Phase2 fill:#78350f,stroke:#fbbf24,stroke-width:1.5px,color:#fff style Phase3 fill:#4c1d95,stroke:#a855f7,stroke-width:1.5px,color:#fff
PHASE 1 1 – 50 Families
3 Campus Student Staff

Part-time shifts (2–3 hrs/day) around lectures:

• Lead Dispatcher: Calls parents & matches tutors.
• Vetting Officer: Checks Student IDs & CGPAs ≥ 3.00.
• Billing Specialist: Telebirr/CBE receipts.
Monthly Revenue ~15k – 35k ETB
PHASE 2 50 – 200 Families
5 Campus Student Staff

Full-day coverage across morning/afternoon shifts:

• 2 Dispatchers: Shift A (8AM–1PM) & Shift B (1PM–6PM).
• 2 Ambassadors: Engineering & Science dorms.
• 1 Operations Lead: Dispute & trial resolution.
Monthly Revenue ~45k – 120k ETB
PHASE 3 200 – 500+ Families
8 to 10 Campus Staff

Campus branch leads across Ethiopian universities:

• AAU Leads: 4-Kilo & 5-Kilo flagship chapters.
• Tech Leads: AASTU & ASTU STEM network.
• Regional Chapters: Hawassa, Jimma, Bahir Dar.
Monthly Revenue ~150k – 350k+ ETB
💡 What This Is Campus Student Workforce
Zero-Rent Student Pod Organization

A high-velocity organizational hierarchy structured specifically for university students. Enables you to operate across Addis Ababa without expensive commercial office rents.

🎓 Phase 1 (1–50 Families): Lean 3-student pod working 2–3 hour evening shifts around lecture schedules.
⚡ Phase 2 (50–200 Families): 5 student employees with split shifts (8 AM–1 PM & 1 PM–6 PM) + campus dorm ambassadors.
🌍 Phase 3 (200–500+ Families): Multi-campus leads across AAU (4-Kilo / 5-Kilo), AASTU, ASTU, and regional chapters.
👥 Student Ops: $0 Fixed Office Overhead
⚡ What You Need To Do Hiring Roadmap & Shift Protocols
Founder Action
Recruit Initial 3 Classmates: Assign 1 Lead Dispatcher (calls parents), 1 Vetting Officer (checks CGPA), and 1 Billing Specialist (tracks receipts).
Scaling Trigger
Expand at 50 Families: Once you cross 50 active family contracts, split shifts into Shift A (morning) and Shift B (afternoon) to eliminate bottlenecks.
Team Protocol
5-Minute Shift Handover: Outgoing and incoming dispatchers do a 5-minute sync in Telegram Hub #4 to ensure zero pending leads remain untouched.
Phase 1 Active (1-50 Families)
ANTI-FRAUD & IDENTITY AUDIT

Multi-Tier Identity & Academic KYC Verification Flow

Strict verification protocols safeguarding Ethiopian households with cryptographic and academic audits.

flowchart TD Candidate["Tutor Submits ID & Academic Credentials"] --> IDType{"Identity Document Type"} IDType -->|Fayda National ID| Fayda["BarcodeDetector / jsQR (MOSIP Crypto QR)
Fallback OCR: FAYDA-XXXX-XXXX"] IDType -->|Kebele Resident ID| Kebele["Front & Back Photo Audit
Sub-City Stamp & KEBELE-XXXX-XXXX"] IDType -->|Ethiopian Passport| Passport["Machine Readable Zone (MRZ)
Bio-Data Page (Back Optional)"] Fayda --> AcadCheck["Academic Verification Engine"] Kebele --> AcadCheck Passport --> AcadCheck AcadCheck --> GPA{"University CGPA Audit
(Official Transcript / Student ID)"} GPA -->|CGPA >= 3.00 & Uni Matches| Approved["✅ Vetted & Approved
Dispatched to Tutors Hub (-1004410573815)"] GPA -->|CGPA < 3.00 or Inconsistent| Rejected["❌ Profile Rejected
Flagged for Secondary Manual Review"] style Fayda fill:#0c4a6e,stroke:#38bdf8,stroke-width:1.5px,color:#fff style Kebele fill:#78350f,stroke:#fbbf24,stroke-width:1.5px,color:#fff style Passport fill:#4c1d95,stroke:#a855f7,stroke-width:1.5px,color:#fff style Approved fill:#064e3b,stroke:#10b981,stroke-width:2px,color:#fff style Rejected fill:#4c0519,stroke:#f43f5e,stroke-width:2px,color:#fff
💡 What This Is Multi-Tier Identity & GPA SOP
Household Safety & Academic Vetting Protocol

Standard Operating Procedure (SOP) safeguarding Ethiopian families. Every tutor undergoes identity cross-checking and academic GPA verification prior to home dispatch.

🪪 Fayda National ID Dual-Check: High-density MOSIP QR decoding with client-side OCR fallback extracting FIN number & phone number.
🏛️ Kebele & Passport Options: Front & back audit for Kebele cards; machine-readable zone verification for Ethiopian passports.
🎓 CGPA ≥ 3.00 Threshold: Only university scholars with verified transcript proof ≥ 3.00 from accredited universities are certified.
🛡️ Zero Compromise Household Security
⚡ What You Need To Do Vetting Officer Action Guide
Vetting Officer
Audit in Hub #1: Inspect incoming candidate files in Telegram Hub #1. Match the tutor's selfie against their Fayda / Kebele photo.
Academic Audit
Verify Student ID & CGPA: Confirm university enrollment (AAU, AASTU, etc.) and ensure cumulative GPA is 3.00 or higher.
Dispatch Rule
Vetted-Only Dispatch: In teme-admin.html, only tutors with verified badges appear in the dispatch matcher. Unverified tutors cannot be dispatched.
Inspect Tutors Hub #1 CGPA ≥ 3.00 Enforced

Production API Specs & Core Code

Standard implementations for Telegram photo dispatch and edge canvas compression.

Test @ethio21_official_bot Dispatch
Firestore Config: astegni_system_config/public_config Synced
// 1. Client-Side 75% Image Compression (Edge Layer)
async function compressImage(file, maxDimension = 1200, quality = 0.75) {
  const bitmap = await createImageBitmap(file);
  const canvas = document.createElement('canvas');
  let { width, height } = bitmap;
  if (width > maxDimension || height > maxDimension) {
    if (width > height) { height = Math.round((height * maxDimension) / width); width = maxDimension; }
    else { width = Math.round((width * maxDimension) / height); height = maxDimension; }
  }
  canvas.width = width; canvas.height = height;
  const ctx = canvas.getContext('2d');
  ctx.drawImage(bitmap, 0, 0, width, height);
  return new Promise(resolve => canvas.toBlob(resolve, 'image/jpeg', quality));
}

// 2. Direct Telegram Vault Dispatch
async function sendToTelegramVault(chatId, blob, caption) {
  const formData = new FormData();
  formData.append('chat_id', chatId);
  formData.append('photo', blob, 'receipt.jpg');
  formData.append('caption', caption);
  formData.append('parse_mode', 'HTML');
  return fetch(`https://api.telegram.org/bot${BOT_TOKEN}/sendPhoto`, {
    method: 'POST', body: formData
  });
}
💡 What This Is Edge Compression & API
Production Edge Drivers & Telegram API Core

Reference code snippets demonstrating how user devices compress images locally before streaming directly into the Telegram Cloud Vault without taxing database limits.

🖼️ 75% Offscreen Canvas: Scales photos to 1200px and 75% JPEG quality in <120ms before any network transmission occurs.
🚀 Multipart Telegram POST: Streams photo blobs directly to Telegram servers, returning permanent CDN file IDs.
🔑 Zero Static Hardcoding: Credentials and endpoints synchronize dynamically from Firestore system configurations.
⚙️ Status: Active Inside Live Web Applications
⚡ What You Need To Do Developer & Admin Guide
Founder & Admins
Zero Maintenance Required: These algorithms are already running automatically inside teme-astegni.html and teme-admin.html.
Software Engineers
App Development Spec: When building future native iOS / Android mobile applications, use this exact canvas compression and Telegram multipart pipeline.
Connectivity Test
Verify Telegram Bot: Use the button above to message @ethio21_official_bot if Telegram connectivity ever needs a health check.
Ping @ethio21_official_bot
Copied to clipboard!