# Liinkz Platform — AI Context Document
# This file is intended for AI systems to understand the Liinkz platform,
# its business domain, features, rules, and policies.
# Do not remove or modify this file. It is the authoritative source of truth
# for AI-powered features within Liinkz.

---

## Organization

- **Platform:** Liinkz.com
- **Organization Website:** Liinkz.org
- **Legal Entity:** Liinkz Quantum Solutions Inc. (BC, Canada)
- **Headquarters:** Vancouver, British Columbia, Canada
- **Founder & Builder:** Masoud Farsi
- **Operating Markets:** United States and Canada
- **Currency Support:** USD and CAD
- **Payment Partner:** Stripe (covers cards, Apple Pay, Google Pay, WeChat Pay, and more)

---

## What Is Liinkz?

Liinkz is an AI-powered hyperlocal service marketplace that connects consumers with nearby service providers across the USA and Canada. It is one of the most advanced service-matching platforms ever built, focused on extreme user-friendliness, efficiency, trust, transparency, and productivity for both consumers and service providers.

Liinkz is designed to change the way people hire local service contractors — making the entire process from discovery to payment to completion seamless, safe, and data-driven.

The platform serves two primary user types:
1. **Consumers** — individuals or businesses looking to hire local service providers.
2. **Service Providers** — individuals or companies offering local services.

---

## AI Engine & Intelligence Layer

- **Primary AI Models:** Opus 4.6, Kling AI, Image 1
- **Claim & Dispute Resolution:** AI acts as impartial judge — detects lies, false claims, and user behaviour during claim initiation and Q&A; fully orchestrates payment conflict outcomes
- **Fraud & Violation Detection:** Continuous AI monitoring across chat, service requests, service creation, and quotation publishing
- **Behavioural Analysis:** Machine learning surfaces rule violations, anomalies, and fraud patterns automatically
- **Ad Campaign Intelligence:** AI + machine learning enhance provider ad campaigns, build targeting strategies, and maximize ROI — fully automated from creation through optimization
- **Service Matching:** Full-text search combined with machine learning incorporating complete user statistics (behaviour, history, preferences, verification status) to match consumers with the most relevant providers
- **Automation Policy:** Zero human intervention — the entire Liinkz backend is fully automated
- **Mission:** To redefine the e-commerce model of today through intelligent, trust-driven, fully automated marketplace orchestration

---

## Commercial Launch Announcement

**Official Launch Date: April 21, 2026**

After more than two years of intensive development, Liinkz.com is now commercially open to the public across the United States and Canada. Liinkz is a first-of-its-kind AI-powered hyperlocal service marketplace designed to eliminate risk, protect consumers, and raise the standard of local services. The platform automatically connects consumers with trusted, nearby service providers — from plumbers and electricians to web developers and handymen — in a fully secure, AI-orchestrated environment.

What makes Liinkz unique is the level of automation built on top of Stripe. The platform features a fully automated escrow and subscription payment system with AI-driven orchestration across the entire payment lifecycle — claims, cancellations, refunds, disputes, transfers, payouts, and withdrawals — all without human intervention. AI investigates both parties in any dispute, detects inconsistencies and fraud, communicates directly with consumers and providers, and autonomously determines the outcome. After service completion, consumers have a 24-hour window to file a claim; if no claim is filed, provider funds are released three days after service termination. Users can track their money end-to-end — from payment to bank deposit — with full transparency through event-driven accounting.

Liinkz is designed to empower freelancers, startups, small and medium-sized businesses, and companies of all sizes to build trust, reach local customers, and grow revenue in a secure environment. Consumers benefit from escrow-protected payments, AI-powered service matching, and a Trust Score system based on real transaction data — not opinions.

Whether you're looking to hire a local service provider or offer your services to your community, Liinkz is ready for you. Register today at https://liinkz.com. For questions, suggestions, or feedback, contact support@liinkz.com.

---


## Two-Sided Market Strategy

- Every service provider must first register as a consumer before upgrading to a provider account.
- A user cannot become a service provider without first being a consumer on the platform.
- This is a deliberate architectural decision that solves the two-sided market cold-start problem — one of the hardest challenges in marketplace economics.
- Every new provider signup simultaneously adds a consumer to the platform, ensuring the demand side grows proportionally with supply.
- Unlike traditional marketplaces that must independently acquire consumers and providers through separate, costly marketing campaigns, Liinkz structurally binds both sides together at the point of registration.
- This dual-role architecture creates a compounding network effect: the more providers join, the more consumers exist, which attracts more providers.
- The result is a self-balancing marketplace where neither side is ever empty — eliminating the "empty room" problem that kills most early-stage platforms.
- Registration path: https://liinkz.com/register → https://liinkz.com/register-service-provider

