[ADD] document_page_project_task: add new module

Author: marcelsavegnago

document_page_project_task/README.rst

@@ -0,0 +1,285 @@
+==========================
+Document Page Project Task
+==========================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:792f27beb9e30e02336420e9ffafb95a1a3027dc4b2ff368b4d350c683de3b01
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Beta
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fknowledge-lightgray.png?logo=github
+    :target: https://github.com/OCA/knowledge/tree/16.0/document_page_project_task
+    :alt: OCA/knowledge
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/knowledge-16-0/knowledge-16-0-document_page_project_task
+    :alt: Translate me on Weblate
+.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
+    :target: https://runboat.odoo-community.org/builds?repo=OCA/knowledge&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+Document Page Project Task
+==========================
+
+This module extends the document page (wiki) functionality by allowing
+you to link them directly to project tasks.
+
+Main Features
+-------------
+
+- **Link Wiki Pages to Tasks**: Allows associating document pages to
+  specific project tasks
+- **Automatic Project Filling**: When a task is selected, the related
+  project is automatically filled
+- **Consistency Validation**: Ensures that the wiki page's project is
+  always the same as the linked task's project
+- **Smart Filtering**: When a project is defined, only tasks from that
+  project are displayed for selection
+- **Page Counter**: Displays the number of wiki pages linked to each
+  task directly in the task view
+
+Benefits
+--------
+
+- Organize project documentation hierarchically (Project → Task → Wiki)
+- Keep documentation close to the work context (tasks)
+- Avoid inconsistencies between projects and tasks through automatic
+  validations
+- Quickly access documentation related to a specific task
+
+Dependencies
+------------
+
+This module requires:
+
+- ``document_page_project``: Module that links document pages to
+  projects
+- ``project``: Odoo's project management module
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Configuration
+=============
+
+Configuration
+=============
+
+This module does not require additional configuration after
+installation. It works automatically once installed.
+
+Installation
+------------
+
+1. Go to the **Apps** menu
+2. Remove the "Apps" filter if necessary
+3. Search for "Document Page Project Task"
+4. Click **Install**
+
+Prerequisites
+-------------
+
+Make sure the following modules are installed:
+
+- **Project** (base project module)
+- **Document Page Project** (links wiki pages to projects)
+
+The system will automatically install the necessary dependencies during
+installation.
+
+Permissions
+-----------
+
+The module uses the same access permissions as the base modules:
+
+- Users with access to **Projects** can view and create wiki pages
+  linked to tasks
+- Users with access to **Documents/Knowledge** can manage wiki page
+  content
+
+No additional permission configuration is required.
+
+Usage
+=====
+
+How to Use
+==========
+
+This guide explains how to use the Document Page Project Task module to
+link wiki pages to project tasks.
+
+Create a Wiki Page from a Task
+------------------------------
+
+Method 1: From the Task
+~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Go to the **Projects** module
+2. Open the desired project
+3. Select a task
+4. In the task view, locate the **Wiki Pages** button (book icon)
+5. Click the button to see linked pages or create a new one
+6. Click **Create** to add a new wiki page
+7. The task and project will be automatically filled
+
+Method 2: From the Wiki Page
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Go to the **Knowledge** or **Documents** module
+2. Create a new wiki page or edit an existing one
+3. In the page form, you will see the fields:
+
+   - **Project**: Select the project
+   - **Task**: Select the task (only tasks from the selected project
+     will be displayed)
+
+4. When you select a task, the project will be automatically filled
+5. Save the page
+
+Automatic Behaviors
+-------------------
+
+Automatic Project Filling
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When you select a task:
+
+- The **Project** field is automatically filled with the task's project
+- This ensures consistency between task and project
+
+Task Filtering
+~~~~~~~~~~~~~~
+
+When a project is selected:
+
+- Only tasks from that project appear in the selection list
+- This prevents selecting tasks from different projects
+
+Consistency Validation
+~~~~~~~~~~~~~~~~~~~~~~
+
+The system automatically validates that:
+
+- If a task is linked, the project must also be defined
+- The wiki page's project must be the same as the linked task's project
+- If you try to link a task to a different project, the system will
+  prevent the operation
+
+Automatic Cleanup
+~~~~~~~~~~~~~~~~~
+
+When you change the project:
+
+- If the linked task does not belong to the new project, it is
+  automatically removed
+- This maintains data consistency
+
+View Wiki Pages of a Task
+-------------------------
+
+1. Access a project task
+2. At the top of the form, you will see the **Wiki Pages** button with a
+   counter
+3. The displayed number indicates how many wiki pages are linked to the
+   task
+4. Click the button to see all linked pages
+
+Usage Examples
+--------------
+
+Example 1: Requirements Documentation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Create a task "Define System Requirements"
+2. From the task, create a wiki page "Functional Requirements"
+3. Document the requirements in the wiki page
+4. The page will be linked to the task and project
+
+Example 2: Meeting Notes
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Create a task "Planning Meeting"
+2. Create a wiki page "Meeting Minutes"
+3. Document the discussed points
+4. The documentation will be organized and easy to find
+
+Example 3: Technical Specifications
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+1. Create a task "Develop Module X"
+2. Create a wiki page "Technical Specification"
+3. Document the architecture and technical decisions
+4. Keep the documentation close to the task work
+
+Tips
+----
+
+- Use wiki pages to maintain contextual documentation related to
+  specific tasks
+- The page counter on the task helps quickly identify tasks with
+  documentation
+- When creating a page from the task, fields are automatically filled,
+  saving time
+- Organize project documentation hierarchically: Project → Task → Wiki
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/knowledge/issues>`_.
+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://github.com/OCA/knowledge/issues/new?body=module:%20document_page_project_task%0Aversion:%2016.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
+-------
+
+* Escodoo
+
+Contributors
+------------
+
+- `ESCODOO <https://escodoo.com.br>`__:
+
+  - Marcel Savegnago <marcel.savegnago@escodoo.com.br>
+
+Maintainers
+-----------
+
+This module is maintained by the OCA.
+
+.. image:: https://odoo-community.org/logo.png
+   :alt: Odoo Community Association
+   :target: https://odoo-community.org
+
+OCA, or the Odoo Community Association, is a nonprofit organization whose
+mission is to support the collaborative development of Odoo features and
+promote its widespread use.
+
+.. |maintainer-marcelsavegnago| image:: https://github.com/marcelsavegnago.png?size=40px
+    :target: https://github.com/marcelsavegnago
+    :alt: marcelsavegnago
+
+Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
+
+|maintainer-marcelsavegnago| 
+
+This module is part of the `OCA/knowledge <https://github.com/OCA/knowledge/tree/16.0/document_page_project_task>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

document_page_project_task/__init__.py

@@ -0,0 +1 @@
+from . import models

document_page_project_task/__manifest__.py

@@ -0,0 +1,16 @@
+# Copyright 2025 Escodoo <https://escodoo.com.br>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Document Page Project Task",
+    "summary": "This module links document pages to project tasks",
+    "version": "16.0.1.0.0",
+    "category": "Project",
+    "author": "Escodoo,Odoo Community Association (OCA)",
+    "maintainers": ["marcelsavegnago"],
+    "website": "https://github.com/OCA/knowledge",
+    "license": "AGPL-3",
+    "depends": ["document_page_project"],
+    "data": ["views/document_page_views.xml", "views/project_task_views.xml"],
+    "installable": True,
+}

document_page_project_task/models/__init__.py

@@ -0,0 +1,2 @@
+from . import document_page
+from . import project_task

document_page_project_task/models/document_page.py

@@ -0,0 +1,67 @@
+# Copyright 2025 Marcel Savegnago - Escodoo <https://escodoo.com.br>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+
+from odoo import _, api, fields, models
+from odoo.exceptions import ValidationError
+
+
+class DocumentPage(models.Model):
+    _inherit = "document.page"
+
+    task_id = fields.Many2one(string="Task", comodel_name="project.task")
+
+    @api.onchange("task_id")
+    def _onchange_task_id(self):
+        """Fill the project_id field with the task's related project."""
+        if self.task_id and self.task_id.project_id:
+            self.project_id = self.task_id.project_id
+
+    @api.onchange("project_id")
+    def _onchange_project_id(self):
+        """Clear the task if the project is removed or changed and does not
+        match the task's project."""
+        if self.task_id:
+            if not self.project_id or self.task_id.project_id != self.project_id:
+                self.task_id = False
+
+    @api.constrains("task_id", "project_id")
+    def _check_task_project_consistency(self):
+        """Ensure that the project is the same as the task's project when a
+        task is defined."""
+        for record in self:
+            # If there is a task, there must be a project
+            if record.task_id and not record.project_id:
+                raise ValidationError(
+                    _(
+                        "When a task is linked, the project must be defined. "
+                        "Task '%(task)s' requires that the project be defined.",
+                        task=record.task_id.name,
+                    )
+                )
+            # If there is a task and project, they must be from the same project
+            if record.task_id and record.project_id:
+                if record.task_id.project_id != record.project_id:
+                    raise ValidationError(
+                        _(
+                            "The wiki document's project must be the same as the "
+                            "task's project. Task '%(task)s' belongs to project "
+                            "'%(task_project)s', but the document is associated "
+                            "with project '%(doc_project)s'.",
+                            task=record.task_id.name,
+                            task_project=record.task_id.project_id.name,
+                            doc_project=record.project_id.name,
+                        )
+                    )
+
+    @api.model
+    def default_get(self, fields_list):
+        """Fill the project_id when the wiki is created with default_task_id
+        in the context."""
+        res = super().default_get(fields_list)
+        if "default_task_id" in self.env.context and "project_id" in fields_list:
+            task = self.env["project.task"].browse(
+                self.env.context.get("default_task_id")
+            )
+            if task.exists() and task.project_id:
+                res["project_id"] = task.project_id.id
+        return res

document_page_project_task/models/project_task.py

@@ -0,0 +1,17 @@
+# Copyright 2025 Marcel Savegnago - Escodoo <https://escodoo.com.br>
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+
+from odoo import fields, models
+
+
+class ProjectTask(models.Model):
+    _inherit = "project.task"
+
+    document_page_ids = fields.One2many(
+        string="Wiki Pages", comodel_name="document.page", inverse_name="task_id"
+    )
+    document_page_count = fields.Integer(compute="_compute_document_page_count")
+
+    def _compute_document_page_count(self):
+        for rec in self:
+            rec.document_page_count = len(rec.document_page_ids)