This is a long-term plan on improving indexing and searching in Kontact. The goal is to make the index faster and reliable, reduce the scope of what we are indexing, but make sure we are indexing it correctly and in a way that will allow us to give the most meaningful results to users queries.
---
[] ** Phase 1: The Indexing Infrastructure**
Indexing happens in resources and clients upon entry, and documents are sent to the server, which writes them to Xapian store. This way we ensure that everything is indexed by the time it becomes visible to clients and we can start relying on the index as an authoritative data source.
[X] Merge our Xapian wrapper classes into the main library
[X] Move indexing & search into Stores so that the code lives in the same place
[] Port Email/Contact/...Query classes to Akonadi::SearchQuery, which shall be passed to search stores that will then translate it to Xapian query and execute
[X] Adjust Store API to be able to return Xapian::Document with indexed data that can be serialized
[X] Extend protocol to allow sending serialized Xapian::Documents as part of ItemCreateJob/ItemModifyJob
[X] Extend SearchManger in Server to write the documents directly to relevant Xapian stores
[X] Extend Serializer plugins or the ItemCreateJob/ItemModifyJob to perform the indexing before sending command
* how to handle partial updates, like flag change, when client does not have full payload?
[] Get rid of the Indexing Agent
---
[] **Phase 2: The Indexed Content**
Emails:
[] Index only several main headers, ignore stuff like "Received", "X-*" etc.
* Subject
* From
* To
* Cc
* Date
* Collection
[] Index attachment names
[] Properly parse emails, look for nested body parts (inline-forwarded emails) etc, handle HTML emails
[] Index message flags
Contacts
* Name
* Email(s)
* Nick name
* Birthday
* Anniversary
* UID???
* Collection
Contact Groups
* Name
* Emails and names of members
* Collections
Events
* Summary
* Description
* Organizer
* Location
* Attendees
* Collection
[] Calculate all occurrences of an event and store only months on which it occurs and range of years within which it occurs - this will allow us to modify KOrganizer to query only for events from the currently viewed month
Notes
* Summary
* Body
* Collection
---
[] **Phase 3: Using the Index**
Now that our infrastructure is fast, reliable and overall awesome, we can start making more use of it.
[] Replace ETMCalendar with a custom calendar that queries the index for events occurring within the currently displayed month, only then request Akonadi to provide those events. Should drastically speed up loading of calendar and reduce memory footprint
[] Pre-fetch previous and next month as an optimization to allow quick switching, drop months that are no longer visible to keep the memory usage small
[] Replace/complement the Search dialog in KMail with a Search screen where one-time queries can be executed and that can display results in the main message list, maybe including some statistics and offering additional search/filter options. Look at what (and how) Thunderbird or Gmail do this.
[] TBD
---
---
**Additional TODOs**
- [] Cleanup and document `Akonadi::ContactSearchTerm`, `Akonadi::EmailSearchTerm` and `Akonadi::IncidenceSearchTerm` field enums
- For example, `Akonadi::EmailSearchTerm::Attachment` says it searches inside of an attachment, but that's not implemented at all
- [] Add `Akonadi::SearchTerm::negated()` that returns negated self, to allow constructs like `searchQuery.addTerm(EmailSearchTerm(MessageStatus, MessageFlags::HasAttachment).negated())`