Organisations

What Is an Organisation in ArchRepo?

An Organisation represents a named unit within the business structure — a division, department, team, or any other grouping that has a distinct identity and contains people or other organisational units.

Organisations in ArchRepo are used to model the parts of the business that are relevant to the solution — not necessarily a complete corporate org chart, but enough context to understand who does what, and how the solution will affect the organisation.

Hierarchy

Organisations support a hierarchical structure. An Organisation can contain:

• Business Roles — the roles that people within this organisational unit hold
• Sub-Organisations — nested organisational units that belong to this one

This allows you to build a structured representation of the relevant business hierarchy:

Finance Division
├── Accounts Payable Team
│   ├── Accounts Payable Clerk (Business Role)
│   └── Accounts Payable Manager (Business Role)
└── Accounts Receivable Team
    ├── Billing Administrator (Business Role)
    └── Credit Controller (Business Role)

There is no required depth — model as many levels as are useful for the solution. Typically two or three levels is sufficient.

Why Document Organisations?

Documenting the organisational structure in ArchRepo provides:

• Contextual clarity — shows which part of the business each Business Role belongs to; makes it immediately clear who is affected by each part of the solution
• Impact analysis — when a process, system, or application changes, trace which organisations are affected via their linked roles
• Access design context — linking Application Roles to Business Roles and Organisations supports a clear explanation of the access model to stakeholders
• Stakeholder communication — the Business Organisations v Business Roles matrix view provides a clear, shareable picture of the organisational scope of the solution

Collection View

The Organisations collection includes a cross-reference matrix view:

• Business Roles — maps each Organisation to the Business Roles it contains; useful for verifying that the organisational scope of the solution is fully covered and that all relevant roles have been documented

Fields Reference

See Organisation Fields for a description of each field and guidance on what to record.