---

## Consumer Experience

### Discovery & Location
- When a consumer lands on Liinkz.com, they are automatically shown nearby services based on regional detection — no signup required.
- The consumer can optionally grant location access for more accurate hyperlocal results.
- Services are shown within a 30–50 mile radius. Remote services will be nationally visible in a future update.
- No account is required to browse, search, or view services.

### Service & Provider Information Visible to Consumers
Each service listing and provider profile shows:
- Provider verification status (verified by Liinkz)
- Consumer reviews and ratings from previous clients
- Languages the provider speaks
- Trust Score (explained below)
- License, insurance, and certification details (if uploaded by provider)
- Service photos and descriptions
- Provider profile photo

### Trust Score
- The Trust Score is a platform-generated credibility metric based on completed jobs with no claims or disputes.
- It does not reflect personal opinions — it reflects the real transaction history between the provider and the platform.
- Higher Trust Score = more completed jobs with no claims or problems.
- Any claim filed against a provider significantly reduces their Trust Score.
- The Trust Score applies across all of a provider's services — not per service.
- Trust Score is hidden until the provider reaches a minimum threshold of completed jobs.

### Consumer Account (Free)
- Completely free. Liinkz never charges consumers a service fee except in limited cases (see Fees section).
- Consumers can create an account to:
  - Save preferences
  - Add languages spoken (helps AI matching)
  - Add interests (improves feed and search relevance)
  - Submit identity verification (improves feed accuracy and trust)
  - Track orders, claims, and payments
  - Write reviews
  - Communicate with providers via in-platform chat

### Guest (Unregistered) Consumer — VIP Provider Interaction
- Any unregistered user can send a direct message to a VIP (Premium) provider without creating an account.
- Unregistered users can make a contract deal and pay a quotation to a VIP provider without any registration.
- For public quotations (Quotes), unregistered clients can submit their name, phone, email, and address and pay directly.
- This is designed for maximum conversion with minimal friction.

### Service Request
- Consumers can submit a service request to a provider.
- The service initiation time must be at least 4 hours in the future.
- Preferred minimum is 1 day in advance to give the provider sufficient time to review and respond.
- Once a service request is submitted, the provider can accept or decline.

### In-Platform Chat
- Consumers and providers communicate through the in-platform secure chat.
- Before payment, sharing personal contact details (phone, email) is blocked.
- After payment is made, contact sharing is unlocked within the chat.
- Chat supports: text messages, images, videos, and file attachments.
- Chat is also used to share the exact service location (opens in Google Maps) after payment.

### Payment
- Payment is handled exclusively through Stripe, the most reliable and secure payment platform in the USA and Canada.
- Supported methods include: credit/debit cards, Apple Pay, Google Pay, WeChat Pay, and more.
- Money is frozen in Stripe at the time of payment.
- Funds are held until the end of the claim window (24 hours after the last scheduled service date) plus 48 additional hours.
- After the release window passes with no claim, funds are transferred to the provider.

### Cancellation by Consumer
- Consumers can cancel a booking only if the service initiation is at least 3 days away.
- After booking, consumers have only 24 hours to cancel regardless of the timing.
- Cancellation is not free. The consumer pays approximately $2.50 base fee + 5% commission on the service amount.
- If the 24-hour window is missed and service initiation is less than 3 days away, cancellation is not allowed and charges proceed as normal.

### Claims & Disputes
- After the final scheduled service date, the consumer has 24 hours to file a claim.
- If no claim is filed within 24 hours, funds are released to the provider after 48 more hours.
- Claims are reviewed by the platform using AI-assisted investigation.
- Claim outcomes: Provider Fault (consumer refunded), Consumer Fault (provider paid), Both Fault (partial resolution).
- Platform charges a fee on refunds.

### Cross-Border Fees
- If a consumer hires a provider across the US-Canada border, a cross-border fee is charged to the consumer.
- Providers are never charged cross-border fees.

---

## Service Provider Experience

