odoo-addon-project-task-api 16.0.1.0.0__tar.gz

odoo_addon_project_task_api-16.0.1.0.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: odoo-addon-project_task_api
+Version: 16.0.1.0.0
+Summary: API module based on FastAPI to get and create project tasks from external applications
+Home-page: https://git.coopdevs.org/coopdevs/som-connexio/odoo/odoo-somconnexio
+Author: Som Connexió SCCL, Odoo Community Association (OCA)
+Author-email: support@odoo-community.org
+License: AGPL-3
+Classifier: Programming Language :: Python
+Classifier: Framework :: Odoo
+Classifier: Framework :: Odoo :: 16.0
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Requires-Python: >=3.10
+Requires-Dist: fastapi
+Requires-Dist: odoo-addon-fastapi_auth_api_key_sc<16.1dev,>=16.0dev
+Requires-Dist: odoo<16.1dev,>=16.0a
+Requires-Dist: pydantic
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+##################
+ Project Task API
+##################
+
+This module uses OCAs FAST API module for creating endpoints to get and
+create project tasks from external applications.
+
+.. note::
+
+   This module is made by and for developers.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+***************
+ Configuration
+***************
+
+As this module is based on `fastapi_auth_api_key_sc`, an API-KEY is
+required to authenticate requests. Read README from
+`fastapi_auth_api_key_sc` for more information about the user related
+API-KEY authentication.
+
+*******
+ Usage
+*******
+
+This module provides FastAPI-based endpoints of project tasks by
+extending `fastapi.endpoint`.
+
+The module registers an example model API at the following roots:
+
+-  GET: `/api/project_task/{id}`
+-  POST: `/api/project_task/`
+
+The authenticated API uses `API-KEY`
+
+************************
+ Known issues / Roadmap
+************************
+
+There are no known issues for this module.
+
+*************
+ Bug Tracker
+*************
+
+Bugs are tracked on `GitLab Issues
+<https://gitlab.com/somitcoop/erp-research/odoo-helpdesk/-/issues>`_. In
+case of trouble, please check there if your issue has already been
+reported. If you spotted it first, help us smashing it by providing a
+detailed and welcomed feedback.
+
+Do not contact contributors directly about support or help with
+technical issues.
+
+TODO: Module to be substituted by `the OCA module`_ once this ODOO is
+migrated to the 17th version or further.
+
+.. _the oca module: https://github.com/OCA/rest-framework/tree/17.0/fastapi_auth_api_key/
+
+*********
+ Credits
+*********
+
+Authors
+=======
+
+-  Som Connexio SCCL
+
+Contributors
+============
+
+-  `Som Connexio SCCL <https://somconnexio.coop>`_:
+
+      -  Gerard Funosas <gerard.funosas@somconnexio.coop>
+
+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.
+
+You are welcome to contribute. To learn how please visit
+https://odoo-community.org/page/Contribute.

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+## [16.0.1.0.0] - 2026-09-22
+### Added
+- [#1761](https://git.coopdevs.org/coopdevs/som-connexio/odoo/odoo-somconnexio/-/merge_requests/1761) Add project_task_api

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/README.rst

@@ -0,0 +1,94 @@
+##################
+ Project Task API
+##################
+
+This module uses OCAs FAST API module for creating endpoints to get and
+create project tasks from external applications.
+
+.. note::
+
+   This module is made by and for developers.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+***************
+ Configuration
+***************
+
+As this module is based on `fastapi_auth_api_key_sc`, an API-KEY is
+required to authenticate requests. Read README from
+`fastapi_auth_api_key_sc` for more information about the user related
+API-KEY authentication.
+
+*******
+ Usage
+*******
+
+This module provides FastAPI-based endpoints of project tasks by
+extending `fastapi.endpoint`.
+
+The module registers an example model API at the following roots:
+
+-  GET: `/api/project_task/{id}`
+-  POST: `/api/project_task/`
+
+The authenticated API uses `API-KEY`
+
+************************
+ Known issues / Roadmap
+************************
+
+There are no known issues for this module.
+
+*************
+ Bug Tracker
+*************
+
+Bugs are tracked on `GitLab Issues
+<https://gitlab.com/somitcoop/erp-research/odoo-helpdesk/-/issues>`_. In
+case of trouble, please check there if your issue has already been
+reported. If you spotted it first, help us smashing it by providing a
+detailed and welcomed feedback.
+
+Do not contact contributors directly about support or help with
+technical issues.
+
+TODO: Module to be substituted by `the OCA module`_ once this ODOO is
+migrated to the 17th version or further.
+
+.. _the oca module: https://github.com/OCA/rest-framework/tree/17.0/fastapi_auth_api_key/
+
+*********
+ Credits
+*********
+
+Authors
+=======
+
+-  Som Connexio SCCL
+
+Contributors
+============
+
+-  `Som Connexio SCCL <https://somconnexio.coop>`_:
+
+      -  Gerard Funosas <gerard.funosas@somconnexio.coop>
+
+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.
+
+You are welcome to contribute. To learn how please visit
+https://odoo-community.org/page/Contribute.

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/__init__.py

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

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/__manifest__.py

@@ -0,0 +1,25 @@
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl.html).
+{
+    "name": "Project Task API",
+    "version": "16.0.1.0.0",
+    "summary": """
+        API module based on FastAPI to get and create project tasks from
+        external applications
+    """,
+    "depends": ["fastapi_auth_api_key_sc", "project"],
+    "author": """
+        Som Connexió SCCL,
+        Odoo Community Association (OCA)
+    """,
+    "category": "API",
+    "website": "https://git.coopdevs.org/coopdevs/som-connexio/odoo/odoo-somconnexio",
+    "license": "AGPL-3",
+    "data": [
+        "data/fastapi_endpoint.xml",
+        "views/project_project_view.xml",
+    ],
+    "demo": [],
+    "external_dependencies": {"python": ["pydantic", "fastapi"]},
+    "application": False,
+    "installable": True,
+}

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/data/fastapi_endpoint.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <record id="fastapi_project_task_endpoint" model="fastapi.endpoint">
+        <field name="name">FastAPi Project Task Endpoint</field>
+        <field name="description">Project task endpoint</field>
+        <field name="app">fastapi_project_task</field>
+        <field name="root_path">/api</field>
+        <field name="user_id" ref="fastapi_auth_api_key_sc.fastapi_service_user"/>
+    </record>
+</odoo>

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/models/__init__.py

