CheckByAI

AI-powered UK immigration compliance monitoring & document verification

CheckByAI is a comprehensive SaaS platform for UK immigration professionals, HR teams, and visa holders. It provides real-time monitoring of the UK Home Office Register of Licensed Sponsors and forensic verification of Certificates of Sponsorship (COS) documents.

_{🌐 Live at checkbyai.net}

🎯 What We Do

1. Sponsor Licence Monitor

Automated monitoring of the UK Home Office Register of Licensed Sponsors. Instantly alerts you when:

• Sponsors are removed or downgraded
• New routes are added
• Company details change
• Licence status is upgraded

Perfect for: Visa holders, immigration advisers, HR compliance teams

_{Live sponsor monitor — the Home Office updates the register at midnight; CheckByAI texts you instantly.}

2. COS Check — PDF Metadata Inspector (MIS)

Forensic analysis of Certificate of Sponsorship PDFs using AI and metadata forensics. Detects:

• Document tampering (Photoshop, GIMP, Canva edits)
• Fabricated metadata (missing or reordered XMP fields)
• Suspicious modification dates and metadata inconsistencies
• Incremental updates and editing tool fingerprints
• Invalid certificate generation (non-Apache)

Two-tier verification:

• User View — Verdict only: GENUINE (green shield) or EDITED (red shield) with one-line reason
• Admin View — Full forensics: all 6 authenticity checks.

Perfect for: Anyone verifying a COS document authenticity

_{Free fraud-prevention guide: 5 signs your CoS might be fake.}

---

🔬 How It Works

%%{init: {'theme': 'base', 'themeVariables': {
  'primaryColor': '#1e1b2e', 'primaryTextColor': '#e4e4e7', 'primaryBorderColor': '#7C3AED',
  'lineColor': '#7C3AED', 'secondaryColor': '#16121f', 'tertiaryColor': '#111114',
  'clusterBkg': '#111114', 'clusterBorder': '#2d2640', 'edgeLabelBackground': '#111114',
  'fontFamily': 'Segoe UI, sans-serif'
}}}%%
flowchart LR
    subgraph monitor["🛡️ Sponsor Licence Monitor"]
        direction LR
        GOV["Gov.UK Register<br/>143,000+ sponsors"] -->|"nightly cron 00:30 UTC"| SCRAPE["Scraper +<br/>Firecrawl fallback"]
        SCRAPE --> DIFF["Change detection<br/>7 change types"]
        DIFF --> QUEUE["BullMQ + Redis<br/>job queue"]
        QUEUE --> EMAIL["📧 Email"]
        QUEUE --> WA["💬 WhatsApp"]
        QUEUE --> SMS["📱 SMS"]
        QUEUE --> HOOK["🔗 Webhooks"]
    end

Loading

%%{init: {'theme': 'base', 'themeVariables': {
  'primaryColor': '#1e1b2e', 'primaryTextColor': '#e4e4e7', 'primaryBorderColor': '#7C3AED',
  'lineColor': '#7C3AED', 'secondaryColor': '#16121f', 'tertiaryColor': '#111114',
  'clusterBkg': '#111114', 'clusterBorder': '#2d2640', 'edgeLabelBackground': '#111114',
  'fontFamily': 'Segoe UI, sans-serif'
}}}%%
flowchart LR
    subgraph cos["🔍 COS Check — PDF Forensics"]
        direction LR
        PDF["CoS PDF<br/>upload"] --> META["XMP metadata<br/>extraction"]
        META --> CHECKS["6-point forensic<br/>analysis"]
        CHECKS --> TOOLS["Editing tool<br/>fingerprints"]
        CHECKS --> DATES["Timestamp<br/>consistency"]
        CHECKS --> INCR["Incremental<br/>update trail"]
        TOOLS & DATES & INCR --> VERDICT{"Verdict"}
        VERDICT -->|"✅"| GENUINE["GENUINE<br/>green shield"]
        VERDICT -->|"❌"| EDITED["EDITED<br/>red shield"]
    end

Loading

---

✨ Key Features

