PRODUCTION COWORKING ERP • CASE STUDY

Multi-Tenant Coworking ERP & Automated GST Billing Engine

An enterprise-grade flexible workspace ERP engineered to automate 6 physical branches. Combines real-time cabin occupancy state machines, dynamic digital legal contracts with official seal injection, automated 18% GST dual-stream invoicing tracking ₹21.1L+ monthly revenue, and zero-downtime Jenkins CI/CD infrastructure.

₹21.1L+ Monthly MRR Tracked
71.9% Live Cabin Occupancy
dashboard.ecowrkz.com
SUPERADMIN • Aatif

Good evening, Aatif 👋

Sales overview and follow-up status for today

Sun, 18 Oct 2026 Add Lead
Follow-up attention: 238 lead(s) haven't been followed up yet.
Review Leads →
Assigned To Me
55 +10%
Total leads assigned
Due Today
0View →
Follow-ups scheduled
Overdue
0-24%
Leads pending follow
Converted (Won)
₹21.1L+16%
Active monthly MRR
RECENT LEADS ASSIGNED TO YOUView All Leads →
S

Sathish Kumar

SFE group India pvt ltd • +91 9789236086

New
Y

YuvPrakash Ramu

Sri Vaari enterprises • +91 9360318114

New
R

Ratheesh Rk

Apex Infotech Solutions • +91 7848016777

Contacted
Node Cluster: 6 Nodes Healthy
Docker + Jenkins CI/CD • Coolify Host
+77.1% MoM

₹21,12,431+

Monthly Tracked MRR

₹16.33L + 18% GST (₹2.94L) & ₹1.85L exempt

57 Vacant

71.9%

Live Branch Occupancy

146 occupied / 203 total seats tracked

Instant Seal

85% Cut

Agreement Turnaround

Reduced from 48 hours down to 15 minutes

Audit Ready

100%

Billing & Tax Accuracy

Zero manual tax calculation discrepancies

EXECUTIVE SUMMARY & SCOPE

Modernizing Multi-Branch Coworking Operations

Ecowrkz is an enterprise-grade Coworking Space Management & ERP System engineered to automate end-to-end operations across multiple physical branches and organizations. It replaces fragmented legacy workflows—spreadsheets, physical paper lease agreements, disconnected manual billing, and uncoordinated resident complaints—with a unified real-time management operating system.

As Lead Full-Stack & DevOps Architect, I designed the complete multi-tenant infrastructure: an Express.js micro-monolith API, Next.js role-based branch manager and sales portals, real-time cabin concurrency state machines, a dual-stream 18% GST billing engine calculating ₹21.1L+ monthly revenue, and automated Jenkins CI/CD pipelines deploying containerized nodes to Coolify.

ENGINEERING ROLE

Lead Full-Stack & DevOps Architect

Architecture, backend, billing engine, CI/CD

TIMELINE

4 Months

MVP to Production Multi-Branch Scale

CLIENT & INDUSTRY

Ecowrkz Coworking Spaces

Commercial flexible workspace operator

DEPLOYED SCALE

6 Active Branches

Chennai (5) & Coimbatore (1)

dashboard.ecowrkz.com — Enterprise Ecosystem Switcher
Multi-Tenant Hub
ENTERPRISE HUB

Welcome back, tanjavoorathefe_66

Initialize your management environment by selecting an enterprise ecosystem below.

SALES PORTALSUPER ADMIN PROVISION ORG

Rankraze

6 ACTIVE NODES

Ecowrkz

PRIMARY

6 ACTIVE NODES (203 SEATS)

CHALLENGE VS. ARCHITECTURE

The Operational Bottleneck & The Solution

How manual spreadsheet friction was transformed into an automated, multi-branch ERP operating system.

BEFORE ECOWRKZ

The Operational Friction

Manual 18% GST Calculation Chaos

Coworking spaces bill both GST-registered corporate entities and exempt clients. Manual spreadsheet calculations resulted in rounding discrepancies, delayed billing cycles, and input tax credit audit risks.

48+ Hour Paper Lease Agreement Delays

Physical agreement drafting, manual token editing, courier handoffs, and ink stamping took 2 to 3 days per client, causing deal drop-off and delayed security deposit collections.

Double-Pitching Vacant Cabins (Concurrency Collisions)

Without real-time inventory synchronization across sales reps, multiple team members simultaneously pitched and reserved the same private cabins, causing embarrassing client conflicts.

Unrecorded Complaints & SLA Breaches

