VIRKSS Assessment Platform
Personal Cloudflare → Corporate Cloud
A complete plan to migrate, deploy, and operate the AI-powered technical assessment platform on corporate infrastructure — powered entirely by Claude Code AI subscription.
What Is This Application?
An AI-powered platform that automates the entire technical candidate assessment process.
Candidate Management
Admin creates candidate accounts, assigns technical skills and experience levels for assessment.
AI Question Generation
AI generates fresh, unique questions every session — MCQ, Coding, and Theory questions automatically.
Timed Assessment
Candidate logs in, takes a timed assessment with auto-save and auto-submit functionality.
AI Scoring
AI automatically evaluates and scores all answers upon submission — no manual review needed.
Results & Reports
Admin views detailed results, scores, and exportable reports for all candidates.
Secure Authentication
JWT-based login, PBKDF2 password hashing, and AES-GCM encrypted API key storage.
Why Migrate to Corporate Cloud?
Moving from personal hosting to corporate infrastructure delivers security, compliance, and ownership.
Corporate Ownership
Currently hosted on a personal account. Corporate needs full ownership of the application and its data.
Data Security
Candidate assessment data must be stored and controlled under corporate infrastructure policies.
Compliance
Corporate IT policies require all applications to run on approved, auditable cloud infrastructure.
Reliability
Corporate cloud platforms provide enterprise-grade uptime guarantees and SLA commitments.
Accountability
Corporate billing, vendor management, audit logging, and procurement under company control.
Enterprise Agreement
Access to corporate Data Processing Agreements (DPA) with AI vendors — required for HR data.
Current Technical Stack
All components currently running on personal Cloudflare account.
React 18
TypeScript
Vite
Tailwind CSS
Hono.js v4TypeScript
SQLiteCurrent vs Corporate Technology
Each component maps cleanly to a corporate cloud equivalent. Core logic remains unchanged.
| Layer | Current — Cloudflare | After Migration — GCP | After Migration — AWS |
|---|---|---|---|
| Frontend UI | React 18 + Vite + Tailwind + shadcn/ui | Unchanged | Unchanged |
| State Management | Zustand | Unchanged | Unchanged |
| Backend Framework | Hono.js v4 + TypeScript | Unchanged | Unchanged |
| Backend Runtime | Cloudflare Workers | Cloud Run (Node.js 20) | App Runner (Node.js 20) |
| Database | Cloudflare D1 (SQLite) | Cloud SQL — PostgreSQL 15 | RDS — PostgreSQL 15 |
| Authentication | JWT HS256 + PBKDF2 | Unchanged | Unchanged |
| Encryption | AES-GCM Web Crypto | Unchanged | Unchanged |
| AI Engine | OpenRouter API (multi-model) | Keep OpenRouter — or switch to Anthropic direct if IT requires | Keep OpenRouter — or switch to Anthropic direct if IT requires |
| Frontend Hosting | Cloudflare Pages | Firebase Hosting | S3 + CloudFront |
| Secrets Management | Wrangler Secrets | Google Secret Manager | AWS Secrets Manager |
Why PostgreSQL?
The industry-standard open-source database — free software, trusted by the world's largest companies.
Free Software
PostgreSQL itself costs nothing — open source forever
Industry Standard
Used by Google, Apple, Instagram, Spotify
All Clouds
Natively supported on GCP and AWS
30+ Years
Battle-tested, reliable, enterprise-grade
Simple Analogy
PostgreSQL is like a filing cabinet — the cabinet itself is free. You only pay for the room (cloud server) it sits in. The cloud hosting cost is ~$10–15/month.
- Database schema — same tables, same data, same structure
- All existing data — exported from Cloudflare D1, imported to PostgreSQL
- SQL format — minor syntax update handled by Claude Code
- Connection method — updated by Claude Code automatically
Who Does the Migration?
The entire migration, deployment, and testing is handled by Claude Code AI — included in the $20/month subscription.
Result — No Developer or DevOps Engineer Needed
All coding, deployment, and testing is handled by Claude Code. The only step the admin performs is logging in to the cloud account once.
Migration Phases
All phases executed by Claude Code. Admin logs in to cloud account once — Claude handles the rest.
Cloud Account Setup
Corporate creates GCP or AWS account. Admin logs in once. Claude Code provisions PostgreSQL database, creates Anthropic API account, stores API key securely in Secret Manager, and enables all required cloud services.
Code Migration
Database schema converted from SQLite to PostgreSQL. All existing data exported from Cloudflare D1 and imported into PostgreSQL with full verification. Backend updated, AI connection switched to Anthropic direct, frontend updated with corporate API URL.
Security Hardening
New JWT secret generated for corporate. Admin password reset — default password removed. CORS configured for corporate domain only. HTTPS verified on all endpoints. Database access locked — not publicly accessible.
Deployment
Claude Code executes all deployment commands directly. Backend deployed to Cloud Run or App Runner. Frontend deployed to Firebase Hosting or S3+CloudFront. Secrets configured in Secret Manager. HTTPS and CORS activated.
Testing & Verification
Full end-to-end test: admin login, candidate creation, candidate assessment flow, AI question generation, timer and auto-submit, AI scoring, results and reports. Any issues found are fixed automatically by Claude Code.
Go Live
New corporate URL shared with all users. Application live on corporate cloud infrastructure.
User Experience & Security
Zero change for users. Significant security improvement for the organisation.
- Admin login and dashboard — exactly the same
- Creating and managing candidates — exactly the same
- Candidate login and assessment — exactly the same
- AI question generation — exactly the same
- Assessment timer and auto-submit — exactly the same
- AI scoring and results — exactly the same
- Reports and exports — exactly the same
Users Notice No Difference
Only the URL changes to a corporate address. Everything else looks and works identically.
Budget-Optimised Cost Plan
Single VM — Nginx + Node.js + PostgreSQL on one server. All components on one machine, no extra managed services.
Anthropic API — Predictable Cost at Any Volume
Cost per assessment stays flat at ~$0.20 regardless of volume — fully predictable for budgeting.
Scales Linearly — No Surprises
Every assessment costs exactly ~$0.20 in AI API usage. Budget is fully predictable. No minimum commitments, no surge pricing — pay only for what is used.
Licensing Considerations
Standard licensing items to be aware of before corporate deployment. All are straightforward to address.
Anthropic API — Move to Corporate Account
Transfer the existing personal Anthropic API key to a corporate Anthropic API account — company-owned, billed to corporate, same token pricing. One-time setup action.
Claude Pro — Fine for 1 User
One person using Claude Pro for development and maintenance in a corporate context is standard. No additional licensing needed for a single user.
No action required — $20/month is sufficient
Anthropic API — Direct & Clean
AI requests go directly to Anthropic's models — no third-party gateway. Single-vendor setup, straightforward for corporate IT to approve.
No concern — standard vendor relationship
Open Source Libraries — No Issue
React, Hono.js, TypeScript, Tailwind, Node.js, PostgreSQL — all use MIT or Apache 2.0 licenses, fully permissive for commercial corporate use.
No action required
GCP / AWS Cloud Platform — No Issue
Both Google Cloud and AWS operate under standard commercial terms. Both are widely used, pre-approved vendors in most corporate IT environments.
No action required — standard cloud procurement
Recommendation & Summary
Google Cloud Platform
Recommended- Single VM — Nginx + Node.js + PostgreSQL
- Both scenarios well within budget
- Best fit if corporate uses Google Workspace
Amazon Web Services
- Good fit if corporate uses AWS already
- Slightly higher VM cost vs GCP
| Item | Detail |
|---|---|
| Application | AI-powered Technical Assessment Platform |
| Current hosting | Personal Cloudflare account |
| Target hosting | Corporate GCP (recommended) or AWS — single VM |
| Tech stack | React + TypeScript + Hono.js + PostgreSQL + Anthropic API |
| Who does migration | Claude Code AI — no developer needed |
| Who does deployment | Claude Code AI — executes all commands |
| Admin involvement | Log in to cloud account once — Claude does the rest |
| User experience | No change — works identically |
| One-time cost | $0 — covered by Claude subscription |
| GCP — 30 users | ~$90/month (within $100 budget) |
| GCP — 50 users | ~$160/month (within $200 budget) |
Bottom Line
Single VM on GCP fits comfortably within budget — $90/month for 30 users or $160/month for 50 users (at $0.20/assessment with buffer). Migration and deployment handled entirely by Claude Code AI. Admin only logs in to the cloud account once.