@@ -0,0 +1,4 @@
+from . import (
+    fastapi_endpoint,
+    project_project,
+)

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/models/fastapi_endpoint.py

@@ -0,0 +1,17 @@
+from odoo import fields, models
+
+from ..routers.project_task_router import project_task_router
+
+
+class FastapiEndpoint(models.Model):
+    _inherit = "fastapi.endpoint"
+
+    app = fields.Selection(
+        selection_add=[("fastapi_project_task", "FastAPi Project Task")],
+        ondelete={"fastapi_project_task": "cascade"},
+    )
+
+    def _get_fastapi_routers(self):
+        if self.app == "fastapi_project_task":
+            return [project_task_router]
+        return super()._get_fastapi_routers()

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/models/project_project.py

@@ -0,0 +1,11 @@
+from odoo import fields, models
+
+
+class ProjectProject(models.Model):
+    _inherit = "project.project"
+
+    code = fields.Char(string="Code")
+
+    sql_constraints = [
+        ("code_uniq", "UNIQUE(code)", "The code must be unique across all projects.")
+    ]

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/routers/__init__.py

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

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/routers/project_task_router.py

@@ -0,0 +1,211 @@
+from typing import Annotated, List
+from fastapi import APIRouter, Depends, HTTPException, status
+
+from odoo.addons.base.models.res_partner import Partner
+from odoo.api import Environment
+from odoo.addons.fastapi.dependencies import odoo_env
+
+from odoo.addons.fastapi_auth_api_key_sc.dependencies import (
+    authenticated_partner_by_api_key,
+    serialize_record,
+)
+from ..schemas.project_task import (
+    ProjectTaskCreatePayload,
+    ProjectTaskPresenter,
+    ProjectTaskUpdatePayload,
+)
+
+project_task_router = APIRouter()
+
+
+def get_partner_by_ref(env, ref):
+    partner = (
+        env["res.partner"]
+        .sudo()
+        .search(
+            [
+                ("parent_id", "=", False),
+                ("ref", "=", ref),
+            ],
+            limit=1,
+        )
+    )
+    if not partner.exists():
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Partner with ref {} not found".format(ref),
+        )
+    return partner
+
+
+def get_project_by_code(env, code):
+    project = env["project.project"].sudo().search([("code", "=", code)])
+    if not project:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Project record with code {} not found".format(code),
+        )
+    return project
+
+
+@project_task_router.get("/project_tasks", response_model=List[ProjectTaskPresenter])
+def list_project_tasks(
+    partner: Annotated[Partner, Depends(authenticated_partner_by_api_key)],
+    env: Annotated[Environment, Depends(odoo_env)],
+    partner_ref: str | None = None,
+    project_id: int | None = None,
+    partner_phone: str | None = None,
+) -> ProjectTaskPresenter:
+    if not partner_ref and not project_id and not partner_phone:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail="At least one of the following query parameters must be provided: partner_ref, project_id, partner_phone",  # noqa E501
+        )
+
+    domain = []
+    if partner_ref:
+        partner = get_partner_by_ref(env, partner_ref)
+        domain += [("partner_id", "=", partner.id)]
+    if project_id:
+        domain += [("project_id", "=", project_id)]
+    if partner_phone:
+        domain += [("partner_phone", "=", partner_phone)]
+
+    records = env["project.task"].sudo().search(domain)
+    if not records:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Project task record not found",
+        )
+    return [serialize_record(record, ProjectTaskPresenter) for record in records]
+
+
+@project_task_router.post(
+    "/project_tasks",
+    response_model=ProjectTaskPresenter,
+    status_code=status.HTTP_201_CREATED,
+)
+def create_project_task(
+    partner: Annotated[Partner, Depends(authenticated_partner_by_api_key)],
+    env: Annotated[Environment, Depends(odoo_env)],
+    payload: ProjectTaskCreatePayload,
+) -> ProjectTaskPresenter:
+    params = {k: v for k, v in payload.model_dump().items() if v is not None}
+    if params.get("partner_ref"):
+        partner = get_partner_by_ref(env, params["partner_ref"])
+        if not partner.exists():
+            raise HTTPException(
+                status_code=status.HTTP_404_NOT_FOUND,
+                detail="Partner record with code {} found".format(
+                    params["partner_ref"]
+                ),
+            )
+    project = get_project_by_code(env, params["project_code"])
+    params.pop("partner_ref", None)
+    params.pop("project_code", None)
+    params.update(
+        {
+            "partner_id": partner.id,
+            "project_id": project.id,
+        }
+    )
+
+    if params.get("properties"):
+        project_properties = project.task_properties_definition
+        project_properties_names = [prop["name"] for prop in project_properties]
+        unknown_properties = set(params["properties"]) - set(project_properties_names)
+        if unknown_properties:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="Unknown property {} for this task: {}".format(
+                    "y" if len(unknown_properties) == 1 else "ies",
+                    ", ".join(sorted(unknown_properties)),
+                ),
+            )
+        params["task_properties"] = params["properties"]
+        del params["properties"]
+
+    try:
+        record = env["project.task"].sudo().create(params)
+    except Exception as exc:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=str(exc),
+        ) from exc
+    return serialize_record(record, ProjectTaskPresenter)
+
+
+@project_task_router.get(
+    "/project_tasks/{record_id}", response_model=ProjectTaskPresenter
+)
+def get_project_task(
+    partner: Annotated[Partner, Depends(authenticated_partner_by_api_key)],
+    env: Annotated[Environment, Depends(odoo_env)],
+    record_id: int,
+) -> ProjectTaskPresenter:
+    record = env["project.task"].sudo().browse(record_id)
+    if not record.exists():
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Project task record with id {} not found".format(record_id),
+        )
+    return serialize_record(record, ProjectTaskPresenter)
+
+
+@project_task_router.put(
+    "/project_tasks/{record_id}", response_model=ProjectTaskPresenter
+)
+def update_project_task(
+    partner: Annotated[Partner, Depends(authenticated_partner_by_api_key)],
+    env: Annotated[Environment, Depends(odoo_env)],
+    record_id: int,
+    payload: ProjectTaskUpdatePayload,
+) -> ProjectTaskPresenter:
+    record = env["project.task"].sudo().browse(record_id)
+    if not record.exists():
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail="Project task record with id {} not found".format(record_id),
+        )
+
+    params = {
+        k: v
+        for k, v in payload.model_dump().items()
+        if v is not None and k != "properties"
+    }
+
+    if params.get("partner_ref"):
+        partner_record = get_partner_by_ref(env, params.pop("partner_ref"))
+        params["partner_id"] = partner_record.id
+        params.pop("partner_ref", None)
+
+    if params.get("project_code"):
+        project = get_project_by_code(env, params.pop("project_code"))
+        params["project_id"] = project.id
+        params.pop("project_code", None)
+
+    if payload.properties:
+        current_properties = {
+            prop["name"]: prop["value"] for prop in record.task_properties or []
+        }
+        unknown_properties = set(payload.properties) - set(current_properties)
+        if unknown_properties:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail="Unknown property {} for this task: {}".format(
+                    "y" if len(unknown_properties) == 1 else "ies",
+                    ", ".join(sorted(unknown_properties)),
+                ),
+            )
+        current_properties.update(payload.properties)
+        params["task_properties"] = current_properties
+
+    try:
+        record.write(params)
+    except Exception as exc:
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail=str(exc),
+        ) from exc
+
+    return serialize_record(record, ProjectTaskPresenter)

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/schemas/__init__.py

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

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/schemas/common.py

