v1.0.0 Stable

Languages

What This Option Does

Languages module manages available language packs and translation data for multilingual usage.

How Admin Uses This

  1. Open Languages list.
  2. Create/add a language or update existing language resources.
  3. Upload or edit translation data.
  4. Activate and verify text rendering in UI.

Screenshot Placeholder

Languages Screenshot Placeholder
Add screenshot file at documentaion/assets/images/backoffice-language.png

Enterprise Technical Specification

Business Capabilities

  • Language CRUD
  • Template download
  • Language JSON upload

API Contract Surface

Primary API endpoints used by this module:

  • /api/v1/backoffice/languages
  • /api/v1/backoffice/languages/template/en/download
  • /api/v1/backoffice/languages/{code}/download
  • /api/v1/backoffice/languages/upload-json

Permission Blueprint

Recommended permission keys for production role design:

  • backoffice.language.view
  • backoffice.language.create
  • backoffice.language.edit
  • backoffice.language.delete

Operational Risk and Control Notes

  • Invalid JSON breaks translations
  • Enable activity logging and include company_id, actor ID, and target entity ID in audit traces.
  • Apply least-privilege principle for create/update/delete actions.

QA Verification Checklist

  • Validate list API load, empty-state behavior, and pagination consistency.
  • Verify create/update/delete response contract (status, message, data).
  • Confirm permission denial responses for unauthorized roles.
  • Test edge inputs and invalid IDs for safe error handling.