Official Documentation

Complete Platform Guide

Master every feature of WorkMA. From basic task management to advanced security features like the Nexus IDE, Panopticon, and Sentinel AI.

Architecture & The Walled Garden

WorkMA is built from the ground up for Enterprise security. We do not use shared database tables for sensitive data. Instead, when you create a Workspace, our `TenantService` dynamically provisions a completely isolated PostgreSQL schema specifically for your company.

Role-Based Access Control (RBAC)

Inside your Walled Garden, permissions are strictly enforced:

  • Tenant Admins have full access to billing, user invitations, API integrations, and the Vault.
  • Team Leads can create projects, assign tasks, review Merge Requests, and view analytics.
  • Developers can access the Nexus IDE, move tasks on the Kanban board, and submit code.

Team & Role Management

WorkMA goes beyond simple groups by offering 6 highly specific, granular roles to match your organization's hierarchy. Every action on the platform is gated by these permissions:

  • Tenant Admin: God-mode access. Can manage billing, APIs, and workspace settings.
  • Team Lead: Can create projects, approve tasks, review Merge Requests, and view Panopticon analytics.
  • Project Manager (PM): Focuses on Kanban boards, assigning tasks, and tracking sprint velocity without code access.
  • Developer: Full access to the Nexus IDE, code submission, and task completion.
  • QA Tester: Can view environments, test deployed code, and reject tasks in the approval workflow.
  • Designer: Access to task boards for UI/UX uploads and frontend collaboration.

User Profiles & Skills

Each member has a detailed profile tracking their skills, certifications, and experience level. When assigning tasks, Team Leads can easily match complex tasks with the right developer based on their tracked skill set.

Project & Task Management

WorkMA features a highly responsive, drag-and-drop Kanban board designed for speed. Tasks can be tagged with priorities, assigned to multiple avatars, and categorized by type (Frontend, Backend, DevOps).

WorkMA Kanban Dashboard

Task Approval Workflow

Unlike standard task managers where anyone can mark a task as "Done", WorkMA enforces an enterprise approval workflow. When a Developer marks a task as Complete, it is moved to the "Needs Approval" queue. A Team Lead or Admin must review the work (and code) before officially closing the task.

Code & GitHub Integration

Tasks in WorkMA are tightly integrated with your codebase. You can link GitHub pull requests, track specific branch names directly inside the task details, and view the Sentinel AI code review status without leaving the task view.

Rich-Text Descriptions & Time Tracking

Task descriptions use an advanced CKEditor instance with built-in code syntax highlighting for sharing snippets. Additionally, every task supports strict Time Tracking—allowing you to log estimated vs. actual hours to monitor sprint efficiency.

Real-Time Notification Engine

Never miss a critical update. WorkMA is powered by Django Channels and Redis to provide a completely real-time WebSocket notification system.

Mentions & Activity Feed

When you are mentioned in a task comment (`@username`), you instantly receive a browser push notification and an alert in your in-app Activity Feed. This eliminates the need to constantly refresh pages.

The system also automatically falls back to email notifications if you are offline for an extended period, ensuring you stay in the loop.

The Fortress IDE (Nexus)

Stop switching tabs between your project manager and your code. The Nexus IDE is a full-featured code editor embedded directly into your browser, powered by the Monaco Editor (the exact same engine behind VS Code).

WorkMA Nexus IDE

Real-Time Presence (WebSockets)

Nexus uses our custom WebSocket integration to show you exactly who else is viewing or editing a file in real-time. This prevents merge conflicts before they even happen.

Data Loss Prevention (DLP)

To ensure code security, our custom middleware intercepts and restricts native copy, cut, and paste functionality in the IDE. Your intellectual property cannot be exfiltrated easily by untrusted actors.

The Vault

Never hardcode API keys. The Vault allows Tenant Admins to securely store environment variables. These are masked from developers but securely injected into the runtime environment during execution.

Live Meetings & Notes

WorkMA integrates directly with Google Meet and Jitsi for zero-friction communications. You can launch a meeting directly from a Project page.

Live Meetings Split Screen

Auto-Saving Live Notes

During a video call, the right panel features a "Live Notes" document. As you type, the notes automatically save to the database every 2 seconds using a smart debounce algorithm. When the meeting ends, these notes are permanently attached to the meeting record for the whole team to review.

