Welcome to Fixt PSA
Fixt PSA is a multi-tenant SaaS Professional Services Automation platform for IT companies: customers, tickets/SLA, subscriptions/products, time tracking/invoicing, projects, and a customer portal — with an AI agent platform and a LinkedIn content/lead-gen module planned for later phases.
A tenant is a company using the platform (e.g. Fixt-it, ProWave,
AccuControl). Within a tenant there are customers — that company's own
customers. Never confuse the two: the tenant key is tenant_id everywhere.
Status: Phase A
This documentation covers the delivered foundation: Phase A (repo
skeleton, data model & tenant isolation, auth core with
password/TOTP-MFA/Microsoft SSO, RBAC + audit log, storage & virus scanning,
and the Ionic/Angular frontend foundation). Later phases (customers/tickets,
invoicing, projects, AI agents, …) build on this — see ROADMAP.md in the
repo for the full phase order and docs/specs/fase-a.md for the Phase A
delivery note.
Who this documentation is for
| Section | For whom |
|---|---|
| Developers | Anyone working on the code: architecture, local dev stack, smoke scripts |
| Administrators | Tenant owners/admins: registration, MFA, users/roles, audit log |
| Staff | Day-to-day usage: logging in and uploading files |
First steps
New to the project? Developers should start at Architecture overview and Local dev setup. Administrators setting up a new tenant should start at Register a tenant.
This site summarises and points to SPEC.md (architecture and data
model document, repo root) and ROADMAP.md (phase order,
docs/specs/ROADMAP.md). When in doubt about a detail, the code and those
two documents are authoritative, not this site.