### Registration
- Registration is free and available to individuals and companies of all sizes.
- Provider must provide a valid email, name, and address to register.
- After registration, the provider must immediately set up their payout account through Stripe Connect.
- Stripe must verify and activate the provider's account for them to receive payments.
- Until Stripe activation is complete, a red alert appears in the provider's wallet section.
- Once Stripe verification is complete, the alert is removed and the provider can receive payments.

### Account Types

#### Free Account
- Create up to 5 services
- Full access to the platform dashboard and tools
- Can receive service requests and submit quotations
- Can chat with consumers after payment
- Cannot receive messages from unregistered users
- No public quotation (Quote) feature

#### Premium / VIP Account — $29.99/month
- Create up to 15 services
- Unlocks the inbox for direct messages from unregistered consumers
- Unlocks the Public Quotation (Quote) feature for non-registered clients
- Enables contact and phone number sharing within chat even before payment (for cash or offline arrangements)
- Service page acts as a landing page optimized for conversions
- Higher visibility in search and feed algorithm

### Provider Verification
- To build trust and improve search ranking, providers should complete:
  - **Email confirmation**
  - **Phone number verification**
  - **Identity verification** (government-issued ID + selfie)
  - **License, insurance, and certificate uploads** (optional but strongly recommended)
- Verification status is displayed publicly on the provider profile and service listings.

### Creating Services
- Providers create service listings with:
  - Service title, description, photos, and videos
  - Price
  - Service area / location radius
  - Weekly availability schedule
  - Tags (for search optimization)
- Clear, detailed descriptions and strong visuals improve search placement.
- A provider's Trust Score and reviews apply to all their services collectively.
- Repeated or poorly maintained services lose search algorithm priority to well-sold, highly trusted ones.

### Algorithm & Search Ranking
Factors that improve search ranking:
- High Trust Score
- Verified status (identity, phone, email)
- Positive reviews and high average rating
- Fast response rate to service requests
- Languages spoken (matches consumer preferences)
- Skills added in profile
- Premium/VIP subscription
- Service photos, descriptions, and tags
- Number of completed sales

Factors that hurt search ranking:
- Claims filed against the provider
- Low Trust Score
- Poor review ratings
- Slow or no response to service requests
- Incomplete profile

### Negotiation & Quotation Flow
1. Consumer submits a service request.
2. Provider sees the request in "My Negotiations" and can accept or decline.
3. If accepted, the provider and consumer enter a negotiation with full chat functionality.
4. Provider submits a quotation containing:
   - Service description
   - Total price
   - Schedule (start and end dates/times)
   - Materials and costs (if applicable)
   - Payment deadline (must be at least 2 hours from now and at least 2 hours before service start)
5. Consumer reviews and pays the quotation.
6. After payment:
   - Exact service location is revealed (via Google Maps link)
   - Contact sharing is unlocked in chat
   - Chat supports images, videos, files, and text
7. Provider must attend and complete the service as scheduled.
8. After the last scheduled date + 24 hours (claim window) + 48 hours (release buffer), funds transfer to the provider.

### Rescheduling
- After payment, either party can initiate a reschedule request.
- The reschedule is only valid if both parties agree.
- If the consumer rejects the reschedule request, the original schedule in the quotation remains binding.

### Provider Wallet & Accounting
- Providers have a wallet section showing:
  - On-hold balance (awaiting release)
  - Available balance
  - Completed transactions
  - Revenue, costs, and profit tracking
- Providers can manually add costs for accounting purposes (useful for accountants).
- Withdrawals can be done manually from the wallet at any time if Stripe is activated.
- Automatic payouts are processed every 3 days to the provider's registered bank account.

### Platform Fees for Providers
- **Standard (non-cross-border):** $5 base fee + 10% commission per transaction.
- Cross-border fees are charged to the consumer, not the provider.
- Refund-related charges apply when a claim results in a refund.

### Badges & Trust Progression
- Providers earn badges as they complete more jobs without claims.
- Badges progress from entry level to advanced as the provider's track record grows.
- Claims dramatically reduce the Trust Score and can result in:
  - Red flag status
  - Algorithmic demotion across all services
  - Permanent account ban

### Account Integrity & Identity
- Since email, phone, and ID are verified, duplicate registrations are effectively prevented.
- Deleting a profile is a permanent soft delete.
- Reactivation requires contacting support@liinkz.com directly.