Feature	Free	Starter	Pro	Unlimited	Enterprise
Sponsor Watches	1	2	5	Unlimited	Unlimited
Notifications	Daily digest (next-morning email)	Email + WhatsApp (6pm)	All channels + Immediate	All channels + Immediate	All channels + Webhooks
Job Alerts	—	—	✅	✅	✅
Companies House Data	—	—	✅	✅	✅
COS Check Verifications	Limited	Limited	Pay-per-check	Unlimited	Unlimited
COS Check MIS	—	—	✅	✅	✅
API Access	—	—	—	✅	✅
Expert Review	—	—	Optional	Optional	Included

---

🚀 Quick Start

Prerequisites

• Node.js 20+
• PostgreSQL 14+ (or Neon serverless)
• Redis (Highly recommended, used for BullMQ job queue and rate limiting)
• Firecrawl API Key (Optional, used as primary scraper fallback for Gov.UK source)
• npm or pnpm

Local Development

1. Clone & install:

   git clone https://github.com/Sam-Aitech/Checkbyai.net.git
   cd Checkbyai.net
   npm install

2. Set up environment:

   cp .env.example .env
   # Edit .env with your database URL and API keys

3. Initialize database:

   npm run db:push
   npm run db:migrate

4. Start development server:

   npm run dev
   # App: http://localhost:5000

5. Run tests:

   npm run test:run

See DEVELOPMENT.md for detailed setup instructions.

---

📋 Documentation

• README.md ← You are here
• DEVELOPMENT.md — Local setup, architecture, running tests
• DEPLOYMENT.md — Production deployment, environment variables, scaling
• CONTRIBUTING.md — Development workflow, PR standards, code style
• SECURITY.md — Threat model, authentication, data protection
• docs/API_REFERENCE.md — All API endpoints, schemas, examples
• docs/SYSTEM_DESIGN.md — Architecture deep-dive, component design

---

🏗️ Tech Stack

Frontend:

• React 18 + TypeScript
• TailwindCSS + Radix UI
• React Query + Wouter
• Three.js for 3D visualizations

Backend:

• Node.js + Express
• TypeScript
• Drizzle ORM
• PostgreSQL (Neon serverless)
• BullMQ + Redis for job queue
• Passport.js (OAuth + Email OTP)

External Services:

• Stripe — Payment processing
• Cloudflare Turnstile — CAPTCHA/bot protection
• Resend / Brevo — Email delivery
• Twilio — SMS/WhatsApp notifications
• Cloudflare — CDN & DDoS protection

---

🔐 Security

CheckByAI handles sensitive immigration data. Key security features:

• End-to-end encryption for phone numbers (AES-256-GCM)
• Email OTP authentication (no passwords)
• Rate limiting on all public endpoints
• CSRF protection with SameSite cookies
• SQL injection prevention via parameterized queries (Drizzle ORM)
• File upload isolation with temporary storage + immediate deletion
• Session management backed by PostgreSQL

See SECURITY.md for full threat model, compliance information, and reporting security issues.

---

🐛 Reporting Issues

Security Vulnerabilities

Please email security@checkbyai.net with:

• Description of the vulnerability
• Steps to reproduce
• Potential impact

We'll acknowledge receipt within 24 hours and provide updates as we investigate.

Bugs & Features

Open an issue on GitHub Issues with:

• Clear title and description
• Steps to reproduce (for bugs)
• Expected vs. actual behavior
• Screenshots/logs if applicable

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for:

• Development workflow
• How to set up your environment
• PR standards and code review process
• Commit message conventions

---

📊 Metrics & Monitoring

• Sponsor Register — 124,000+ UK sponsors tracked
• Daily cron — Updates every weekday at 00:30 UTC
• Change detection — 7 change types (removals, upgrades, downgrades, etc.)
• Response time — Alerts within seconds for paid tiers

---

📄 License

CheckByAI is licensed under the MIT License.

---

📞 Support

• Documentation: github.com/Sam-Aitech/Checkbyai.net
• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: support@checkbyai.net

---

🗺️ Roadmap

Public feature roadmap:

• GitHub Issues

Operational execution roadmap (enterprise hardening, Phase 0 to Phase 8):

• docs/EXECUTION_PHASES_0_8.md

Usage:

1. Feature roadmap explains what users will get.
2. Operational roadmap explains how we make the platform enterprise-ready.

---

Made with ❤️ by the CheckByAI team