Backend development

Module structure

The backend is a single consolidated Odoo 12 addon:

Module	Depends on	Purpose
`nu_restaurant_pos`	`point_of_sale`, `pos_restaurant`, `dgii_pos`, `dgii_encf`	Core POS API, models, voids, side dishes, discounts, printing, presentations, special requests

API gateway

All endpoints live under /pos-api/v1/* in controllers/api_v1.py. The gateway handles:

JWT Bearer token validation
CORS headers
Request routing to legacy controller methods

The legacy controller methods in api.py, api_orders.py, etc. have no routes of their own — they are called by api_v1.py.

Extending bootstrap data

To add data to the bootstrap payload, extend the pos.config model:

class PosConfig(models.Model):
    _inherit = 'pos.config'

    def _get_bootstrap_extra(self, user):
        result = super()._get_bootstrap_extra(user)
        result['my_new_data'] = self._get_my_data()
        return result

Do not try to use controller inheritance — it does not work reliably in Odoo 12 for internal methods. Use model inheritance (_inherit) instead.

Upgrading modules

./odoo-bin -d <db> -u nu_restaurant_pos \
  --addons-path=addons,extra_addons --stop-after-init

Migrations

Version-specific migration scripts go in migrations/<version>/pre-migrate.py or post-migrate.py. The <version> must match the new version in __manifest__.py.

Declarative configuration

Backend POS configuration (printers, print routes, discount presets, void reasons, special-request tags, side-dish groups, picking-sale reasons, shared configs, and per-terminal nu_* fields) is managed declaratively via the JSON config sync loader. The most recently applied document is replayed automatically on module install and upgrade.

Permissions

The permission system has three layers resolved in order:

Factory defaults — permission_registry.py PERMISSION_DEFAULTS
Per-config role overrides — nu.pos.permission.config model
Per-user grant/deny — nu.pos.permission.user.override model

Permission models should be writable only by base.group_system (admin). Managers should not be able to self-grant privileges.

Adding a new permission

Add the key and default to PERMISSION_DEFAULTS in permission_registry.py
Mirror the same key and default in permissions.ts on the frontend
Both files must stay in sync

Getting started

Development

Features

Reference

Backend development

Module structure

API gateway

Extending bootstrap data

Upgrading modules

Migrations

Declarative configuration

Permissions

Adding a new permission

​Module structure

​API gateway

​Extending bootstrap data

​Upgrading modules

​Migrations

​Declarative configuration

​Permissions

​Adding a new permission

Module structure

API gateway

Extending bootstrap data

Upgrading modules

Migrations

Declarative configuration

Permissions

Adding a new permission