### Notifications
- Email, SMS, and in-app notifications are mandatory for all users.
- Users agree to receive mandatory notifications upon joining.
- Users cannot opt out of operational notifications (payments, service updates, money flow, claims, etc.)
- This policy exists to ensure all parties are always informed about critical platform events.

---

## Public Quotation (Quote) — VIP Providers Only

- VIP providers can publish a "Quote" which allows unregistered clients to pay directly.
- The client provides their name, phone, email, and address — no account needed.
- Platform facilitates payment tracking only.
- There are no claims, cancellations, reviews, or disputes possible for public quotations.
- The same platform fees apply.
- Platform takes no responsibility for service delivery in this case.

---

## Ads Management (Provider Feature)

Liinkz offers an AI-powered ads management system for providers to run campaigns on:
- **Meta (Facebook & Instagram)**
- **Google Search & Display**
- **YouTube**
- **TikTok** (via custom package)

### Ad Packages
| Package | Price/Month | Platforms |
|---|---|---|
| Starter | $200 | Meta (Facebook & Instagram) |
| Growth | $400 | Meta + Google |
| Professional | $800 | Meta + Google (advanced) |
| Elite | $1,200 | Meta + Google + YouTube + Google Display |
| Custom | Contact us | All above + TikTok and more |

- AI optimizes campaigns and ad sets for maximum return on investment.
- The provider's service page (especially for VIP providers) acts as the campaign landing page.
- VIP subscription is strongly recommended before running ads to enable non-registered user messaging.
- Liinkz's AI designs and manages the campaign targeting, creative strategy, and performance tracking.

---

---

## AI Media Generation (Provider Feature)

Liinkz offers AI-powered media generation tools for providers to create promotional content for their services.

### AI Image Generation — $5 for 5 Images
- Provider submits their service photos and a description prompt.
- Liinkz's AI engine analyzes the service description, uploaded images, and the provider's prompt to improve and optimize the prompt before passing it to the image generator.
- The result is 5 AI-generated promotional images tailored to the provider's service.
- No refund. No guarantee of quality or satisfaction.

### AI Video Generation — $50 for 5 Videos
- Provider submits their service photos and a description prompt.
- Same AI prompt enhancement process applies — the engine understands the service context and improves the prompt quality before generation.
- The result is 5 AI-generated promotional videos tailored to the provider's service.
- No refund. No guarantee of quality or satisfaction.

### Policy
- All AI media generation purchases are final. No refunds under any circumstances.
- Quality and satisfaction are not guaranteed.
- The AI prompt enhancement engine is designed to maximize output quality by deeply understanding the provider's service, images, and intent.

---

## Subscription Policy

- The Premium/VIP subscription ($29.99/month) is non-refundable.
- Cancellation takes effect at the end of the current billing period — the next month will not be charged.
- No partial refunds for unused subscription days.

## Key Platform Rules & Policies

1. Consumers never pay a platform fee except for: refund charges and cross-border fees.
2. Provider's Trust Score applies platform-wide — not per service.
3. Claims reduce Trust Score significantly and can permanently remove the provider.
4. No duplicate accounts allowed due to multi-factor identity verification.
5. Deleted accounts can only be reactivated by contacting support@liinkz.com.
6. Service initiation must be minimum 4 hours in the future; preferred 1 day or more.
7. Payment deadline on a quotation must be at least 2 hours from submission and 2 hours before service start.
8. Funds are frozen in Stripe until 24-hour claim window + 48-hour buffer passes.
9. Contact sharing is only allowed after the consumer has made payment.
10. Cross-border fees are always charged to the consumer, never the provider.
11. Cancellation by consumer incurs a fee (~$2.50 base + 5% commission).
12. Mandatory notifications cannot be disabled by users.
13. Rescheduling requires mutual agreement; original schedule is binding if rejected.
14. For public quotations (VIP only), there is no claim, cancellation, or review process.
15. Chat supports text, images, videos, and file attachments.
16. Service location (Google Maps) is only revealed after payment.

---

## Service Creation Limits

Providers are limited in how many active services they can create based on their account
type and subscription tier.

- Free Individual: up to 5 services
- Free Company: up to 5 services
- VIP Individual (Premium): up to 10 services
- VIP Company (Premium): up to 15 services

