# Knowledge: Template Gallery

This PR will add article templates that the user can use to quickly create new articles in Knowledge. This new feature will greatly improve the onboarding experience of the users on Knowledge: It will showcase what the user can do with the app and it will help people writing their first articles by providing pre-configured articles.

The templates can contain all kinds of blocks and can be specific to some use cases and industries. We can for instance have a template to create a todo list, a template to do project management, a template to create a small CRM, a template to load a dashboard, etc.

## Functional

The user can load a template in two ways:

1. When the article is empty, the interface will show a contextual menu in the editor allowing the user to load a template or insert a kanban or list view. The contextual menu will disappear as soon as the user starts typing something in the editor. When the user clicks on the button "Load a Template", a new modal listing all available templates will appear. The user can preview the templates and load one inside the current article.
2. The Knowledge interface will display a "Browse Templates" button in the bottom left corner of the main view. Unlike the "Load a Template" button, this button will create a brand new article and load the template in it.

## Technical

This PR will introduce two new models: `knowledge.article.template` and `knowledge.article.template.category`. The first model will be used to store the article templates and the configuration that should be applied to the article (i.e: the property field definition, the icon, etc). The second model will be used to create categories for the templates. Those categories will help the users organize their templates.

The templates will have the same hierarchy system as the articles: A template can have child templates and can not contain cycles. When the user loads a template, the system will recursively create child articles from the child templates respecting the same hierarchy.

The templates will currently be stored in the database. By doing that, people will be able to create their own templates or tweak the default ones to make sure that they fit their needs. They can for instance edit the body of the template, add/remove property fields, add/remove children, etc.

To create a new template:

1. The administrators can go in the "Settings" > "Technical" > "Knowledge" > "Templates" and create a new record. The administrators can edit the body of the template using a textarea.
2. As the templates are simple records, the templates can be loaded from a module using the `data` folder. Those data will be loaded in the database when installing the module. People could ship their templates in a module and share them with the community.

## Further work

In the future, we would like to improve the integration of Knowledge with the Odoo Store to let people install additional article templates in one click. People could then create modules containing article templates and sell them online.

We also may want to load a template from an external server to quickly deliver new templates or update the existing ones without having to update the Odoo instance of the clients.

task-2796157

Take appointment with users and resources.
This allow to take an appointment with users like before.
But also to book a table in a restaurant or other type of material for yourself or multiple people.

Changes and improvements:
* An appointment can now be based on two things:
	- users (like the previous appointment type)
	- resources

* The assign_method field is common for the two and has three mode:
	- resource_time: which let you select the resource/user before
selecting a slot
	- time_resource: which let you select the slot before the resource
or user
	- time_auto_assign: which correspond to the old random

* A new model manage the appointment resources which inherits from
resource.mixin

* A resource is defined by multiple values:
	- capacity: the maximum capacity for a resource for a time slot
	- shareable: allows to share the resource with different attendees
for a time slot
	- linked_resource_ids: the resources that can be combine with the
actual resource to allow a bigger capacity (e.g. restaurant tables)

* When based on resources, some options change for the appointment type:
	- An option is available (resource_manage_capacity) to display a
capacity picker on the frontend to let the user select the number of persons,
he want to booked for.
	- You can enable a manual confirmation for the appointment booked when
a certain threshold is reached. When reached, the status of the attendee is set
as 'needsAction' instead of 'accepted'

* A new model is created to manage the appointment where multiple resources are
used for a single event (appointment.booking.line). This one is used when the
appointment type is based on resources to compute the availabilities for the slot
based on the resource's info and the appointment already booked. The info taking into
account are the capacity, the linked resources and the shareability of each resource.
For example:
	- If we have a bar counter for 10 persons and is shareable. There is already a
booking for 2 persons. So the remaining capacity for these case is 8 people.
	- If we have a restaurant with 3 tables for 4 persons and 1 table for 2 persons.
And we have the 3 tables for 4 that can be linked to the table for 2. The maximum capacity
that can be booked will be for 6 persons in this case.

task-2453291

Mirror change in community.
Apply enterprise design.

---

Co-authored-by: Aaron Bohy <aab@odoo.com>
Co-authored-by: Antoine (anso) <anso@odoo.com>
Co-authored-by: Brieuc-brd <brd@odoo.com>
Co-authored-by: Damien Bouvy <dbo@odoo.com>
Co-authored-by: Dardenne Florent (dafl) <dafl@odoo.com>
Co-authored-by: Elisabeth Dickinson <edi@odoo.com>
Co-authored-by: Florian Charlier <flch@odoo.com>
Co-authored-by: Julien Carion (juca) <juca@odoo.com>
Co-authored-by: Mathieu (mano) <mano@odoo.com>
Co-authored-by: Pierre Paridans <app@odoo.com>
Co-authored-by: Romain Estievenart <res@odoo.com>
Co-authored-by: Romeo Fragomeli <rfr@odoo.com>
Co-authored-by: chrysanthe(chgo) <chgo@odoo.com>
Co-authored-by: luvi <luvi@odoo.com>
Co-authored-by: stefanorigano (SRI) <sri@odoo.com>
Co-authored-by: xlu-odoo <xlu@odoo.com>

---

Community:
- https://github.com/odoo/odoo/pull/116641

---

task-2818586 (rd-design)
task-3179344 (rd-framework-js)
task-3276542 (rd-framework-js, fixes)