Metadata-Version: 2.1
Name: odoo-addon-odoo_instance
Version: 18.0.1.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-contract==18.0.*
Requires-Dist: odoo-addon-helpdesk_mgmt==18.0.*
Requires-Dist: odoo-addon-queue_job==18.0.*
Requires-Dist: odoo-addon-web_help==18.0.*
Requires-Dist: odoo==18.0.*
Requires-Dist: pyyaml
Summary: Manage Odoo instances with relevant information
Home-page: https://www.coopdevs.org
License: AGPL-3
Author: Coopdevs
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

###############
 Odoo Instance
###############

..
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:18157e50fb2fc08b090dd3565b448d97228713b78045c938e37785d0b7ef0e4b
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
   :alt: Beta
   :target: https://odoo-community.org/page/development-status

.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
   :alt: License: AGPL-3
   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html

.. |badge3| image:: https://img.shields.io/badge/github-coopdevs%2Fodoo--addons-lightgray.png?logo=github
   :alt: coopdevs/odoo-addons
   :target: https://git.coopdevs.org/coopdevs/odoo/odoo-addons/odoo-addons/-/tree/odoo-instances-18/odoo_instance

|badge1| |badge2| |badge3|

This Odoo module provides a comprehensive solution for managing project
instances, their deployment schedules, and associated components such as
processes, modules, troubleshooting documentation, project roles, server
information, and commercial data. All instances, processes, and modules
are classified by the Odoo version.

**Features**

   -  Create and manage project instances, classified by Odoo version,
      and organize them by stages.

   -  Schedule and manage deployment events for project instances,
      including the start time, duration, and description, with
      automatic calculation of the next available deployment window and
      a wizard to create calendar events.

   -  Manage processes, associate them with project instances, and track
      related modules, all classified by Odoo version.

   -  Manage odoo modules, including their name, Odoo and own version,
      and associate them with processes.

   -  Get installed modules and their versions from a requirements file.

   -  Import real runtime payloads from URL or pasted JSON and process
      them asynchronously.

   -  Track synchronization runs with status, timestamps, errors, and
      payload/summary snapshots.

   -  Compare expected Git databases vs real server databases and
      surface drift warnings.

   -  Analyze module/package inconsistencies (DB vs package, DB vs PyPI,
      missing package/module, pyenv vs requirements).

   -  Bootstrap new instances from selected processes using the
      dedicated bootstrap wizard.

   -  Auto-apply deduplicated process modules and keep highest detected
      module versions on the instance.

   -  Generate and download deployment artifacts (`requirements.txt` and
      `modules.yaml`) from instance modules.

   -  Troubleshooting tab for storing helpful documentation, such as
      postmortems, specific configurations, and more.

   -  Assign users to different project roles within each project
      instance.

   -  Display server information for each project instance.

   -  Manage commercial data related to project instances.

**Usage**

   -  For Real Payload Sync to work, install and run the server-side
      payload generator on each managed server:

         https://git.coopdevs.org/coopdevs/sysadmin/monitoring/odoo-instance-api

         This service produces the JSON payload consumed by this module.

   -  To allow a user to access this module, we must activate the
      permission. To do that, go to Settings - Users and Companies -
      Users, and select your user. Activate the checkbox "Odoo Instance
      User" and save changes.

**Table of contents**

.. contents::
   :local:

***********
 Changelog
***********

18.0.1.0.2 (2026-05-27)
=======================

**Fixes**

-  Enhance canonical package/module name normalization and alias
   generation (fix canonicalization and alias handling for package/module
   names).

**Misc**

-  Bump module version to 18.0.1.0.2.


18.0.1.0.1 (2026-05-27)
=======================

**Features**

-  Add bootstrap instance instructional video.

-  Add guided tours for instance and process management forms.

-  Add demo data for processes.

-  Improve package name handling and friendly display name
   derivation.

-  Expand OdooInstance field help text and streamline form layout for
   better clarity.


18.0.1.0.0rc1 (2026-05-18)
===========================

**Features**

-  Migration to Odoo 18.

-  Add Odoo 18 core modules app data
   (``data/odoo18_core_modules_app_data.xml``).

-  Add script (``generate_modules_data.py``) to generate XML for Odoo
   core modules directly from manifests.

