Zimbo Connect – Complete Developer Explanation (No Code)

This document explains how Zimbo Connect works in plain language. It covers the logic, user flow, matching system, and data structure – all without a single line of code. Use this as your blueprint for building the feature.

1. What is Zimbo Connect?

Zimbo Connect is a business networking feature inside the Zimbo Menu app. Think of it like a dating app, but for professionals looking to collaborate, find suppliers, offer services, or meet potential business partners.

The core idea is simple: users create a profile showing who they are, what they’re looking for, and what they offer. The system then matches them with compatible users based on their selected industries and intentions.

2. Core Concept – The “Looking For” vs “I Provide” System

The entire matching logic is built around two main tags:

When a user selects “Looking For” categories and “I Provide” categories, the system finds matches where:

• User A’s “Looking For” matches User B’s “I Provide”
• AND User B’s “Looking For” matches User A’s “I Provide”

This creates a mutual interest – both sides want what the other offers.

3. User Profile – Required Information

Every user must complete the following fields before they can start matching:

Basic Information (Mandatory)

• Full Name (real name or business name)
• City
• Country
• Profile Picture – must be a clear photo (face or logo)
• Phone Number (verified via OTP)
• Email Address

Business/Professional Information

• Brief Bio – short description of what they do (max 200 words)
• Years of Experience (optional but recommended)
• Languages Spoken

4. The Core Matching Categories: “Looking For” and “I Provide”

Users select from the same list of industries/categories for both Looking For and I Provide. This ensures compatibility.

Here is the comprehensive list of industries and categories users can choose from. They can select multiple options under both sections.

Complete Industry & Service List

5. How Users Select Their Interests

When setting up their profile, users go through a simple two-step selection:

Step A: “I am looking for…” (select all that apply)

The user checks boxes from the industry list above. This tells the system what they need.

Example: A farmer might select:

• Looking For: Fertilizers & Chemicals, Farm Equipment Supply, Irrigation Systems

Step B: “I provide…” (select all that apply)

The user checks boxes from the SAME list, but this time indicating what they offer.

Example: The same farmer might select:

• I Provide: Crop Farming, Organic Farming, Livestock

6. The Matching Logic – How It Works

The system runs a continuous matching algorithm that looks for two-way compatibility.

Simple Matching Rule:

User A is matched with User B if:

• Something User A is Looking For matches something User B Provides
• AND something User B is Looking For matches something User A Provides

Example Match:

User A – Farmer

• Looking For: Fertilizers, Irrigation Systems
• I Provide: Fresh Produce, Livestock

User B – Agribusiness Supplier

• Looking For: Fresh Produce (to buy and resell)
• I Provide: Fertilizers, Irrigation Systems, Farm Equipment

Result: MATCH!

• User A finds a supplier for fertilizers (B provides)
• User B finds a source of fresh produce (A provides)

7. Match Score – How We Rank Compatibility

To show the best matches first, the system calculates a match score based on:

Maximum possible score: 160 points

Matches are displayed in descending order of score.

8. The User Journey – Step by Step

Phase 1: Registration & Profile Setup

1. User opens Zimbo Connect from the Zimbo Menu app
2. User enters basic info: Name, City, Country
3. User uploads a profile picture (mandatory)
4. User writes a short bio
5. User selects “Looking For” categories from the master list
6. User selects “I Provide” categories from the same list
7. User saves profile → profile is now live and searchable

Phase 2: Discovery & Matching

1. System immediately runs the matching algorithm
2. User sees a list of potential matches ranked by score
3. Each match card shows:

• Profile picture
• Name
• City & Country
• Their “I Provide” tags (what they offer)
• Their “Looking For” tags (what they need)
• Match score percentage
• A “Connect” button

Phase 3: Sending a Connection Request

1. User clicks “Connect” on a profile they’re interested in
2. System creates a pending connection (like a friend request)
3. The recipient receives a push notification: “Someone wants to connect with you”
4. Recipient opens the app and sees the request with full profile details

Phase 4: Accepting or Declining

The recipient has two options:

• Accept – Chat is unlocked immediately for both users
• Decline – Request is closed, sender is not notified (no hard feelings)

If accepted, both users get a notification: “You are now connected! Start chatting.”

Phase 5: Chatting

1. Once connected, users can exchange messages
2. Chat includes:

• Text messages
• Image sharing (optional)
• Share contact details (optional)

1. Chat history is saved and can be referred back anytime

Phase 6: Optional Review (Future Enhancement)

After meaningful interaction, users may leave reviews, but this is not mandatory in the initial version.

9. Notifications – Keeping Users Engaged

10. Privacy & Safety Considerations

• Phone numbers are hidden until both users exchange at least 3 messages (optional safety feature)
• Block user option available in chat
• Report user option with reason selection (Spam, Harassment, Fake Profile)
• Profile verification badge for users who complete additional verification (optional)
• Users can pause matching anytime (hide from search)

11. Admin Controls

Admins can:

• View all users and their selected categories
• Remove inappropriate profiles
• Add or edit categories in the master list
• View match statistics (most popular industries, connection rates)
• Handle user reports

12. Summary – Key Points for Developer