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.
Complete Cost Breakdown
Based on 500 assessments per month. Cost per assessment = ~$0.02
Anthropic API — Predictable Cost at Any Volume
Cost per assessment stays flat at ~$0.02 regardless of volume — fully predictable for budgeting.
Scales Linearly — No Surprises
Every assessment costs exactly ~$0.02 in AI API usage. Budget is fully predictable. No minimum commitments, no surge pricing — pay only for what is used.
Licensing Considerations
Key licensing and compliance items to resolve before corporate deployment. One is critical — the rest are manageable.
CRITICAL — Anthropic API Commercial Terms
Using a personal Anthropic API key to process corporate HR/candidate data requires a commercial API account with a Data Processing Agreement (DPA) from Anthropic. Personal API terms do not cover corporate use.
Resolution: Set up a corporate Anthropic API account with enterprise terms
Claude Pro $20/month — No Issue for 1 User
Only one person uses Claude Pro in this corporate setup — for development, maintenance, and daily productivity work. Anthropic's ToS permits a single user to use their personal subscription for work purposes. This is no different from any individual using a personal software subscription at work.
No action required — $20/month personal subscription is sufficient for 1 user
Code / IP Ownership
Application currently built and hosted on a personal account. Legal must confirm intellectual property ownership is formally transferred to the company before corporate deployment.
Resolution: Legal sign-off on IP transfer
Candidate Data & Privacy Laws
The database stores candidate names, answers, and scores — classified as personal data. GDPR (EU), DPDP Act (India), CCPA (US) may apply depending on candidate location. Requires data retention policy and consent mechanism.
Resolution: Privacy policy, data retention rules, candidate consent
AI in Hiring — Regulatory Risk
AI tools used for candidate assessment are classified as High Risk under the EU AI Act. Candidates must be informed AI is scoring their responses. Some jurisdictions require a human review step for AI-assisted hiring decisions.
Resolution: Disclose AI usage to candidates — add human review confirmation step
OpenRouter API — Corporate IT Decision Only
OpenRouter currently routes AI prompts through a US third-party service. If corporate IT approves OpenRouter as a vendor — no change needed at all. The app continues working as-is with full multi-model support (Claude, GPT-4o, Gemini). Only switch to Anthropic direct if IT does not approve OpenRouter.
Ask IT: "Is OpenRouter approved?" — If Yes, zero change needed. If No, Claude Code switches to Anthropic direct.
Open Source Libraries — No Issue
All application dependencies use MIT or Apache 2.0 licenses — React, Hono.js, TypeScript, Tailwind CSS, Node.js, PostgreSQL. All fully permissive for commercial corporate use. No GPL restrictions.
No action required
GCP / AWS Cloud Platform — No Issue
Standard commercial cloud terms apply with a corporate billing account. Both GCP and AWS are pre-approved vendors in most corporate IT environments with established enterprise agreements.
No action required — standard corporate cloud procurement
Recommendation & Summary
Google Cloud Platform
Recommended- Simpler setup — Firebase deploy is 1 command
- FREE frontend hosting (Firebase)
- PostgreSQL at ~$10/month (Cloud SQL)
- Same cost after 12 months — no surprises
- Best fit if corporate uses Google Workspace
Amazon Web Services
- More setup steps for S3+CloudFront
- PostgreSQL at ~$15/month (RDS)
- App Runner free tier expires after 12 months
- Good fit if corporate uses AWS already
| Item | Detail |
|---|---|
| Application | AI-powered Technical Assessment Platform |
| Current hosting | Personal Cloudflare account |
| Target hosting | Corporate GCP (recommended) or AWS |
| 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 |
| Monthly cost — GCP | ~$40/month (500 assessments) |
| Extra vs today | +~$10/month — database hosting only |
Bottom Line
This application can be fully migrated, deployed, and maintained on corporate cloud for ~$40/month — with zero developer hiring cost — driven entirely by a $20/month Claude AI subscription. Admin only logs in to the cloud account once.