summaryrefslogtreecommitdiffstats
path: root/framework/src/domain/perioddayeventmodel.h
blob: cd26fe469bfd6ddc572324f984787723d94c67db (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
/*
    Copyright (c) 2018 Michael Bohlender <michael.bohlender@kdemail.net>
    Copyright (c) 2018 Christian Mollekopf <mollekopf@kolabsys.com>
    Copyright (c) 2018 Rémi Nicole <minijackson@riseup.net>

    This library is free software; you can redistribute it and/or modify it
    under the terms of the GNU Library General Public License as published by
    the Free Software Foundation; either version 2 of the License, or (at your
    option) any later version.

    This library is distributed in the hope that it will be useful, but WITHOUT
    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
    FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
    License for more details.

    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to the
    Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
    02110-1301, USA.
*/

#pragma once

#include <sink/applicationdomaintype.h>

#include <QAbstractItemModel>
#include <QList>
#include <QSharedPointer>
#include <QVector>

#include <limits>

// Facility used to get a restricted view into a Sink model comprised of
// events, partitioned according to the day the events take place.
//
// Model Format
// ============
//
// Day 0
//  |--- Event 0 starting at `viewStart + 0d`
//  |--- Event 1 starting at `viewStart + 0d`
//  '--- Event 2 starting at `viewStart + 0d`
// Day 1
//  '--- Event 0 starting at `viewStart + 1d`
// Day 2
// Day 3
//  |--- Event 0 starting at `viewStart + 3d`
//  '--- Event 1 starting at `viewStart + 3d`
// Day 4
//   ⋮
//
// Implementation notes
// ====================
//
// On the model side
// -----------------
//
// Columns are never used.
//
// Top-level items just contains the ".events" attribute, and their rows
// correspond to their offset compared to the start of the view (in number of
// days). In that case the internalId contains DAY_ID.
//
// Direct children are events, and their rows corresponds to their index in
// their partition. In that case no internalId / internalPointer is used.
//
// Internally:
// -----------
//
// On construction and on dataChanged, all events are processed and partitioned
// in partitionedEvents:
//
// QVector< QList<QSharedPointer<Event> >
// ~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~
//    |                |
//    |                '--- List of event pointers for that day
//    '--- Partition / day
//
class PeriodDayEventModel : public QAbstractItemModel
{
    Q_OBJECT

    Q_PROPERTY(QVariant viewStart READ viewStart WRITE setViewStart)
    Q_PROPERTY(int viewLength READ viewLength WRITE setViewLength)

public:
    using Event = Sink::ApplicationDomain::Event;

    enum Roles
    {
        Events = Qt::UserRole + 1,
        Summary,
        Description,
        StartTime,
        Duration,
    };
    Q_ENUM(Roles);
    PeriodDayEventModel(QObject *parent = nullptr);
    ~PeriodDayEventModel() = default;

    QModelIndex index(int row, int column, const QModelIndex &parent = {}) const override;
    QModelIndex parent(const QModelIndex &index) const override;

    int rowCount(const QModelIndex &parent) const override;
    int columnCount(const QModelIndex &parent) const override;

    QVariant data(const QModelIndex &index, int role) const override;

    QHash<int, QByteArray> roleNames() const override;

    QDate viewStart() const;
    void setViewStart(QDate);
    void setViewStart(QVariant);
    int viewLength() const;
    void setViewLength(int);

private:
    void partitionData();

    int bucketOf(QDate const &candidate) const;

    QDate mViewStart;
    int mViewLength = 7;

    QSharedPointer<QAbstractItemModel> eventModel;
    QVector<QList<QSharedPointer<Event>>> partitionedEvents;

    static const constexpr quintptr DAY_ID = std::numeric_limits<quintptr>::max();
};