Skip to content

Figestió Platform

Two Spanish SaaS products that integrate into one experience for shared clients, on a single identity backbone.

  • Figestió — backoffice for accountants: they manage customers, their folders/files (synced from an EMPRESES desktop folder via Syncthing), and email notifications. Customers get a read-only portal to see their documents.
  • Xifrasoft — invoicing SaaS (issued/received invoices, VeriFactu, Stripe billing). Standalone for anyone in Spain, and integrable with figestió.
  • Identity — a central OIDC Identity & Tenancy service: the single login and the owner of the cross-product authorization graph (users, workspaces, agencies, grants).

The one big idea

A Workspace = one client company, shared by both products and keyed by a canonical workspaceId minted by the Identity service. An Agency (an accountant firm) groups customer workspaces via grants, which is how an accountant reaches their customers' data across both products.

flowchart LR
  U["Person<br/>(User)"] -->|member of| W["Workspace<br/>(client company)"]
  A["Agency<br/>(accountant firm)"] -->|grant: read / manage| W
  U2["Accountant"] -->|member of| A
  W -->|documents| FIG["figestió"]
  W -->|invoices| XIF["xifrasoft"]

Start with the Architecture overview, then dive into each service. The Integration page covers how the two products connect.

These docs are code

Everything here is Markdown + Mermaid in the figestio-platform repo, so it version-controls and an agent can keep it current. See Maintaining these docs.