Internal company support (#13017)

* Add internal company flag

* Unit tests

* Add changelog entry and update API version

* add global company table

* Expose model_filters for internal settings

* Update API version

* Update CHANGELOG

* update assert

---------

Co-authored-by: Matthias Mair <code@mjmair.com>

docs/docs/concepts/company.md

@@ -14,6 +14,31 @@ External companies are represented by the *Company* database model. Each company
 !!! tip "Multi Purpose"
     A company may be allocated to multiple categories, for example, a company may be both a supplier and a customer.
 
+### Internal Companies
+
+A company can also be marked as *internal*, meaning that it represents your own organization rather than an external business. Internal companies can have their own [contacts](#contacts) and [addresses](#addresses), just like any other company.
+
+More than one internal company can be defined - for example, if your organization operates as multiple legal entities, or from multiple sites.
+
+Internal companies are managed from the *Internal Companies* panel in the [Admin Center](../settings/admin.md). To mark an existing company as internal, edit the company and set the `is_internal` attribute to `True`.
+
+#### Default Internal Company
+
+The `INVENTREE_DEFAULT_INTERNAL_COMPANY` [global setting](../settings/global.md#server-settings) selects which internal company represents your organization by default. Only companies marked as internal can be selected.
+
+If this setting is not specified, and exactly one internal company exists, that company is used as the default.
+
+The default internal company is available to all [report and label templates](../report/context_variables.md) as the `internal_company` context variable. For example, to render your organization's name and primary address in a report header:
+
+```html
+{% raw %}
+{% if internal_company %}
+<h3>{{ internal_company.name }}</h3>
+<p>{{ internal_company.primary_address }}</p>
+{% endif %}
+{% endraw %}
+```
+
 ### Edit Company
 
 To edit a company, click on the {{ icon("edit", color="blue", title="Edit Company") }} icon in the actions menu. Edit the company information, and then click on <span class='badge inventree confirm'>Submit</span>.

docs/docs/settings/global.md

@@ -23,6 +23,7 @@ Configuration of basic server settings:
 | ---- | ----------- | ------- | ----- |
 {{ globalsetting("INVENTREE_BASE_URL") }}
 {{ globalsetting("INVENTREE_COMPANY_NAME") }}
+{{ globalsetting("INVENTREE_DEFAULT_INTERNAL_COMPANY") }}
 {{ globalsetting("INVENTREE_INSTANCE") }}
 {{ globalsetting("INVENTREE_INSTANCE_TITLE") }}
 {{ globalsetting("INVENTREE_INSTANCE_ID", default="Randomly generated value") }}