Facility maintenance, Wi-Fi outages, and housekeeping requests were handled over casual WhatsApp messages with zero accountability, leading to tenant dissatisfaction and churn.

AFTER ECOWRKZ

Unified Multi-Branch ERP Engine

Automated Dual-Stream 18% GST Engine

Dynamically splits active contracts into GST-eligible (18% tax) and exempt cohorts, generating audit-ready PDF tax invoices with CGST/SGST splits and zero floating-point rounding drift.

15-Minute Digital Agreement & Seal Injection

Automates PDF legal lease generation with dynamic variable injection, sharp transparent company seal stamping, and cryptographic verification QR codes synced to SharePoint.

Real-Time Cabin & Seat Concurrency State Machine

Atomic database state locks guarantee no two sales reps can allocate the same desk or cabin, broadcasting live 71.9% occupancy metrics across 203 mapped seats.

Resident Self-Service Portal & SLA Helpdesk

Provides clients with a dedicated portal for instant tax invoice downloads and ticket submissions, backed by internal facility SLA countdowns and resolution audit trails.

COMPLETE SYSTEM CAPABILITIES

11 Core ERP & Automation Modules

A comprehensive breakdown of every operational engine engineered into the Ecowrkz platform.

MODULE 01Space & Operations

Multi-Tenancy & Multi-Branch Hierarchy

Problem Solved

Coworking operators manage multiple physical facilities with distinct GST tax registrations, cabin layout blueprints, pricing structures, and localized staff access.

Engineered Solution

Engineered an Organization ➔ Branch ➔ Cabin ➔ Seat ➔ Contract hierarchy with dynamic route isolation (/[orgId]/[branchId]/[module]) ensuring branch managers only access their localized data.

Tenant IsolationRole-Based AccessBranch Blueprints
MODULE 02Sales & CRM

Lead Management & CRM Pipeline

Problem Solved

High-volume leads arriving from Meta Ads, Google Ads, website forms, and walk-ins were tracked on spreadsheets without clear assignment, causing lead leakage.

Engineered Solution

Built native .xlsx/.csv bulk ingestion with automatic deduplication, rule-based round-robin sales executive assignment, and chronological activity logging with callback schedules.

Bulk XLSX ImportRound-Robin AssignmentActivity Timeline
MODULE 03Sales & CRM

Dynamic Proposals & Quotation Builder

Problem Solved

Sales representatives spent hours manually drafting proposals with varying seat prices, deposit calculations, and discount rules, delaying deal closures.

Engineered Solution

Implemented a dynamic quotation builder computing seat counts, cabin tiers, amenities, and security deposits, generating instant PDF quotes with 1-click conversion to lease contracts.

Instant PDF QuotesPricing Logic1-Click Contract Drafting
MODULE 04Billing & Legal

Digital Legal Agreement & Contract Generator

Problem Solved

Physical agreement printing, stamping, courier delays, and legal archive overhead took 2 to 3 days per client onboarding.

Engineered Solution

Automated PDF agreement generation using Puppeteer & PDFKit with dynamic token replacement, cryptographic verification QR codes, Sharp-optimized company seal overlays, and automatic SharePoint sync.

Puppeteer & PDFKitCompany Seal StampingQR Code VerificationSharePoint API
MODULE 05Space & Operations

Physical Inventory & Cabin State Machine

Problem Solved

Concurrent inquiries for the same private cabin caused accidental double-booking and inaccurate branch vacancy reporting.

Engineered Solution

Developed a real-time seat inventory state machine with atomic MongoDB reservation locks. Displays live 71.9% occupancy metrics (146 occupied, 57 vacant out of 203 total seats).

Atomic State LocksLive Occupancy 71.9%203 Seats Mapped
MODULE 06Billing & Legal

Automated GST 18% Recurring Billing Engine

Problem Solved

Complex Indian tax compliance requires 18% GST (CGST 9% + SGST 9%) on standard corporate clients, while exempt entities require zero tax, leading to monthly calculation chaos.

Engineered Solution

Architected a dual-stream revenue engine separating GST-applicable contracts (₹16.33L + 18% GST = ₹19.27L) from exempt contracts (₹1.85L) to compute ₹21.12L MRR with zero floating-point drift.

18% GST Dual StreamCGST/SGST SplittingProrated BillingZero-Drift Math
MODULE 07Space & Operations

Client Self-Service Resident Portal (/client)

Problem Solved

