CloudWinks · Foundation apps

CruxTechnical brief

Crux is the shared record for every person and company in CloudWinks, together with the common reference lists every app uses. It is the one place a person or company exists, however many apps and address books use them.

Read the business brief · PDF

1. Architecture in brief

Crux owns the shared person and company records, icons and common code references. Apps extend those records with extension tables that have their own key and class (class name equals table name), a required reference to the Crux person or company and an extension block, without duplicating Crux core fields. Business logic and app-specific data stay with their owning apps.

2. Service boundary and intake

A Crux record is created when a person or company first has a phone or email, through find-or-create from the app or Rolodex import that needs it. Name-only contacts stay as Rolodex drafts until then. A verification and merge process handles duplicates.

3. Data handled

The core holds people and company details, icons, shared classifications and reference codes, including ISO 4217 currencies and ISO 3166 country and jurisdiction codes used by BeanCounter tax codes and TjingTjing jurisdictions. App extension tables hold each app’s own details. Rolodex holds each owner’s private notes and tags.

4. Integrations and ownership

BeanCounter, TjingTjing, Zibit, DreamDrafter, LandMan, TheBoss and the other apps reference Crux persons and companies. Rolodex extends Crux records per owner as an address book. KeyKook uses Crux identities and holds sensitive identifiers such as tax ids in its vault, with masked values shown from Crux.

5. Security and access

Identity and authorization are separate. A shared person record does not grant another company access to private information. KeyKook permissions and app rules govern visibility, and private address-book notes stay with their owner.

Competitive context

AlternativeIts focusCloudWinks product focus
Auth0 user managementUser profiles and organization management.One shared record for people and companies across every CloudWinks business app.
Odoo ContactsPeople and company contacts connected to business activity.A minimal shared core with app-owned extensions and a separate private address book in Rolodex.

Read the business brief →

← More Foundation apps apps · All application briefs · How the framework works