Security Panopticon & Developer Payroll

WorkMA employs military-grade security monitoring disguised as productivity analytics. Everything is tracked transparently.

Panopticon Analytics Dashboard

Activity Monitoring

When a developer is active in the Nexus IDE, the Panopticon background worker tracks:

  • Keystroke Velocity: Total coding speed and output.
  • Active Hours: Calculated in the background to automatically generate accurate timesheets for the Payroll dashboard. No more manual time tracking.
  • Security Anomalies: Large clipboard pastes or unusual behavioral patterns instantly trigger high-priority alerts to the Tenant Admin.

Sentinel AI Code Review

Before human eyes even see a Merge Request, the Sentinel AI is already at work. When a developer submits an MR through Nexus, Sentinel automatically intercepts the code diff.

It checks for OWASP vulnerabilities, logic errors, and styling issues, providing an automated security audit badge directly on the MR.

Billing & Workspace Management

WorkMA supports multi-tenancy. A single user account can belong to multiple completely isolated Workspaces (e.g., your day job and your side hustle). You can switch between these workspaces seamlessly from your dashboard.

Subscription Plans

Tenant Admins manage the workspace subscription via our secure Stripe integration. We offer scalable tiers:

  • Starter: 14-day free trial to experience the Walled Garden.
  • Pro: For growing teams needing full Nexus IDE access and Panopticon analytics.
  • Enterprise: For large organizations requiring Sentinel AI audits and unlimited storage.

Strict No-Refund Policy

Due to the immense computational resources required to provision isolated PostgreSQL schemas, dedicated WebSocket clusters, and Sentinel AI inference models, WorkMA operates on a strict No-Refund policy. Upgrades and downgrades will be prorated on your next billing cycle.

Step-by-Step Guides

Here are quick instructions for performing the most common actions in WorkMA:

How to Invite a Team Member

  1. Log into your Dashboard and navigate to Teams in the left sidebar.
  2. Click the "Invite Member" button in the top right corner.
  3. Enter the user's email address and select their Role (Developer, Team Lead, etc.).
  4. The user will receive an email with a secure link to join your Walled Garden.

How to Start a Live Meeting

  1. Navigate to the Meetings tab in the sidebar.
  2. Click "New Meeting". Give the meeting a title and select the relevant Project.
  3. Click "Join Live" to launch the split-screen video and notes interface.
  4. As you type in the notes panel, your text is automatically saved every 2 seconds.

How to Use The Vault (Secret Injection)

  1. As a Tenant Admin, open a project in the Nexus IDE.
  2. Click the Vault Icon (padlock) in the left sidebar.
  3. Click "Add Secret", enter your Key (e.g., STRIPE_API_KEY) and Value, and save.
  4. Developers can now write code referencing os.environ.get("STRIPE_API_KEY") without ever seeing the actual key.

Frequently Asked Questions

This is our Data Loss Prevention (DLP) feature working as intended. To protect intellectual property, tenant administrators can restrict the ability to copy code out of the environment. If you believe you need this access, please contact your Tenant Admin.
The Panopticon monitors active typing and IDE focus. It aggregates keystrokes into "Active Sessions." If a developer is idle for too long, the session pauses. Payroll uses these mathematically verified "Active Hours" rather than manual timesheets.
Yes! While Nexus acts as your primary editor, you can pull from and submit Merge Requests to GitHub or GitLab directly from the WorkMA interface. The Sentinel AI will audit your MR before it is pushed to your external repository.
Your workspace data will be frozen but never deleted. To regain access and continue your workflow, a Tenant Admin simply needs to visit the Billing page and enter a valid payment method.
If an Admin or Team Lead rejects a task in the "Needs Approval" stage, the task is moved back to the "In Progress" column and the assigned developer receives an instant real-time notification with the rejection notes.

Platform Admin Capabilities

For platform owners, WorkMA includes a robust "Super Admin" dashboard. From here, you can manage the global infrastructure, adjust pricing tiers, and monitor system health.

A critical feature is Tenant Impersonation. Support staff can temporarily safely assume the identity of a tenant to debug issues, and every single action is logged in an immutable `TenantAuditLogger`.