Feat/import focalboard

[ananastii]

Focalboard to Planka Import - Project Summary

Project Overview

Goal: Import boards from Focalboard (JSONL format) into Planka project management system.

What gets imported:

• board name
• lists (columns)
• labels (colors mapped by similarity)
• card titles
• members (matched to existing Planka users by person/multiPerson type)
• descriptions (multiple text blocks merged with \n\n)
• due dates (as unchecked checkbox)
• custom fields (text/url/number/email/phone → string)
• comments (attributed to matched user or tagged with original username)
• checklists (merged into one task list)
• creator
• createdAt timestamps
• optionally: link to original card is created

Not imported:

• file attachments
• board-level system fields (createdBy/modifiedBy/dates managed by Planka automatically)
• card updateAt/deleteAt.

---

Design Choices

1. Two-Step Import Flow

Decision: Preview file first, let user select mappings, then import.

Reasoning:

• Different Focalboard boards have different property configurations
• Hardcoded property IDs don't work across boards
• User needs to see available properties before deciding what to import
• Allows selective import of custom fields

2. importMapping as Query Parameter

Decision: Send importMapping JSON as URL query parameter, not in multipart form body.

Reasoning:

• Sails.js multipart form parser doesn't reliably pass all fields to inputs
• Query parameters are parsed correctly regardless of form body

[alexeyqu]

ok but let's not merge it for now