How your data is organized
Everything you keep in Kaizendex is an entry in a collection. The collection and its properties are the shape of your data. The entries are the data.
Shape and data
- The shape is the collection and its properties. Workouts has Distance (a Number) and Type (Tags). People who build databases call the shape a schema: the plan of what each entry holds.
- The data is the entries. Each entry fills in one value for each property. “Morning run” has Distance 5.2 km and Type Run.
- A value can be empty. “Push day” has no distance, and that is fine.
| Shape (the schema) | Data | |
|---|---|---|
| Is | a collection and its properties | the entries and their values |
| Example | Workouts: Distance (Number), Type (Tags) | “Morning run”: Distance 5.2 km, Type Run |
| Changes when | you add, rename or remove a property | you add or edit an entry |
You design the shape yourself, and you can change it at any time.
The parts
| Part | What it is | Example |
|---|---|---|
| Collection | A list of one kind of thing. | Workouts |
| Property | A field that every entry in the collection fills. | Distance (a Number, in km) |
| Entry | One item in a collection. | “Morning run”, 27 Oct |
| Value | What one entry holds for one property. | Distance: 5.2 km |
| View | One way to show a collection’s entries. | A calendar of all workouts |
| Block | One piece inside a Block page or a Dashboard property: a paragraph, a photo, a chart. | A chart of km per week |
Notes and dashboards are entries too. A note is an entry in the Notes collection. A dashboard is an entry in the Dashboards collection, with a Dashboard property of blocks.
The word “page” means only a screen. The entry page shows one entry. The collection page shows one collection, with its views as tabs. The hub page shows one hub: a tab bar of its own in the sidebar, for the views and entries you open most. A hub holds no data.
Three rules hold it together
- Every entry is in exactly one collection, from the day you make it until you delete it.
- A collection always shows all its entries. Only a filter you add, the Trash or Hidden hides one.
- An entry can sit inside one other entry (its Parent). It always shows in its own collection. It also shows inside its parent when the parent’s collection has a Children property.