yeasin2002

JobSphere Money Flow - Simple Explanation

Last Updated: November 23, 2025
Status: Current Implementation

---

🎯 Quick Answer to Your Questions

1. How Does Money Work in JobSphere?

yeasin2002

Job Invite Module

Overview

The Job Invite module allows Customers to proactively invite Contractors to work on their posted jobs. This is the reverse of the job-request module where contractors apply to jobs. With job invites, customers can reach out to specific contractors they're interested in working with.

Flow Comparison

Job Request Flow (Contractor → Customer)

1. Customer posts job

yeasin2002

JobSphere Payment System - Complete Documentation

Version: 1.0.0
Last Updated: November 13, 2025
Status: ✅ Production Ready

---

Table of Contents

yeasin2002

Payment & Bidding System Architecture

System Overview

JobSphere's payment and bidding system is a commission-based marketplace that connects customers with contractors through a secure payment flow using Stripe.

Architecture Diagram

┌─────────────────────────────────────────────────────────────────────┐

yeasin2002

Mobile App Push Notification Integration

Minimal guide for integrating push notifications with JobSphere backend.

Base URL

https://your-backend-url.com/api

yeasin2002

Socket.IO Events Reference

Quick reference for all Socket.IO events in the chat system.

Client → Server Events

join_conversation

Join a conversation room to receive real-time messages.

Payload:

yeasin2002

Socket.IO Events Reference

Quick reference for all Socket.IO events in the chat system.

Client → Server Events

join_conversation

Join a conversation room to receive real-time messages.

Payload:

yeasin2002

Flutter Push Notification Integration Guide

This guide provides step-by-step instructions for integrating Firebase Cloud Messaging (FCM) push notifications in your Flutter mobile app with the JobSphere backend.

Table of Contents

1. Prerequisites
2. Flutter Setup
3. Implementation
4. Testing

yeasin2002

zod-to-openapi — guide & example

A concise, practical reference for using @asteasolutions/zod-to-openapi to:

• maintain one source of truth (Zod schemas) for both runtime validation and OpenAPI docs.
• generate an OpenAPI v3 document from your Zod schemas.
• use the same schemas to validate Express requests.

This file is meant to be used as a quick reference or instruction set for Copilot / Cursor / Kiro assistants. Keep schemas central, descriptive, and versioned.

yeasin2002

/*
File: contexts/AuthContext.tsx
Description: React context for authentication using JWT stored in HTTP-only cookies.
*/
import React, { createContext, useContext, useState, useEffect, ReactNode } from 'react';

// --- Types ---
export interface User {