Data Architecture & Structures

To ensure trust, scalability, and efficiency, the system relies on three layers of data structures:

1. On-Chain (Smart Contract) → Immutable source of truth.
2. The Graph (Subgraph Indexing) → Optimized for querying and analytics.
3. Off-Chain (Database) → Flexible, user-facing profile and job management.

1. Smart Contract Data Structure (On-Chain)

Purpose: Immutable, decentralized source of truth. Optimized for gas efficiency and verifiability.

State Variables

• DAO_ADMIN: address → Initial contract owner/admin.
• isReviewer: mapping(address => bool) → Tracks authorized reviewers.
• ReviewerPool: address[] → Array of all reviewer addresses.

Events (Emitted for indexing via The Graph)

• ReviewerApproved → Parameters: address indexed reviewer.
• SkillRated → Parameters: address indexed reviewer, address indexed junior, bytes32 indexed skillHash, uint8 overallRating.
• CreditsSpent → Parameters: address indexed sponsor, address indexed candidate, bytes32 indexed jobIdHash, uint256 creditsUsed.
• HiringOutcome → Parameters: address indexed candidate, bool isHired.

2. The Graph Subgraph Data Structure (Decentralized Indexing & Querying)