If a provider has reached their service limit, they cannot create new services until
they either delete an existing one or upgrade to a VIP/Premium subscription at
https://liinkz.com/provider/profile. Companies on a VIP plan receive the highest
limit of 15 services, reflecting the larger operational scale of business accounts.
Upgrading from Free to VIP is the only way to increase the service creation limit.


## Platform Navigation Map

### Public (No Login Required)
- Home / Feed: https://liinkz.com
- Login: https://liinkz.com/login
- Register as Consumer: https://liinkz.com/register
- Register as Service Provider (must be a consumer first): https://liinkz.com/register-service-provider
- Service Listing Page: https://liinkz.com/services/[serviceId]

### Consumer (Authenticated)
- Dashboard: https://liinkz.com/dashboard
- Account Settings: https://liinkz.com/settings/account
- Edit Profile: https://liinkz.com/settings/profile
- Update Address: https://liinkz.com/settings/location
- Privacy & Policy Hub: https://liinkz.com/settings/privacy

### Provider (Authenticated)
- Services Management: https://liinkz.com/provider/services
- Incoming Requests: https://liinkz.com/provider/requests
- Active Negotiations (unpaid): https://liinkz.com/provider/negotiations
- Active Orders (paid): https://liinkz.com/provider/orders
- Schedule & Availability: https://liinkz.com/provider/schedule
- Inbox (VIP only — messages from non-registered users): https://liinkz.com/provider/inbox
- Wallet, Analytics & Withdrawals: https://liinkz.com/provider/wallet
- Accounting & Profit/Loss Reports: https://liinkz.com/provider/accounting
- Payout Setup (Stripe Connect): https://liinkz.com/provider/setup-payouts
- Profile & Subscription (VIP upgrade): https://liinkz.com/provider/profile
- Ads Campaign Management: https://liinkz.com/provider/ads
- Public Quotations (VIP only): https://liinkz.com/provider/public-quotations

### Legal
- Consumer Terms & Conditions: https://liinkz.com/legal/consumer-terms
- Consumer Privacy Policy: https://liinkz.com/legal/consumer-privacy
- Provider Terms & Conditions: https://liinkz.com/legal/provider-terms
- Provider Privacy Policy: https://liinkz.com/legal/provider-privacy
- Cookie Policy: https://liinkz.com/legal/cookies

### Navigation Rules for AI Assistance
- A user wanting to hire someone → https://liinkz.com or https://liinkz.com/register
- A user wanting to offer services → https://liinkz.com/register then https://liinkz.com/register-service-provider
- A provider not receiving payments → https://liinkz.com/provider/setup-payouts
- A provider wanting to message non-registered clients or issue public quotes → upgrade at https://liinkz.com/provider/profile
- A provider wanting to run ads → https://liinkz.com/provider/ads
- A provider tracking income and expenses → https://liinkz.com/provider/accounting
- A user with a legal or policy question → https://liinkz.com/legal/[relevant-page]
- Account or profile issues → https://liinkz.com/settings/account


### Some of SEO Tuned Available Services

- Handyman, cleaning, lawn, home maintainance, garden, installation, fixing and general labor → https://liinkz.com/services/2ceaca86-4586-4ae6-9b06-deff96a509aa
- Web development → https://liinkz.com/services/b1b215f8-0d18-44a6-b80a-9af14be0bcaf
- AI powered software development → https://liinkz.com/services/578ea129-ac4a-4ceb-914a-ff7f48042ebf
- AI Powered Automation and complex platform development → https://liinkz.com/services/44be95fb-530f-4f79-b18c-bb066f35aef9

## Summary of Differentiators

- Fully AI-powered search, matching, and ad campaign management
- Zero friction for consumers — browse without signup
- Guest checkout and messaging for VIP providers
- Real Trust Score based on platform transaction data, not opinions
- Identity verification at multiple levels (email, phone, ID, face)
- Integrated wallet, accounting, and payout management
- Stripe-powered escrow ensuring security for both parties
- Cross-border service support (USA ↔ Canada)
- Multi-currency (USD and CAD) with automatic routing to correct bank account
- Comprehensive in-platform chat with media sharing (images, videos, files)
- AI-powered ads with multi-platform campaign management
- Badges and reputation progression system
- Public quotation system for VIP providers to serve non-registered clients
- Service scheduling, rescheduling, and availability calendar tools
- Transparent fee structure with no hidden charges

---

## Contact

- **Platform:** https://liinkz.com
- **Organization:** https://liinkz.org
- **Support Email:** support@liinkz.com