Companies, product lines and where your data lives

Companies, product lines and where your data lives

What it is

In Usystems, your organization may run multiple independent companies or holding companies. Each one is called a constellation. Within each constellation, you can offer multiple independent product lines or business units—each one called a product (or ref_product).

All your financial data—invoices, bills, journal entries, accounts, contacts, inventory—belongs to one product within one constellation. This ensures a pharmacy's data never mixes with a hospital's data, and one customer's records never appear in another company's view.

Why it matters

• Legal separation: Each constellation has its own chart of accounts, financial reports, and audit trail. This is essential if you operate separate businesses or entities with different tax IDs.
• Operational isolation: A user in the pharmacy sees only pharmacy data. A user in the hospital sees only hospital data. This prevents accidental mixing of sales, inventory, and accounts.
• Multi-tenancy at scale: The same Usystems server hosts dozens of independent organizations. Your data is secure and private.

How it works in Usystems

When you log into Usystems, the system identifies you via a domain or company selection. Each constellation has its own domain (e.g., mycompany.usystems.af). Within that constellation, you select which product you're working in (e.g., Pharmacy or Hospital). Once you choose, all your screens show data for that product only.

Your account permissions are also product-scoped: you might be a manager in the pharmacy but an operator in the hospital.

Where you see it

• Login page: If your organization has multiple constellations, you'll see a company or constellation selector.
• Product switcher: At the top of the Usystems interface, a menu lets you switch between products within the same constellation (e.g., Pharmacy → Hospital). Only products your user is authorized to see appear in the menu.
• API requests: Every API call to Usystems includes a header identifying your constellation. The server blocks cross-constellation access.
• Reports and exports: When you generate reports, they include only the selected product's data.

---