-  Add Catalan and Spanish (``ca`` / ``es``) translation files and a
   full translation template (``i18n/odoo_instance.pot``).

-  Add process bootstrap wizard with state management, completion
   tracking, and HTML previews for generated ``requirements.txt`` and
   ``modules.yaml`` deployment artifacts.

-  Auto-apply process modules on created instances with
   technical-name deduplication and highest-version selection.

-  Add ``helpdesk_mgmt`` and ``mail`` to module dependencies.

**Bugfixes**

-  Use ``Markup`` for ``message_body`` in ``message_post`` calls
   (Odoo 18 requirement).

-  Fix kanban view to use ``t-out`` instead of deprecated ``t-esc``.

-  Remove password attribute from auth fields (security hardening).

-  Fix button visibility for artifact generation actions based on
   instance state.

-  Improve search in ``OdooInstanceModuleVersion`` and add active
   instance check in ``RealPayloadImportWizard``.

**Refactoring / Tooling**

-  Replace flake8 with ruff linter in pre-commit configuration.

-  Add deduplication test suite for shared modules across processes.

-  Add accessibility ``role`` attributes to alert ``div`` elements.

16.0.3.0.0 (2026-03-25)
========================

**Features**

-  Add a process bootstrap wizard to create instances directly from
   selected functional processes.

-  Auto-apply process modules on created instances with technical-name
   deduplication and highest-version selection.

-  Add generated deployment artifacts for bootstrapped instances
   (`requirements.txt` and `modules.yaml`) with metadata and
   downloadable files.

-  Add dedicated menu/action access for the bootstrap flow and include
   the wizard view in module data.

16.0.2.0.0 (2026-03-25)
=======================

**Features**

-  Add real server payload synchronization (manual JSON or URL) with
   asynchronous processing.
-  Add sync run tracking model (`odoo.instance.sync.run`) with
   payload/summary snapshots and cleanup cron.
-  Add server-focused monitoring fields on instances: sync status,
   duration, runtime python version, drift counters.
-  Add module issue analysis model (`odoo.instance.module.issue`) and
   dedicated views for update/drift categories.
-  Add database source split (`git` vs `server`) plus comparison model
   to highlight name drift.
-  Add new Odoo version seeds (17.0, 18.0, 19.0, 20.0) in version data.
-  Add Odoo 16 core modules app data file
   (`data/odoo16_core_modules_app_data.xml`).

16.0.1.0.0 (2024-07-11)
=======================

**Features**

-  Migration to Odoo 16

14.0.1.2.1 (2023-08-04)
=======================

**Features**

-  Add cron to update instances info

14.0.1.2.0 (2023-08-04)
=======================

**Features**

-  Add functional configurations section to store UI-managed
   configurations

**Misc**

-  Move 'Deploy window' configuration to 'Misc' tab

14.0.1.2.0 (2023-04-26)
=======================

**Features**

-  Manage databases

14.0.1.1.1 (2023-04-25)
=======================

**Bugfixes**

-  Upcrate module versions
-  Show installed module versions only in instance view

14.0.1.1.0 (2023-04-25)
=======================

**Features**

-  Handle odoo releases

14.0.1.0.1 (2023-04-25)
=======================

**Features**

-  Improved UX: Searches, filters, grouping...

**Bugfixes**

-  Removed forgotten debug statementes

14.0.1.0.0 (2023-04-24)
=======================

**Features**

-  Rename models and split logic in files

14.0.0.2.0 (2023-04-24)
=======================

**Features**

-  Add instance relations to project and res.partner

*************
 Bug Tracker
*************

Bugs are tracked on `GitLab Issues
<https://git.coopdevs.org/coopdevs/odoo/odoo-addons/odoo-addons/-/work_items>`_. In case of
trouble, please check there if your issue has already been reported. If
you spotted it first, help us to smash it by providing a detailed and
welcomed `feedback
<https://git.coopdevs.org/coopdevs/odoo/odoo-addons/odoo-addons/-/issues/new?issue[description]=module:%20odoo_instance%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with
technical issues.

*********
 Credits
*********

Authors
=======

-  Coopdevs

Maintainers
===========

This module is part of the `coopdevs/odoo_instance
<https://git.coopdevs.org/coopdevs/odoo/odoo-addons/odoo-addons/-/tree/18.0/odoo_instance>`_
project.

You are welcome to contribute.
