Multitenancy(Organization/Workspace) Backend Module

Tech Stack

• Runtime: Node.js
• Framework: Express.js
• Language: TypeScript
• Database: SQLite (better-sqlite3)
• Authentication: JSON Web Tokens (JWT)
• ID Generation: UUID
• HTTP Utilities: CORS support, JSON parsing

Setup/Usage

Installation

npm install
npm run build

Environment Variables

Running

Production:

npm start

Development:

npm run dev

Server runs on port 9020 by default.

API Endpoints

Health Check

• GET /api/health — API status and timestamp

Authentication

• POST /api/auth/register — Register new user
• POST /api/auth/login — Login with credentials
• GET /api/auth/me — Get current user profile

Organizations

• POST /api/organizations — Create organization
• GET /api/organizations — List user's organizations
• GET /api/organizations/:orgId — Get organization details
• PATCH /api/organizations/:orgId — Update organization
• DELETE /api/organizations/:orgId — Delete organization

Workspaces

• POST /api/organizations/:orgId/workspaces — Create workspace
• GET /api/organizations/:orgId/workspaces — List workspaces
• PATCH /api/organizations/:orgId/workspaces/:workspaceId — Update workspace
• DELETE /api/organizations/:orgId/workspaces/:workspaceId — Delete workspace

Memberships

• GET /api/organizations/:orgId/memberships — List organization members
• POST /api/organizations/:orgId/memberships — Add member
• PATCH /api/organizations/:orgId/memberships/:membershipId — Update member role
• DELETE /api/organizations/:orgId/memberships/:membershipId — Remove member

Invitations

• GET /api/invitations — List user's invitations
• POST /api/invitations — Send invitation
• POST /api/invitations/:token/accept — Accept invitation
• DELETE /api/invitations/:invitationId — Revoke invitation

Response Format

All responses follow a consistent structure:

• Success: { data: {...} }
• Error: { error: "..." }

Authentication uses Authorization: Bearer <token> header.

Testing

All 26 endpoints tested and passing (see TEST_RESULTS.md for full coverage).