Contact person: Business Client

Phone:Show

Email:Show

Location: Tower Hamlets, United Kingdom

Budget: Recommended by industry experts

Time to start: As soon as possible

Project description:
"JOB SUMMARY:
We are looking for an experienced full stack developer to take over and complete an existing SaaS platform currently hosted on GitHub and deployed on Vercel.
The platform is live in staging but contains numerous bugs, broken functions and unfinished modules. It requires a full audit, debugging, completion of missing logic, and preparation for production release.
We need someone confident in reviewing another developer’s code, understanding the existing data flow, and delivering a clean, stable, functioning version ready for go-live.

PROJECT BRIEF – PLATFORM TAKEOVER AND COMPLETION:

Context
The platform is a partially built web-based SaaS application that aggregates structured data from multiple public sources, enriches those records, and displays them through a live user dashboard. The data flow, scheduler, and enrichment logic are already in place but are unreliable, incomplete or inconsistent.
The project sits in a private GitHub repository with an active Vercel staging build. Much of the front end and back end exist, but core modules are buggy and some key features remain unfinished. The last developer delivered an incomplete handover with errors, broken dependencies and unfinished API calls.
The goal now is to take over the existing codebase, stabilise it, fix the bugs, complete all outstanding functionality, and prepare the system for full production release.

CURRENT STATUS:
Live staging site running on Vercel
Full GitHub repository with environment configuration and deployment pipeline
Active database receiving and storing collected data
Scheduler present but unreliable
Dashboard functioning but inconsistent in data display and logic
Incomplete enrichment process and partial integration of contact data
Billing and account areas exist but require logic and layout fixes

KEY OBJECTIVES:
Audit the existing GitHub repository and identify all critical errors and missing elements
Clean up broken scripts and dependencies
Repair non-functional components
Implement the outstanding development items below
Test and validate the full data flow end-to-end
Prepare the final version for live deployment

OUTSTANDING DEVELOPMENT TASKS:
1. Device Login and Reset System
Current device limit locks users permanently when triggered
Reset does not clear stored tokens correctly
Add a Reset Devices function in the Account area
Add a route for locked-out users to request unlocks
Send an automated email notification whenever a new device logs in

2. Data Enrichment and Record Population
Fix enrichment logic so all company and contact fields populate correctly (phone, email, website, LinkedIn etc.)
Merge first- and second-level enrichment outputs cleanly into reports
Ensure both enrichment layers cooperate without duplication
Confirm reasoning and contact fields always appear in generated reports

3. Metadata and SEO Update
Update titles and descriptions across all main pages for indexing consistency

4. Manual Access Flow for Offline Payments
Create a restricted dashboard for manually approved users

Manual access flow:
User invited and signs up
User enters restricted dashboard with no live data
Add Create Invoice button
Include sequential numbering, line items, pricing and send/download options
Admin marks invoice as paid and activates plan
Automated renewal reminder email ten months after payment

Gateway flow:
User pays through integrated system
Invoice generated automatically
When plan updated manually, disconnect from automated billing

5. Invoice Management System
Build manual invoice tracking
Show invoice number, date, amount and status
Allow invoice view, download and email
Replace Due Date label with Next Invoice Date
Fix plan mapping so plan names match selected tiers

6. Subscription Plan Display
Align and standardise plan card dimensions and layout

7. Data Collection and Scheduler Validation
Ensure scheduler runs correctly and logs both last and next run times
Add manual Start and Stop buttons for control

8. Locked Account and Support Handling
Add reset/unlock option on login screen
Add backend support control to clear device sessions manually

9. Quality Assurance and Testing
Validate enrichment process end-to-end
Test across multiple record and user types
Check invoice and subscription renewals
Verify all email alerts and notifications trigger correctly

10. Data Flow Monitoring
Confirm automated collection runs reliably
Add clear indicators for process status
Ensure the flow below is followed precisely

Final Flow Diagram
[Scheduler]
↓
[Data Collection Workers]
↓
[Normaliser + Deduper]
↓
[Database: Clean Records]
↓
[Trigger: New/Updated Record]
↓
[Email Notification Service]
↓
[First-Level Enrichment]
↓
[Second-Level Enrichment]
↓
[Merge + Save Final Record]
↓
[User Dashboard + API]

Verify process handles new and updated records correctly
Ensure notifications only trigger for valid updates
Confirm enrichment and merge steps write clean final records to the database

REQUIREMENTS
Strong full stack development experience (Node / Python / React or equivalent)
Proven ability to debug and complete inherited projects
Experience deploying to Vercel or similar platforms
Understanding of API data flows, schedulers, and enrichment pipelines
Capability to work autonomously and document all fixes clearly

OBJECTIVE
Deliver a stable, fully functioning production build by completing unfinished logic, repairing existing bugs, and validating the complete workflow from data collection to dashboard output." (client-provided description)