Community managers spent hours answering repetitive requests for tax invoice PDFs, Wi-Fi credentials, visitor passes, and payment receipts.

Engineered Solution

Created a dedicated client-authenticated resident portal for downloading past tax invoices, viewing active seat allocations, reviewing lease expiry terms, and submitting support tickets.

Resident PortalOne-Click InvoicesLease Status
MODULE 08Space & Operations

Helpdesk & Resident Ticketing System

Problem Solved

Resident complaints regarding air conditioning, internet connectivity, or housekeeping were handled over WhatsApp, resulting in lost accountability.

Engineered Solution

Engineered an internal helpdesk module with categories (IT, Maintenance, Housekeeping), SLA countdowns, priority levels (Low, Medium, Critical), and resolution audit logs.

SLA TimersInternal Staff NotesResolution Logs
MODULE 09Billing & Legal

Branch Expense & Financial Ledger

Problem Solved

Unmonitored facility operating expenses (electricity, fiber bandwidth, housekeeping, repairs) obscured true net profit margins across physical branches.

Engineered Solution

Implemented a comprehensive expense tracker categorizing operational overhead, directly juxtaposing invoiced revenue against branch expenses to yield net operating margins.

Expense CategorizationNet Operating MarginBranch Ledger
MODULE 10DevOps & Core

Executive Analytics & Retention Intelligence

Problem Solved

Leases ended without sufficient advance notice, resulting in vacant cabins and lost revenue before sales teams could negotiate renewals.

Engineered Solution

Engineered an automated 'Leaving Soon' early warning engine that surfaces expiring contracts (e.g. 19-day countdowns) with cabin details and revenue impact to trigger proactive renewal drives.

19-Day Churn AlertsMoM Revenue TrendOccupancy Forecasting
MODULE 11DevOps & Core

Enterprise DevOps, CI/CD & Infrastructure

Problem Solved

Manual deployments and configuration drift caused server downtime during working hours when branch managers were actively generating invoices.

Engineered Solution

Built multi-stage Dockerized containers orchestrating Node.js and Next.js, with automated Jenkins CI pipelines running build checks, health-check polling, and Coolify zero-downtime swaps.

Docker Multi-StageJenkins PipelineCoolify HostAutomated Health Checks
END-TO-END AUTOMATION FLOWS

Core Business Workflows

Examine how data flows autonomously from first inquiry through legal contract execution and recurring monthly GST billing.

STEP 01

Inbound Lead Ingestion

Leads captured via Meta Ads, Google Ads, or bulk Excel sheets (.xlsx).

✓ Deduplicated and validated
STEP 02

Sales Rep Auto-Assignment

Round-robin assignment rule matches lead with branch sales executive.

✓ Instant notification dispatched
STEP 03

Site Visit & Proposal

Rep selects available cabin inventory and builds a dynamic quotation.

✓ Real-time cabin vacancy check
STEP 04

Legal Contract Generation

Single-click generation of PDF agreement with seal and verification QR.

✓ Puppeteer & PDFKit engine
STEP 05

Inventory State Lock

MongoDB atomic transaction locks cabin seats and updates occupancy.

✓ Double-booking prevented
STEP 06

Resident Portal Handover

Client receives credentials for /client portal, invoices, and passes.

✓ Zero-friction onboarding
FINTECH & RECURRING REVENUE ENGINE

Dual-Stream Automated 18% GST Engine

Automating monthly recurring billing across ₹21.1 Lakhs in active contracts with deterministic, zero-drift tax calculations.

MATHEMATICAL BILLING FORMULA

Grand Total = Standard Base (₹16.33L) + 18% GST (₹2.94L) + Exempt Base (₹1.85L)

MONTHLY ONBOARDED VALUE₹21,12,431.28
STREAM A: 18% GSTCorporate Clients

Tax-Registered Contracts Base

₹16,33,236.00

CGST (9.0%):₹1,46,991.24
SGST (9.0%):₹1,46,991.24
Subtotal + GST:₹19,27,218.48
STREAM B: ZERO-TAXExempt Cohort

Non-GST Flagged Contracts

₹1,85,212.80

GST Applicable:0.0% (Exempt)
Contract Flag:excludeFromInvoicing
Total Exempt Base:₹1,85,212.80
TOTAL RECONCILIATION100% Balanced

Combined Monthly Invoiced

₹21,12,431.28

Total Seats Mapped:203 Seats
Occupied Seats:146 Seats (71.9%)
Vacant Cabins:57 Seats (28.1%)
PRODUCTION SYSTEM INTERFACE