@@ -0,0 +1,7 @@
+from typing import Literal, Annotated
+from pydantic import Field
+
+
+PositiveInt = Annotated[int, Field(gt=0)]
+PriorityType = Literal["0", "1"]
+KanbanStateType = Literal["normal", "done", "blocked"]

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/schemas/project_task.py

@@ -0,0 +1,190 @@
+from datetime import date
+from typing import Any, Dict, List, Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from .common import PriorityType, KanbanStateType, PositiveInt
+
+
+class ProjectTaskCreatePayload(BaseModel):
+    """
+    Output contract for project.task (Odoo ORM response).
+    """
+
+    name: str = Field(..., description="Task title (required in Odoo).")
+
+    project_code: str = Field(..., description="Project code (required).")
+
+    description: Optional[str] = Field(None, description="Internal task description.")
+
+    priority: Optional[PriorityType] = Field(
+        None, description="Priority (Odoo: '0' Low → '1' High)."
+    )
+
+    partner_ref: Optional[str] = Field(None, description="Assigned partner REF.")
+
+    partner_phone: Optional[str] = Field(None, description="Phone number.")
+
+    partner_email: Optional[str] = Field(None, description="Email address.")
+
+    stage_id: Optional[int] = Field(None, gt=0, description="Kanban stage ID.")
+
+    date_deadline: Optional[date] = Field(
+        None, description="Deadline date (ISO format)."
+    )
+
+    tag_ids: Optional[List[PositiveInt]] = Field(
+        None, description="List of tag IDs associated with the task."
+    )
+
+    properties: Optional[Dict[str, Any]] = Field(
+        None,
+        description=(
+            "Values for the task's properties (Odoo Properties feature), "
+            "keyed by property name. Property names must already be defined "
+            "on the task's project."
+        ),
+    )
+
+    model_config = ConfigDict(
+        extra="forbid",
+        str_strip_whitespace=True,
+        json_schema_extra={
+            "example": {
+                "name": "Implement authentication",
+                "project_code": "code",
+                "description": "some text",
+                "priority": "1",
+                "partner_ref": "1234",
+                "partner_phone": "123456789",
+                "partner_email": "hello@hello.com",
+                "tag_ids": [1, 2],
+                "date_deadline": "2026-05-01",
+                "properties": {"color": "red"},
+            }
+        },
+    )
+
+
+class ProjectTaskUpdatePayload(BaseModel):
+    """
+    Input contract to partially update a project.task record.
+    """
+
+    name: Optional[str] = Field(None, description="Task title.")
+
+    project_code: Optional[str] = Field(None, description="Project code.")
+
+    description: Optional[str] = Field(None, description="Internal task description.")
+
+    priority: Optional[PriorityType] = Field(
+        None, description="Priority (Odoo: '0' Low → '1' High)."
+    )
+
+    partner_ref: Optional[str] = Field(None, description="Assigned partner REF.")
+
+    partner_phone: Optional[str] = Field(None, description="Phone number.")
+
+    partner_email: Optional[str] = Field(None, description="Email address.")
+
+    stage_id: Optional[int] = Field(None, gt=0, description="Kanban stage ID.")
+
+    date_deadline: Optional[date] = Field(
+        None, description="Deadline date (ISO format)."
+    )
+
+    tag_ids: Optional[List[PositiveInt]] = Field(
+        None, description="List of tag IDs associated with the task."
+    )
+
+    properties: Optional[Dict[str, Any]] = Field(
+        None,
+        description=(
+            "Values for the task's properties (Odoo Properties feature), "
+            "keyed by property name. Property names must already be defined "
+            "on the task's project."
+        ),
+    )
+
+    model_config = ConfigDict(
+        extra="forbid",
+        str_strip_whitespace=True,
+        json_schema_extra={
+            "example": {
+                "name": "Implement authentication",
+                "description": "some text",
+                "priority": "1",
+                "partner_phone": "123456789",
+                "partner_email": "hello@hello.com",
+                "tag_ids": [1, 2],
+                "date_deadline": "2026-05-01",
+                "properties": {"color": "red"},
+            }
+        },
+    )
+
+
+class ProjectTaskPresenter(BaseModel):
+    """
+    Output contract for project.task (Odoo ORM response).
+    """
+
+    id: int = Field(..., description="Task ID")
+
+    name: str = Field(..., description="Task title")
+
+    description: Optional[str] = Field(None, description="Task description")
+
+    project_id: int = Field(..., description="Project ID")
+
+    partner_phone: Optional[str] = Field(None, description="Phone number")
+
+    partner_email: Optional[str] = Field(None, description="Email address")
+
+    priority: PriorityType = Field(None, description="Priority level")
+
+    kanban_state: KanbanStateType = Field(None, description="Kanban state")
+
+    partner_id: Optional[int] = Field(None, description="Partner ID")
+
+    stage_id: Optional[int] = Field(None, description="Stage id")
+
+    date_deadline: Optional[date] = Field(None, description="Deadline")
+
+    tag_ids: List[PositiveInt] = Field(
+        None, description="List of tag IDs associated with the task."
+    )
+
+    task_properties: Optional[List[Dict[str, Any]]] = Field(
+        None,
+        description=(
+            "Values for the task's properties (Odoo Properties feature), "
+            "keyed by property name"
+        ),
+    )
+
+    sequence: int = Field(None, description="Ordering index")
+
+    model_config = ConfigDict(
+        from_attributes=True,
+        extra="ignore",
+        json_schema_extra={
+            "example": {
+                "id": 12,
+                "name": "Implement authentication",
+                "description": "OAuth2 integration",
+                "project_code": "2",
+                "priority": "3",
+                "kanban_state": "normal",
+                "partner_ref": "1234",
+                "partner_name": "Emma",
+                "partner_phone": "123456789",
+                "partner_email": "hello@hello.com",
+                "stage": "new",
+                "date_deadline": "2026-05-01",
+                "tags": [1, 2],
+                "sequence": 10,
+                "task_properties": {"color": "red"},
+            }
+        },
+    )

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/tests/__init__.py

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

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/tests/test_fastapi_endpoint.py

