Platform Documentation.

Official Specifications & Algorithms (v3.6.0)

A comprehensive technical breakdown of CONNECT's matching systems, identity grace periods, local database cache, and self-moderating reputation algorithms.

1. Product Overview

CONNECT is a digital matching infrastructure designed to link clients with vetted, verified local artisans (plumbers, electricians, carpenters, mechanics). By transforming the smartphone into a secure, offline-first business terminal, CONNECT bridges the trust deficit in the informal manual workforce.

Our dual-role setup manages client postings, matching algorithms, local geofencing triggers, and a knowledge-sharing Community Hub under a single verified account using Riverpod and ValueNotifier states.

2. Setup & Biometric KYC

Safety is hard-coded into the CONNECT ecosystem. Identity verification is processed securely via the integrated DIDIT KYC SDK to capture biometric facial scans and government ID documents.

Compliance & Lockout Thresholds

  • Artisan Verification Limit: 14-day grace period from registration.
  • Client Verification Limit: 90-day grace period from registration.
  • Grace Lockout: Unverified accounts are temporarily restricted from matching upon expiration. Ongoing active jobs shield profiles from restriction until completed.
  • Purge System: Automated system routines delete inactive, unverified profiles with no active jobs to keep our database clean.

3. Operational Workflows

CONNECT operates two double-initiation workflows tailored to planned projects vs. urgent emergencies:

Track A: The Standard Flow

Designed for renovations and planned contracts. The client uploads specifications which broadcast to a 50km radius. Nearby service providers "ping" the job, allowing the client to compare ratings, portfolios, and bids before hiring.

Track B: The Rapid Flow

Designed for urgent emergencies (burst pipes, electrical shorts). The client broadcasts a signal, and the first provider within 5km to accept is hired. Background GPS geofencing registers arrival on-site and auto-starts the job timer. Chat locks automatically upon resolution.

4. The Three Decline Actions

When a client rejects work completion, they choose from three self-moderating decline actions matching severity levels:

Option 1: Decline & Submit Review (Low Severity)

The client rejects the job and rates the provider (1-3 stars). To prevent retaliatory reviews, the client's profile automatically receives a fixed 5.0 rating, and the chat session remains open for coordination.

Option 2: Decline & Restrict Provider (Medium Severity)

The job is rejected, and the provider is assigned an automatic 2.0-star rating. The chat is locked immediately, and a mutual block is written to the database blocking profiles from appearing in future queries.

Option 3: Decline & File Formal Report (High Severity)

The job is locked without an immediate rating. An administrative incident is registered. A mutual block is established, and the provider has 7 days to submit evidence and appeal.

5. Visibility Algorithm

Search placement and matching alerts are determined by a dynamic Visibility Score. This automated score calculates placement based on quality, reliability, and positive customer feedback.

Core Performance Metrics

Our search ranking engine is built on the following criteria:

  • Average Rating: High ratings directly maintain your prominence in search queries.
  • Dispute Adjustments: Upheld disputes lower profile visibility, with repeat violations leading to account suspension.
  • Recovery Boost: Providers rebuild visibility by completing new jobs with positive ratings and maintaining a clean record.

6. Dispute Badges & Expiry

Admin-upheld disputes result in visible warning badges on provider profiles to inform clients of recent service violations.

  • Temporary Status: These warning indicators are temporary.
  • Automatic Expiration: Badges automatically expire and are removed once a specified period has passed, provided the artisan has had no new disputes and has successfully completed a required threshold of highly-rated jobs.

7. The Appeals Flow

To shield service providers from false claims or payment avoidance, the platform enforces a strict server-validated appeal flow:

  1. Client submits a Decline & File Report action.
  2. Provider receives an instant alert and has 7 days to upload counter-evidence.
  3. If the provider fails to respond within 7 days, the report is upheld (1.0-star rating applied and visibility drops).
  4. If the provider submits proof, the report is marked pending administrative review.
  5. The administrator reviews both sides. Overturned appeals void the rating, keeping the provider's record clean. Upheld decisions apply warnings, penalties, and visibility restrictions.