Production Screenshots & Live Workspaces

Direct visual captures from the deployed Ecowrkz enterprise system operating in production.

https://dashboard.ecowrkz.com/sales
Live Sales Portal
Sales Hub & Lead CRM Management

Sales Hub & Lead CRM Management

Real-time sales dashboard showing lead assignment metrics (55 assigned), urgent follow-up notifications (238 pending attention), and the live chronological leads table tracking inquiries across Chennai and Coimbatore.

KEY ARCHITECTURAL HIGHLIGHTS
  • •Dynamic lead metrics: Assigned to me, Follow-ups due today, Overdue (-24%), Converted (Won)
  • •Meta Ads & Google Ads direct integration with source tagging
  • •Quick action controls: Direct call trigger, email dispatch, and lead stage advancement
INFRASTRUCTURE & TOPOLOGY

End-to-End System Architecture

Decoupled multi-tenant topology connecting Next.js client portals, an Express.js business engine, and automated DevOps pipelines.

CLIENT LAYER (Next.js 14+ / App Router)

Super Admin

Org Multi-Tenant Hub

Branch Manager

/[org]/[branch] Blueprints

Sales CRM Hub

Leads & Proposals

Resident Portal

/client Invoices & Tickets
HTTPS / REST API / JWT & RBAC Middleware
BACKEND API CORE & ENGINES (Express.js / Node.js)

Lead & CRM Engine

XLSX Import & Auto-Assign

Document & PDF Engine

Puppeteer, PDFKit & Sharp

Inventory State Machine

Cabin & Seat Concurrency

18% GST Billing Engine

Dual-Stream Tax Split

Helpdesk SLA Service

Priority & Resolution Audit

Branch Financial Ledger

Expense & Net Margins
Mongoose ORM / Microsoft Graph API / AWS SES SDK
DATA & CLOUD STORAGE LAYER

MongoDB Atlas

Replica Set • Document Hierarchy

Microsoft SharePoint

Graph API Signed Document Vault

AWS SES & Nodemailer

Transactional Email Invoices
ENTERPRISE DEVOPS & CI/CD PIPELINE

Jenkins Automated CI/CD

Git Checkout ➔ Docker Build ➔ Health Poll (curl -f :9007)

Coolify Zero-Downtime Swap
01

Stateless Micro-Monolith API

Chose a hardened Express.js micro-monolith over distributed microservices to eliminate network latency across seat reservation transactions, simplifying multi-tenant data consistency.

02

Optimistic State Locks in MongoDB

Leveraged MongoDB Atlas atomic conditional updates (findOneAndUpdate with activeStatus verification) to lock cabin seats during proposal conversion, preventing double-booking.

03

SharePoint Graph API Compliance Sync

Executed contracts are directly streamed via Microsoft Graph API into client corporate SharePoint folders, maintaining encrypted metadata in MongoDB for zero local disk dependency.

04

Zero-Downtime Jenkins & Coolify CI/CD

Every git commit triggers automated Docker multi-stage builds. Jenkins polls container health endpoints before Coolify swaps routing proxies, ensuring 99.9% uptime during business hours.

DEEP-DIVE ENGINEERING SOLUTIONS

Key Technical Challenges & Solutions

Examining the complex distributed systems, tax logic, and asset pipelines solved during development.

Challenge #1 • FinTech & Tax Engine

Handling Complex Dual-Category GST Tax Rules

The Technical Hurdle

Coworking spaces bill different types of clients—standard corporate entities requiring 18% GST tax invoices with input tax credit (ITC), and exempt or overseas entities with zero GST. Applying a blanket formula distorted revenue calculations, produced floating-point rounding errors, and created audit non-compliance risks.

The Engineered Solution

Engineered a partitioned calculation engine in the backend billing service. Contracts are dynamically classified into GST-eligible and non-GST sets, calculating subtotals, CGST (9%), SGST (9%), and exempt totals with zero floating-point drift using integer-precision cents and deterministic rounding algorithms.

Challenge #2 • Distributed Concurrency

Real-Time Seat Allocation & Concurrency Race Conditions

The Technical Hurdle

When multiple sales representatives across Chennai branches pitched the same vacant private cabin to prospective tenants simultaneously, standard database read-then-write patterns risked double-allocating physical seats.

The Engineered Solution