@@ -0,0 +1,283 @@
+from fastapi import status
+
+from odoo.addons.fastapi_auth_api_key_sc.tests.common import APICommonBaseFastAPICase
+from ..routers.project_task_router import project_task_router
+
+
+class TestFastAPiEndpoint(APICommonBaseFastAPICase):
+    @classmethod
+    def setUpClass(cls) -> None:
+        super().setUpClass()
+        cls.default_fastapi_router = project_task_router
+        cls.default_fastapi_running_user = cls.env.ref(
+            "fastapi_auth_api_key_sc.fastapi_service_user"
+        )
+
+    def setUp(self):
+        super().setUp()
+        self.project_task = self.env.ref("project.project_1_task_1")
+        self.url = "project_tasks"
+        self.partner = self.env.ref("base.res_partner_12")
+        self.partner.ref = "TEST_REF"
+        self.project_task.partner_id = self.partner
+
+    def test_project_task_get(self):
+        """
+        Test the GET /project_task/{record_id} endpoint to retrieve
+        a project task by its ID.
+        """
+        with self._create_test_client() as test_client:
+            response = test_client.get(
+                f"/{self.url}/{self.project_task.id}", headers=self.api_key_headers()
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertIsInstance(response.json(), dict)
+        self.assertEqual(response.json()["id"], self.project_task.id)
+
+    def test_project_task_search_project_id(self):
+        """
+        Test the GET /project_task/search endpoint can search by project_id
+        retrieving a list of all the project tasks from the given project.
+        """
+        project = self.project_task.project_id
+
+        with self._create_test_client() as test_client:
+            response = test_client.get(
+                f"/{self.url}?project_id={project.id}",
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertIsInstance(response.json(), list)
+        self.assertEqual(len(response.json()), len(project.tasks))
+        self.assertIn(self.project_task.id, [task["id"] for task in response.json()])
+
+    def test_project_task_search_partner_ref(self):
+        """
+        Test the GET /project_task/search endpoint can search by both project_id
+        and partner_ref retrieving a list of all the project tasks from the given
+        project and partner.
+        """
+
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.get(
+                "/{}?project_id={}&partner_ref={}".format(
+                    self.url,
+                    self.project_task.project_id.id,
+                    self.project_task.partner_id.ref,
+                ),
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertIsInstance(response.json(), list)
+        self.assertEqual(len(response.json()), 1)
+        self.assertEqual(response.json()[0]["id"], self.project_task.id)
+
+    def test_project_task_search_partner_phone(self):
+        """
+        Test the GET /project_task/search endpoint can search by partner_phone
+        retrieving a list of all the project tasks from the given partner.
+        """
+        self.project_task.partner_phone = "699696969"
+
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.get(
+                "/{}?project_id={}&partner_phone={}".format(
+                    self.url,
+                    self.project_task.project_id.id,
+                    self.project_task.partner_phone,
+                ),
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        self.assertIsInstance(response.json(), list)
+        self.assertEqual(len(response.json()), 1)
+        self.assertEqual(response.json()[0]["id"], self.project_task.id)
+
+    def test_project_task_search_without_params(self):
+        """
+        Test the GET /project_task/search endpoint returns an error if
+        not called by none of the params project_id or partner_ref or partner_phone.
+        """
+        with self._create_test_client() as test_client:
+            response = test_client.get(f"/{self.url}", headers=self.api_key_headers())
+
+        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+        self.assertIsInstance(response.json(), dict)
+        self.assertEqual(
+            response.json()["detail"],
+            "At least one of the following query parameters must be provided: partner_ref, project_id, partner_phone",  # noqa: E501
+        )
+
+    def test_project_task_create(self):
+        """
+        Test the POST /project_task endpoint creates a new project task.
+        """
+        code = "TESTCODE"
+        self.project_task.project_id.code = code
+        payload = {
+            "name": "Implement authentication",
+            "project_code": code,
+            "priority": "1",
+            "partner_ref": self.project_task.partner_id.ref,
+            "tag_ids": [1, 2],
+            "date_deadline": "2026-05-01",
+        }
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.post(
+                f"/{self.url}", json=payload, headers=self.api_key_headers()
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+        created = response.json()
+        self.assertEqual(created["name"], payload["name"])
+        self.assertEqual(created["project_id"], self.project_task.project_id.id)
+        self.assertEqual(created["priority"], payload["priority"])
+        self.assertEqual(created["tag_ids"], payload["tag_ids"])
+        self.assertEqual(created["date_deadline"], payload["date_deadline"])
+
+    def test_project_task_create_with_properties(self):
+        """
+        Test the POST /project_tasks endpoint creates a project task with
+        properties.
+        """
+        code = "TESTCODE"
+        self.project_task.project_id.code = code
+        self.project_task.project_id.task_properties_definition = [
+            {"name": "color", "string": "Color", "type": "char"},
+            {"name": "size", "string": "Size", "type": "char"},
+        ]
+
+        payload = {
+            "name": "Implement authentication",
+            "project_code": code,
+            "partner_ref": self.project_task.partner_id.ref,
+            "properties": {"color": "red", "size": "large"},
+        }
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.post(
+                f"/{self.url}", json=payload, headers=self.api_key_headers()
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+        created = response.json()
+        self.assertEqual(created["task_properties"][0]["name"], "color")
+        self.assertEqual(
+            created["task_properties"][0]["value"], payload["properties"]["color"]
+        )
+        self.assertEqual(created["task_properties"][1]["name"], "size")
+        self.assertEqual(
+            created["task_properties"][1]["value"], payload["properties"]["size"]
+        )
+
+    def test_project_task_create_project_code_not_found(self):
+        """
+        Test the POST /project_tasks endpoint returns a 404 error when no
+        project carries the given project_code.
+        """
+        code = "MISSINGCODE"
+        payload = {
+            "name": "Implement authentication",
+            "project_code": code,
+            "partner_ref": self.project_task.partner_id.ref,
+        }
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.post(
+                f"/{self.url}", json=payload, headers=self.api_key_headers()
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+        self.assertEqual(
+            response.json()["detail"],
+            "Project record with code {} not found".format(code),
+        )
+
+    def test_project_task_update(self):
+        """
+        Test the PUT /project_task/{record_id} endpoint updates a project
+        task's regular fields.
+        """
+        payload = {"name": "Updated task name", "priority": "1"}
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.put(
+                f"/{self.url}/{self.project_task.id}",
+                json=payload,
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        updated = response.json()
+        self.assertEqual(updated["name"], payload["name"])
+        self.assertEqual(updated["priority"], payload["priority"])
+        self.assertEqual(self.project_task.name, payload["name"])
+
+    def test_project_task_update_properties(self):
+        """
+        Test the PUT /project_task/{record_id} endpoint saves the given
+        properties while keeping the ones not sent untouched.
+        """
+        self.project_task.project_id.task_properties_definition = [
+            {"name": "esim_activation_code", "string": "Urgent", "type": "char"},
+            {"name": "notes", "string": "Notes", "type": "char"},
+        ]
+        self.project_task.task_properties = {
+            "esim_activation_code": False,
+            "notes": "old note",
+        }
+        payload = {"properties": {"esim_activation_code": "hello@hello.com"}}
+
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.put(
+                f"/{self.url}/{self.project_task.id}",
+                json=payload,
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_200_OK)
+        properties = {
+            prop["name"]: prop["value"] for prop in self.project_task.task_properties
+        }
+        self.assertEqual(
+            properties["esim_activation_code"],
+            payload["properties"]["esim_activation_code"],
+        )
+        self.assertEqual(properties["notes"], "old note")
+
+    def test_project_task_update_unknown_property(self):
+        """
+        Test the PUT /project_task/{record_id} endpoint returns a 400 error
+        when a property is not defined on the task's project.
+        """
+        self.project_task.project_id.task_properties_definition = [
+            {"name": "urgent", "string": "Urgent", "type": "boolean"},
+        ]
+        self.project_task.task_properties = {"urgent": False}
+
+        payload = {"properties": {"unknown_prop": True}}
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.put(
+                f"/{self.url}/{self.project_task.id}",
+                json=payload,
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+        self.assertIn("unknown_prop", response.json()["detail"])
+
+    def test_project_task_update_not_found(self):
+        """
+        Test the PUT /project_task/{record_id} endpoint returns a 404 error
+        when the project task does not exist.
+        """
+        payload = {"name": "Updated task name"}
+        with self._create_test_client(env=self.env) as test_client:
+            response = test_client.put(
+                f"/{self.url}/999999",
+                json=payload,
+                headers=self.api_key_headers(),
+            )
+
+        self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)

odoo_addon_project_task_api-16.0.1.0.0/odoo/addons/project_task_api/views/project_project_view.xml

@@ -0,0 +1,14 @@
+<odoo>
+    <data>
+        <record id="view_project_form_inherit" model="ir.ui.view">
+            <field name="name">project.project.form.inherit</field>
+            <field name="model">project.project</field>
+            <field name="inherit_id" ref="project.edit_project"/>
+            <field name="arch" type="xml">
+                <field name ="user_id" position="before">
+                    <field name="code"/>
+                </field>
+            </field>
+        </record>
+    </data>
+</odoo>

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: odoo-addon-project_task_api
+Version: 16.0.1.0.0
+Summary: API module based on FastAPI to get and create project tasks from external applications
+Home-page: https://git.coopdevs.org/coopdevs/som-connexio/odoo/odoo-somconnexio
+Author: Som Connexió SCCL, Odoo Community Association (OCA)
+Author-email: support@odoo-community.org
+License: AGPL-3
+Classifier: Programming Language :: Python
+Classifier: Framework :: Odoo
+Classifier: Framework :: Odoo :: 16.0
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Requires-Python: >=3.10
+Requires-Dist: fastapi
+Requires-Dist: odoo-addon-fastapi_auth_api_key_sc<16.1dev,>=16.0dev
+Requires-Dist: odoo<16.1dev,>=16.0a
+Requires-Dist: pydantic
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+##################
+ Project Task API
+##################
+
+This module uses OCAs FAST API module for creating endpoints to get and
+create project tasks from external applications.
+
+.. note::
+
+   This module is made by and for developers.
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+***************
+ Configuration
+***************
+
+As this module is based on `fastapi_auth_api_key_sc`, an API-KEY is
+required to authenticate requests. Read README from
+`fastapi_auth_api_key_sc` for more information about the user related
+API-KEY authentication.
+
+*******
+ Usage
+*******
+
+This module provides FastAPI-based endpoints of project tasks by
+extending `fastapi.endpoint`.
+
+The module registers an example model API at the following roots:
+
+-  GET: `/api/project_task/{id}`
+-  POST: `/api/project_task/`
+
+The authenticated API uses `API-KEY`
+
+************************
+ Known issues / Roadmap
+************************
+
+There are no known issues for this module.
+
+*************
+ Bug Tracker
+*************
+
+Bugs are tracked on `GitLab Issues
+<https://gitlab.com/somitcoop/erp-research/odoo-helpdesk/-/issues>`_. In
+case of trouble, please check there if your issue has already been
+reported. If you spotted it first, help us smashing it by providing a
+detailed and welcomed feedback.
+
+Do not contact contributors directly about support or help with
+technical issues.
+
+TODO: Module to be substituted by `the OCA module`_ once this ODOO is
+migrated to the 17th version or further.
+
+.. _the oca module: https://github.com/OCA/rest-framework/tree/17.0/fastapi_auth_api_key/
+
+*********
+ Credits
+*********
+
+Authors
+=======
+
+-  Som Connexio SCCL
+
+Contributors
+============
+
+-  `Som Connexio SCCL <https://somconnexio.coop>`_:
+
+      -  Gerard Funosas <gerard.funosas@somconnexio.coop>
+
+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.
+
+You are welcome to contribute. To learn how please visit
+https://odoo-community.org/page/Contribute.

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/SOURCES.txt

@@ -0,0 +1,24 @@
+setup.py
+odoo/addons/project_task_api/CHANGELOG.md
+odoo/addons/project_task_api/README.rst
+odoo/addons/project_task_api/__init__.py
+odoo/addons/project_task_api/__manifest__.py
+odoo/addons/project_task_api/data/fastapi_endpoint.xml
+odoo/addons/project_task_api/models/__init__.py
+odoo/addons/project_task_api/models/fastapi_endpoint.py
+odoo/addons/project_task_api/models/project_project.py
+odoo/addons/project_task_api/routers/__init__.py
+odoo/addons/project_task_api/routers/project_task_router.py
+odoo/addons/project_task_api/schemas/__init__.py
+odoo/addons/project_task_api/schemas/common.py
+odoo/addons/project_task_api/schemas/project_task.py
+odoo/addons/project_task_api/static/description/icon.png
+odoo/addons/project_task_api/tests/__init__.py
+odoo/addons/project_task_api/tests/test_fastapi_endpoint.py
+odoo/addons/project_task_api/views/project_project_view.xml
+odoo_addon_project_task_api.egg-info/PKG-INFO
+odoo_addon_project_task_api.egg-info/SOURCES.txt
+odoo_addon_project_task_api.egg-info/dependency_links.txt
+odoo_addon_project_task_api.egg-info/not-zip-safe
+odoo_addon_project_task_api.egg-info/requires.txt
+odoo_addon_project_task_api.egg-info/top_level.txt

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/requires.txt

@@ -0,0 +1,4 @@
+fastapi
+odoo-addon-fastapi_auth_api_key_sc<16.1dev,>=16.0dev
+odoo<16.1dev,>=16.0a
+pydantic

odoo_addon_project_task_api-16.0.1.0.0/odoo_addon_project_task_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+odoo

odoo_addon_project_task_api-16.0.1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

odoo_addon_project_task_api-16.0.1.0.0/setup.py

@@ -0,0 +1,6 @@
+import setuptools
+
+setuptools.setup(
+    setup_requires=['setuptools-odoo'],
+    odoo_addon=True,
+)