Files
vikunja/pkg/migration/20251001113831.go
kolaente 6f0b685e38 fix: handle mixed-format bucket configurations in migration (#2033)
This change modifies the migration `20251001113831` to flexibly parse bucket configuration filters. 

This fixes this migration issue:

```
json: cannot unmarshal object into Go struct field bucketConfigurationCatchup.filter of type string
```

This occurred when a single `bucket_configuration` JSON array contained
mixed formats - some buckets with old string filters and some with
already-converted object filters.
2026-01-05 22:30:10 +01:00

142 lines
4.3 KiB
Go

// Vikunja is a to-do list application to facilitate your life.
// Copyright 2018-present Vikunja and contributors. All rights reserved.
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program 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 Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program. If not, see <https://www.gnu.org/licenses/>.
package migration
import (
"encoding/json"
"src.techknowlogick.com/xormigrate"
"xorm.io/xorm"
)
// Full bucket filter struct with all fields to avoid dropping data during migration
type bucketFilterCatchup struct {
Search string `json:"s,omitempty"`
SortBy []string `json:"sort_by,omitempty"`
OrderBy []string `json:"order_by,omitempty"`
Filter string `json:"filter,omitempty"`
FilterIncludeNulls bool `json:"filter_include_nulls,omitempty"`
}
// Flexible bucket configuration format that can handle both string and object filters
type bucketConfigurationCatchup struct {
Title string `json:"title"`
Filter json.RawMessage `json:"filter"`
}
// New bucket configuration format (filter as object)
type bucketConfigurationCatchupNew struct {
Title string `json:"title"`
Filter *bucketFilterCatchup `json:"filter"`
}
// Old format project view
type projectViewBucketsCatchup struct {
ID int64 `xorm:"autoincr not null unique pk"`
BucketConfiguration []*bucketConfigurationCatchup `xorm:"json"`
}
func (projectViewBucketsCatchup) TableName() string {
return "project_views"
}
// New format project view
type projectViewBucketsCatchupNew struct {
ID int64 `xorm:"autoincr not null unique pk"`
BucketConfiguration []*bucketConfigurationCatchupNew `xorm:"json"`
}
func (projectViewBucketsCatchupNew) TableName() string {
return "project_views"
}
func init() {
migrations = append(migrations, &xormigrate.Migration{
ID: "20251001113831",
Description: "catch up on bucket_configuration filter format conversions",
Migrate: func(tx *xorm.Engine) (err error) {
oldViews := []*projectViewBucketsCatchup{}
// Find all filter-mode views - we'll check individual buckets in code
err = tx.Where("bucket_configuration_mode = 2").
Find(&oldViews)
if err != nil {
return
}
// Transform each view's bucket_configuration
for _, view := range oldViews {
newView := &projectViewBucketsCatchupNew{
ID: view.ID,
}
needsUpdate := false
// Convert each bucket configuration from old to new format
for _, configuration := range view.BucketConfiguration {
newConfig := &bucketConfigurationCatchupNew{
Title: configuration.Title,
}
// Check if filter is a string (old format) or object (already converted)
if len(configuration.Filter) > 0 {
switch configuration.Filter[0] {
case '"':
// It's a JSON string - extract and wrap in object
var filterString string
if err := json.Unmarshal(configuration.Filter, &filterString); err != nil {
return err
}
newConfig.Filter = &bucketFilterCatchup{
Filter: filterString,
}
needsUpdate = true
case '{':
// It's already an object - preserve all fields
var existingFilter bucketFilterCatchup
if err := json.Unmarshal(configuration.Filter, &existingFilter); err != nil {
return err
}
newConfig.Filter = &existingFilter
}
}
newView.BucketConfiguration = append(newView.BucketConfiguration, newConfig)
}
// Only update if we actually found string filters to convert
if !needsUpdate {
continue
}
// Update only the bucket_configuration column
_, err = tx.Where("id = ?", view.ID).
Cols("bucket_configuration").
Update(newView)
if err != nil {
return
}
}
return
},
Rollback: func(tx *xorm.Engine) error {
return nil
},
})
}