<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:06:49 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary add field=key&field=summary to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>FOLIO Jira</title>
    <link>https://folio-org.atlassian.net</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>1001.0.0-SNAPSHOT</version>
        <build-number>100246</build-number>
        <build-date>07-02-2024</build-date>
    </build-info>

<item>
            <title>[FOLIO-577] SPIKE: Needs for Notes Feature</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-577</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;&lt;b&gt;Purpose:&lt;/b&gt; Consider and document thoughts on front and back-end needs for the Notes feature.  Any thoughts on how big this is would also be valuable.  As mentioned, we might be able to get away with a simpler way to capture notes for v1 but we&apos;d rather do it per Filip&apos;s requirements, if possible.&lt;/p&gt;

&lt;p&gt;&lt;b&gt;Reference materials:&lt;/b&gt;&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;STCOM-59&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/STCOM-59&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;Notes v1&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10309?size=medium&quot; /&gt;
            STCOM-59
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
 describes the specific requirements for a first iteration of this feature&lt;/li&gt;
	&lt;li&gt;
    &lt;span class=&quot;jira-issue-macro resolved&quot; data-jira-key=&quot;LIBAPP-122&quot; &gt;
                &lt;a href=&quot;https://folio-org.atlassian.net/browse/LIBAPP-122&quot; class=&quot;jira-issue-macro-key issue-link&quot;  title=&quot;UX: Notes Feature Description&quot; &gt;
            &lt;img class=&quot;icon&quot; src=&quot;https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10309?size=medium&quot; /&gt;
            LIBAPP-122
        &lt;/a&gt;
                                                    &lt;span class=&quot;aui-lozenge aui-lozenge-subtle aui-lozenge-success jira-macro-single-issue-export-pdf&quot;&gt;Closed&lt;/span&gt;
            &lt;/span&gt;
 describes Filip&apos;s long-term vision for this feature&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;[Draft: Needs for Notes feature, &lt;a href=&quot;https://docs.google.com/document/d/1D_yuzkZc8b3NnvxFmJ2Pj9lKQDDJh66eJyTP58_HnnQ/edit&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://docs.google.com/document/d/1D_yuzkZc8b3NnvxFmJ2Pj9lKQDDJh66eJyTP58_HnnQ/edit&lt;/a&gt;]&lt;/p&gt;</description>
                <environment></environment>
        <key id="80288">FOLIO-577</key>
            <summary>SPIKE: Needs for Notes Feature</summary>
                <type id="10002" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10322?size=medium">New Feature</type>
                                            <priority id="10002" iconUrl="https://dev.folio.org/assets/jira-priority/jira-p3.svg">P3</priority>
                        <status id="6" iconUrl="https://folio-org.atlassian.net/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10003">Done</resolution>
                                                        <assignee accountid="5bffed5e2434bf3a1a91d37a">Niels Erik Nielsen</assignee>
                                                                <reporter accountid="5af5ed55244bc90a106063c7">Cate Boerema</reporter>
                                    <labels>
                            <label>sprint13</label>
                    </labels>
                <created>Thu, 27 Apr 2017 13:04:58 +0000</created>
                <updated>Mon, 12 Nov 2018 14:23:30 +0000</updated>
                            <resolved>Tue, 28 Nov 2017 10:52:45 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>5</watches>
                                                    <timespent seconds="29700">1 day, 15 minutes</timespent>
                                <comments>
                                                            <comment id="192002" author="5bffed52a1b46046f530c8f7" created="Thu, 27 Apr 2017 13:16:31 +0000"  >&lt;p&gt;First thoughts on back-end storage:&lt;/p&gt;

&lt;p&gt;1. Notes should not be stored in a facility related to an application module such as Users or Items &amp;#8211; otherwise many different back-end modules would need to be changed to support notes. Instead, there should be a back-end module that many different UI module can use for CRUDding their notes.&lt;br/&gt;
2. That back-end module could be its own specialised mod-notes; or perhaps the notes could reasonably be squeezed into mod-config. Are there any other options?&lt;br/&gt;
3. Different applications will use slightly different logical schemas for their notes (e.g. notes in Users will have a &quot;can the user see this note about himself?&quot; bit, while notes in Items will not). But the differences will probably be small enough that a single physical (JSON) schema will suffice for all modules to share.&lt;br/&gt;
4. The heart of that schema will be just {{{ note(text), notatedObjectId(UUID), noteMaker(userId), noteDatestamp(dateTime) }}}. Other fields used by only a few modules, such as &lt;tt&gt;userIsAllowedToSeeNote&lt;/tt&gt; can also be added.&lt;/p&gt;

&lt;p&gt;Sound about right?&lt;/p&gt;</comment>
                                                            <comment id="192003" author="712020:38d1a08f-86a8-4df2-9191-239b16b0a81a" created="Thu, 27 Apr 2017 13:51:28 +0000"  >&lt;p&gt;I agree that the notes should not be embedded in users and other modules using them. It might be best to make them first class citizens, with a back-end module of their own.&lt;/p&gt;

&lt;p&gt;I would hesitate with fields like &quot;userIsAllowedToSeeNote&quot;. I would rather have an open-ended list of tags that each notes-using app can define for itself. That way, we don&apos;t have to change the notes structure at all when the poetry-club app wants to add a &quot;forMembersOnly&quot; tag in their notes.&lt;/p&gt;</comment>
                                                            <comment id="192004" author="5bffed52a1b46046f530c8f7" created="Thu, 27 Apr 2017 13:57:01 +0000"  >&lt;p&gt;Yes, that is better. (So long as our mechanisms can handle a field &lt;tt&gt;extensions&lt;/tt&gt; of type&lt;/p&gt;
&lt;div class=&quot;code panel&quot; style=&quot;border-width: 1px;&quot;&gt;&lt;div class=&quot;codeContent panelContent&quot;&gt;
&lt;pre class=&quot;code-java&quot;&gt;
listof struct { fieldName(string), fieldValue(string) }
&lt;/pre&gt;
&lt;/div&gt;&lt;/div&gt;</comment>
                                                            <comment id="192005" author="5bffed5e2434bf3a1a91d37a" created="Thu, 27 Apr 2017 15:44:53 +0000"  >&lt;h6&gt;&lt;a name=&quot;Fornow&quot;&gt;&lt;/a&gt;For now&lt;/h6&gt;

&lt;p&gt;The note JSON structure in first comment would likely suffice for a ui module to display notes for its records.&lt;/p&gt;

&lt;p&gt;But at least one additional identifier will be necessary for a notes app to find the record that the UUID refers to.  &lt;/p&gt;

&lt;p&gt;(Or, we would need a registry of UUID-&amp;gt;API-endpoint references, but we would not go there I&apos;m sure, not just for the sake of a notes app at least).&lt;/p&gt;

&lt;p&gt;The structure should also have a PK of its own of course, but guess that&apos;s implicit. &lt;/p&gt;

&lt;h6&gt;&lt;a name=&quot;Forlater&quot;&gt;&lt;/a&gt;For later&lt;/h6&gt;

&lt;p&gt;Additional structures would be needed for Filip&apos;s ideas for &quot;triggers&quot;, &quot;tagging&quot;, &quot;visibility&quot;, &quot;unread notes&quot;, but that kind of information would likely live outside of the basic note JSON structure as discussed here. &lt;/p&gt;

&lt;p&gt;I don&apos;t know if there potentially also could be requirements that a note should be editable, that it should keep a history, or that multiple users should be able to contribute to a note. I don&apos;t immediately see thoughts on that it in the UX jiras.&lt;/p&gt;</comment>
                                                            <comment id="192006" author="5bffed52a1b46046f530c8f7" created="Thu, 27 Apr 2017 15:48:53 +0000"  >&lt;p&gt;Ah, right: you mean that the note would need a &quot;what kind of object this note is attached to&quot; field. Right: so that it knows whether to search for the annotated object in mod-users or mod-inventory.&lt;/p&gt;

&lt;p&gt;Agree that, for &lt;em&gt;this&lt;/em&gt; purpose at least, a system-wide UUID-&amp;gt;type mapping would be unnecessary and inelegant.&lt;/p&gt;

&lt;p&gt;And yes, of course the note would need its own PK, but that is uninteresting &lt;img class=&quot;emoticon&quot; src=&quot;/images/icons/emoticons/smile.png&quot; height=&quot;16&quot; width=&quot;16&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt;&lt;/p&gt;
</comment>
                                                            <comment id="192007" author="557058:f80403de-e149-421e-8750-af45c853402f" created="Thu, 27 Apr 2017 15:56:34 +0000"  >&lt;p&gt;&quot;I don&apos;t know if there potentially also could be requirements that a note should be editable, that it should keep a history, or that multiple users should be able to contribute to a note. I don&apos;t immediately see thoughts on that it in the UX jiras.&quot; &lt;/p&gt;

&lt;p&gt;... yes (some/all?) notes should be editable and keep a track history.&lt;/p&gt;

&lt;p&gt;I have started a Google doc where I will gather relevant requirements about Notes in e.g. the FOLIO 2018 Release doc, and misc. discussed with the SIGs -&lt;br/&gt;
 see &lt;a href=&quot;https://docs.google.com/document/d/1D_yuzkZc8b3NnvxFmJ2Pj9lKQDDJh66eJyTP58_HnnQ/edit&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;https://docs.google.com/document/d/1D_yuzkZc8b3NnvxFmJ2Pj9lKQDDJh66eJyTP58_HnnQ/edit&lt;/a&gt; &lt;b&gt;(Please note the document is &lt;em&gt;Work-in-progress&lt;/em&gt;)&lt;/b&gt;&lt;/p&gt;</comment>
                                                            <comment id="192008" author="5bffed52a1b46046f530c8f7" created="Thu, 27 Apr 2017 16:05:35 +0000"  >&lt;p&gt;Things like editability of notes with version history seem rather esoteric for an MVP. &lt;em&gt;Is&lt;/em&gt; this stuff included in the MVP? If not, I think we should ignore it: we have a great deal to do already.&lt;/p&gt;</comment>
                                                            <comment id="192009" author="557058:f80403de-e149-421e-8750-af45c853402f" created="Thu, 27 Apr 2017 16:10:08 +0000"  >&lt;p&gt;Yes, like Niels wrote: FOR LATER &lt;img class=&quot;emoticon&quot; src=&quot;/images/icons/emoticons/smile.png&quot; height=&quot;16&quot; width=&quot;16&quot; align=&quot;absmiddle&quot; alt=&quot;&quot; border=&quot;0&quot;/&gt; &lt;/p&gt;</comment>
                                                            <comment id="192010" author="5bffed5e2434bf3a1a91d37a" created="Thu, 27 Apr 2017 16:16:59 +0000"  >&lt;p&gt;All right, Charlotte, in that case we may decide to have a data structure with an array of note editions from the outset (to hopefully reduce the need for data restructuring later), and then for the MVP only use the first array entry for any given note. &lt;/p&gt;


</comment>
                                                            <comment id="192011" author="5bffed5e2434bf3a1a91d37a" created="Mon, 13 Nov 2017 09:56:50 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=5af5ed55244bc90a106063c7&quot; class=&quot;user-hover&quot; rel=&quot;5af5ed55244bc90a106063c7&quot; data-account-id=&quot;5af5ed55244bc90a106063c7&quot; accountid=&quot;5af5ed55244bc90a106063c7&quot; rel=&quot;noreferrer&quot;&gt;Cate Boerema&lt;/a&gt; Can we close this? &lt;/p&gt;

&lt;p&gt;Heikki and others may have long moved beyond it.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10000" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummarycf">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzxnbj:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10024" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>[CHART] Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 27 Apr 2017 13:16:31 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10025" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>[CHART] Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                    </customfields>
    </item>
</channel>
</rss>