Implemented atomic state updates utilizing MongoDB conditional transactions (findOneAndUpdate with optimistic status locks). When a proposal transitions to contract drafting, the seats are immediately flagged as reserved, rejecting conflicting actions and broadcasting the updated inventory counter across branch terminals.

Challenge #3 • Document Automation

High-Fidelity Legal Agreement Generation with Seals & Signatures

The Technical Hurdle

Generating 10+ page legal contracts with embedded high-resolution company seals, dynamic annexures, and verification QR codes was slow, caused server memory spikes, and produced layout shifts when rendered concurrently.

The Engineered Solution

Developed a dual-engine document pipeline: Puppeteer for complex HTML-to-PDF legal contract rendering with strict CSS page-break rules, combined with Sharp image processing for transparent seal alpha-blending and PDFKit for ultra-fast recurring monthly tax invoice generation.

Challenge #4 • Cloud Integrations & Security

Enterprise Document Storage & Regulatory Compliance

The Technical Hurdle

Storing signed PDF lease agreements on local server disks posed severe data loss risks, lacked version control, and failed enterprise corporate security audits required by large tenant clients.

The Engineered Solution

Integrated the Microsoft Graph API to stream signed PDF agreements directly into the client's corporate SharePoint document library with custom folder hierarchies per branch. Encrypted metadata pointers and access logs are maintained in MongoDB Atlas for instant retrieval.

TECHNOLOGY & RUNTIMES

Production Technology Stack

A battle-tested stack selected for performance, strict typing, high document throughput, and multi-tenant security.

Frontend

Next.js 14+ (App Router)Client & Admin Portals

Multi-tenant routing (/[orgId]/[branchId]), Server Components, and responsive dashboards.

Backend

Node.js & Express.jsAPI Gateway & Micro-Monolith

Stateless REST API with JWT authentication, RBAC middleware, and Zod schema validation.

Puppeteer & PDFKitDocument & Invoicing Engines

Headless Chrome for legal agreements with digital seals; PDFKit for high-speed monthly tax invoices.

Sharp & XLSXAsset & Ingestion Utilities

High-performance seal transparency blending and bulk lead Excel file parsing.

Database & Storage

MongoDB Atlas & MongooseMulti-Tenant Document Store

Hierarchical schemas (Org ➔ Branch ➔ Cabin ➔ Seat ➔ Contract) with atomic transactions.

Microsoft Graph APISharePoint Document Vault

Enterprise compliance storage streaming executed contracts into cloud SharePoint libraries.

DevOps & Cloud

DockerMulti-Stage Containerization

Lightweight container builds isolating the Express API and Next.js frontend with pinned runtimes.

Jenkins CI/CDContinuous Integration Pipeline

Automated git triggers, secret injection from vault, container build, and health check validation.

CoolifyProduction Orchestration

Self-hosted PaaS managing zero-downtime container swaps, reverse proxying, and SSL renewal.

AWS SES & S3Cloud Messaging & Backup

Transactional email dispatch for invoices and secondary encrypted cloud document backups.

MEASURED BUSINESS IMPACT

Engineering Outcomes & Measurable Results

Delivering substantial operational efficiency, zero tax reconciliation errors, and accelerated client onboarding.

Monthly MRR Tracked

₹21.1L+

+77.1% MoM Trend
Live Occupancy Rate

71.9%

146 / 203 Seats
Agreement Speed

85% Faster

From 48 hrs to 15 min
GST Calculation Errors

0 Errors

100% Tax Accuracy

15+ Hours Saved Weekly in Billing Operations

Eliminated tedious manual calculation of 18% GST splits, HSN tax invoices, and payment tracking across accounting and facility managers.

85% Reduction in Agreement Turnaround (2 Days ➔ 15 Min)

Automated digital lease generation with official seals and cryptographic QR codes allowed clients to sign contracts and receive access passes in 15 minutes.

Real-Time Branch Occupancy Visibility (71.9% Live)

Community leadership and sales executives gained live synchronization across all 203 seats, completely eliminating double-pitched cabins.

Zero-Downtime Container Deployments via Jenkins & Coolify

Implemented automated testing and container health polling, guaranteeing 99.9% uptime during peak business and invoicing hours.

LET'S COLLABORATE

Need an Enterprise ERP, SaaS Platform, or Scalable DevOps Pipeline?

Whether you are building high-volume billing engines, complex multi-tenant SaaS architectures, or automated Jenkins CI/CD infrastructure, let's build something exceptional together.

Tanjavoor Athefe • Lead Full-Stack & DevOps Engineer