This is an EPIC

Related issues: #2292

Summary

EPIC description

Decidim permits collaborative and co-creation of proposals. The proposals will be called "collaborative proposals". Each collaborative proposal will be called "draft" until be published (converted to a proposal). The collaborative proposals will have the origin "collaborative proposals". It will incorporate the following functions:

• Creating rough drafts with numerous authors.
• The listing of collaborative drafts
• Comments in drafts
• Asking for help from and accepting the help of other collaborators
• Linking drafts to meetings
• Promoting drafts into an initiative, participatory process or project proposal.

On publish a new entity is created with same title, description, category, scope and authorship, comments and the rest of the meta-information will be kept in the draft which won't disappear. Instead a link to the draft will be added to the new Proposal.

A Collaborative Draft does not have any kind of origin, nor Official, neither Citizen. This attribute will be setted to the Proposal it becomes.

Proposal limit per user: we only check it for the creation of proposal, not co-authoring of drafts.

Main related issues

• MVP: Collaborative Draft MVP #3049
• Implementation details: Collaborative Space implementation details #3079

Specs

Draft navigator and draft-creation button

When accessing the proposal, provided that proposal drafts is activated, the proposal section must:

• Offer a button to view proposal drafts navigator --> @decidim/lot-px design required
• Offer a form to create a draft proposal that allows several authors (Decidim participants or user groups) to be incorporated
• Proposal draft navigator shows:
  • Brief explanation of the page
  • List of proposals with card view
  • Filters by territorial area, categories, tags, open/closed, type of proposal (initiative, process, assembly, etc.)
• A button create draft exist to create a draft
  • The proposal-draft creation wizard operates like the proposal creation wizard

Draft page and actions

• Design required @decidim/lot-px:
  • Access to collaborative proposals from proposals page
  • Collaborative proposals page list
  • List of collaboration requests with accept/refuse actions available for co-authors.
  • Collaborative proposal full page (check this comment)
• Once the draft proposal is created, the user can interact with the draft proposal in the following ways:
  • The user can comment on the draft proposal
  • The user can request to collaborate the proposal as a co-author and this can only be accepted by the author or authors of the draft proposal. CTA: Collaborate
  • Authors of the proposal must be able to accept new collaborators
  • The user can share, follow and embed the draft proposal.
  • The user can flag a proposal to report a content.
• Authors can edit the draft with version control.
• Endorsements apply like in proposals
• Once the authors of a draft decide that the draft is complete they must be able to Publish the draft as a proposal.

Creation work-flow

• Like Proposal's creation Wizard. Only compares between published collaborative proposals.

Request collaboration work-flow

When a non-author-user clicks on the "COLLABORATE" button she requests to become a co-author.
When the button is clicked:

• An email is sent to all co-authors with the request and a link to the draft's detail page.
• A list, under the meta data?, will show pending requests to be accepted/refused (only for co-authors).

From then, they are incorporated into the flow of each of the different types of proposals.

1st Iteration

• The page of the draft will have a summary of activity (metadata box) on the draft that will show the following information:
  • Control Version: When a user or organisation has made a modification to the draft (to the title or description)
  • Number of comments
  • Number of contributors to the draft
  • Number of co-authors
• A proposal that is the result of a collaborative-draft needs to display and identifier and a link to the original draft. --> @decidim/lot-px design-required

Fridge

2nd Iteration

• Geolocation of Collaborative Drafts (setting and map)
• Meetings can be associated to the draft --> this has to be done from the meetings component. When you close a meeting you can associate to a draft in the same way that you associate a proposal.
• Invitations can be sent
• It must be able to link the draft to other proposals on the Decidim platform. This is related to Proposals may be associated via a link in the comments #2288 and it should work in the same way.
• Drafts applicable for projects
• The page of the draft will have a summary of activity (metadata box) on the draft that will show the following information:
  • Number of face-to-face meetings
• Drafts applicable for Initiatives