Focalboard v1.0 路线图深度解析从开源看板到 Trello / Notion / Asana 自托管替代品的演进路径【免费下载链接】focalboardFocalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.项目地址: https://gitcode.com/GitHub_Trending/fo/focalboard本文基于 Focalboard 团队 2021 年 5 月发布的官方路线图博客《Focalboard: The road to v1.0》结合当前仓库源码逐项拆解 Focalboard 从 v0.6.5 走向 v1.0 的功能规划视图体系完善、属性类型扩充、内容类型扩展、侧边栏与个人仪表盘以及它与 Mattermost 的深度集成方向。读完本文你将完整掌握 Focalboard 的核心数据模型Board / View / Card / Block、各类视图的源码实现结构以及官方在 2021 年对 v1.0 功能边界的定义。一、背景为什么 Focalboard 需要一份明确的 v1.0 路线图2021 年 5 月Focalboard 在经历了 GitHub Trending、Hacker News、Reddit 与 Product Hunt 的社区爆发之后v0.6.5 发布时仓库已从 40 星增长到 3200 星由核心维护者 Chen Lim 发布了这篇路线图博客。文章开篇点明了项目的北极星定位Focalboard 要成为一个有吸引力的开源、自托管、可替代 Trello、Notion 和 Asana的产品。这个定位直接体现在当前仓库根目录 README 的项目描述中Focalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.也贯穿了整份路线图的所有条目——每一项规划都指向80% 用户关心的通用功能这一目标。路线图声明了即时目标先把这三个参考产品中的共性功能补齐即80% 用户都会用到的功能集合。同时文档也明确说明这只是当前计划许多条目仍处于探索阶段不构成任何承诺——这是官方对社区预期的负责任表述。二、产品差异化核心与 Mattermost 的深度集成路线图明确指出Focalboard 的主要差异化优势之一是与 Mattermost 的紧密集成。这一方向在仓库中对应的早期预览博客《Mattermost-Focalboard Early Preview》2021-04-27 发布中有详细描述每个 Mattermost 频道公开与私密关联一个对应的 Focalboard workspace仅该频道的成员可以访问通过频道头部的 Focalboard 图标即可打开对应 workspace立即可获得的好处是继承 Mattermost 的安全与访问控制系统例如按 workspace 粒度配置权限的能力当时的早期预览仅支持 Web 浏览器访问桌面端与移动端暂不支持且官方明确警告属于bleeding edge不要存放关键或敏感数据。路线图还预告了后续计划中的两类集成能力卡片链接 unfurling在 Mattermost 中预览 Focalboard 卡片链接的摘要信息Slash 命令创建卡片通过 Mattermost 的斜杠命令直接新建卡片。这两项能力在仓库中由server目录下的插件适配层支撑——例如 server/ws/plugin_adapter.go 与 server/ws/plugin_adapter_client.go 构成了 Focalboard 以 Mattermost 插件形态运行时的 WebSocket 适配通道从源码结构可以推断卡片创建、实时更新等操作正是通过这套适配层与 Mattermost 端到端打通。三、核心功能规划补齐并完善现有视图路线图的第一大块规划是完成 / 更新现有视图涵盖 Board、Table、Gallery、Card 四种视图。这些视图在当前的 webapp/src/components 目录中均有独立实现目录并配有各自的单元测试与快照测试。3.1 Board 视图看板规划中的两项关键补强是看板导出 / 导入与键盘支持。看板视图的源码实现位于 webapp/src/components/kanban/kanban.tsx从代码结构看它的核心机制是以groupByProperty分组属性驱动列结构每一列对应属性中的一个 optionkanbanColumn.tsx通过onDropToColumn/onDropToCard回调实现拖拽换列、拖拽排序并调用mutator.changePropertyValue与mutator.changeViewCardOrder持久化变更支持隐藏列hiddenGroups、折叠列、列内计算kanbanCalculations以及按defaultTemplateId从模板快速新建卡片。关于导出/导入仓库 webapp/src/archiver.ts 实现了 archive 的导出与导入逻辑服务端对应 server/api/archive.go 提供 API而键盘支持issue #29在后来的迭代中逐步落地为卡片操作快捷键。3.2 Table 视图表格规划条目为分组表格 / 列表视图与键盘支持。Table 视图实现在 webapp/src/components/table 目录其中的 tableGroup.tsx 与 tableGroupHeaderRow.tsx 正是分组表格能力的载体——Table 视图可以根据分组属性把行按组渲染这一能力后来也演化为独立的 List 视图的基础。3.3 Gallery 视图画廊与 Card 视图Gallery 视图在 v0.6.5 版本中作为新特性发布见 《Focalboard v0.6.5 发布说明》用于以矩形网格展示带图片元素的卡片。路线图中对 Gallery 和 Card 的规划主要是各类 bug 修复。当前实现 webapp/src/components/gallery/gallery.tsx 展示了其核心能力按visiblePropertyIds过滤显示属性、通过onDropToCard支持拖拽排序、配合HiddenCardCount显示被过滤隐藏的卡片数量。四、新增视图List、Calendar 与 Pages4.1 List 视图基于 Table 分组的延伸路线图明确说明 List 视图的当前计划是扩展 Table 视图以支持分组而非另起炉灶。这与源码实现吻合Table 目录中的tableGroup系列组件已具备分组渲染能力List 视图正是它的进一步产品化形态。4.2 Calendar 视图按日期属性排布卡片Calendar 视图issue #338的规划在仓库中已落地为完整实现webapp/src/components/calendar/fullCalendar.tsx 基于fullcalendar/react构建结合fullcalendar/daygrid与fullcalendar/interaction插件实现月视图与拖拽交互。从源码结构看通过dateDisplayProperty日期显示属性确定卡片在日历上的位置createDatePropertyFromCalendarDate将日历选择结果转换为DateProperty含from/to起止时间戳拖拽卡片会调用mutator.changePropertyValue更新卡片的日期属性值仅当用户具备Permission.ManageBoardCards权限时才允许新建卡片。4.3 Pages与卡片内容块同构Pages 的规划是基础实现与卡片上的内容块相同并预告了高级内容编辑器issue #166。内容块体系在源码中有清晰定义webapp/src/blocks/block.ts 声明了内容块类型列表[text, image, divider, checkbox, h1, h2, h3, list-item, attachment, quote, video]每种类型都有对应的块组件例如 textBlock.ts、imageBlock.ts、checkboxBlock.ts、dividerBlock.ts 与 attachmentBlock.tsx。Pages 与卡片共享这套内容块体系正是基本实现相同的代码级印证。五、新增属性类型Date、User 与 Multi-select路线图规划了三种新属性类型如今全部已在仓库中实现。属性类型的完整枚举定义在 webapp/src/blocks/board.tstype PropertyTypeEnum text | number | select | multiSelect | date | person | multiPerson | file | checkbox | url | email | phone | createdTime | createdBy | updatedTime | updatedBy | unknown属性类型的注册中心在 webapp/src/properties/index.tsxregistry.register()依次注册了 Text、Number、Email、Phone、Url、Select、MultiSelect、Date、Person、MultiPerson、Checkbox、CreatedTime、CreatedBy、UpdatedTime、UpdatedBy 等类型每种类型对应 webapp/src/properties 下的一个子目录如date/、person/、multiselect/、multiperson/。对照路线图路线图规划当前仓库实现源码位置Date 属性issue #38date/createdTime/updatedTimewebapp/src/properties/dateUser 属性issue #185person/multiperson并衍生createdBy/updatedBywebapp/src/properties/personMulti-selectissue #110multiSelectwebapp/src/properties/multiselect其中 Date 属性在 Calendar 视图中扮演核心角色其from/to时间戳结构直接参与日历事件的生成见 fullCalendar.tsx 中的DateProperty处理逻辑。六、新增内容类型卡片互链路线图规划的链接到另一张卡片issue #324内容类型目标是让卡片之间可以互相引用。这属于内容块Content Block体系的扩展方向。当前内容块类型清单见 webapp/src/blocks/block.ts已包含文本、图片、分割线、复选框、标题、列表项、附件、引用、视频等多种类型卡片互链将作为新的块类型加入这一体系。卡片间的关系在数据层通过 card 的parentId字段关联卡片可以嵌套在卡片内容中这一点在 webapp/src/blocks/card.ts 与 server/model/block.go 的 Block 结构定义中可以找到支撑。七、侧边栏改进与个人仪表盘7.1 侧边栏手动排序与键盘导航路线图规划了侧边栏的手动排序issue #299与键盘导航issue #28。当前侧边栏实现在 webapp/src/components/sidebar 目录包含 13 个 tsx 组件与配套的 scss / snap 快照测试。从组件结构可以推断侧边栏管理着分类Category、看板列表与工作区导航手动排序能力依赖 webapp/src/store 中的状态管理与mutator的持久化写入。7.2 个人仪表盘状态页规划中的 Personal Dashboard 包含一个状态页issue #305作为用户的个人工作总览入口。该能力与后来社区讨论中的个人待办 / 个人项目定位一脉相承——这与 Personal Desktop Edition个人桌面版的场景相呼应桌面端代码位于 mac/Focalboard 与 win-wpf/Focalboard。八、关于视图与数据模型一张视图的完整字段画像理解上述所有视图规划绕不开 Focalboard 的核心数据模型一切皆 Block。视图View本身也是一个 Block其字段结构定义在 webapp/src/blocks/boardView.tstype IViewType board | table | gallery | calendar type BoardViewFields { viewType: IViewType groupById?: string dateDisplayPropertyId?: string sortOptions: ISortOption[] visiblePropertyIds: string[] visibleOptionIds: string[] hiddenOptionIds: string[] collapsedOptionIds: string[] filter: FilterGroup cardOrder: string[] columnWidths: Recordstring, number columnCalculations: Recordstring, string kanbanCalculations: Recordstring, KanbanCalculationFields defaultTemplateId: string }这份字段清单恰好解释了路线图中几乎所有视图相关条目viewType区分 Board / Table / Gallery / Calendar 四种视图类型新增的 List 视图沿用 Table 的分组能力Calendar 视图则额外依赖dateDisplayPropertyIdgroupById驱动看板分组与表格分组对应分组表格 / 列表视图sortOptions、cardOrder分别对应自动排序与手动拖拽排序Gallery 视图中isManualSort activeView.fields.sortOptions.length 0即未配置排序时允许手动排序filterFilterGroup定义于 webapp/src/blocks/filterGroup.ts与visibleOptionIds/hiddenOptionIds支撑视图级筛选与隐藏列visiblePropertyIds决定每张卡片 / 每一行展示哪些属性Kanban 与 Gallery 组件均通过它过滤属性模板。九、参与共建反馈、贡献与后续演进路线图在最后向社区发出两项号召这也是理解 Focalboard 开源协作模式的关键持续反馈特性建议与 Bug 报告是产品方向的重要输入。仓库的 CONTRIBUTING.md 与 pull_request_template.md 提供了完整的贡献流程说明docs/contribution-checklist.md 与 docs/contributions-without-ticket.md 分别给出了合入前检查清单与免工单贡献的说明认领任务社区可以在带有 up for grabs 标签的 issue 中挑选适合自己的任务——仓库的 docs/core-committers.md 也记录了核心提交者的协作机制。从后续发展看这份路线图上的大部分条目都在随后的版本中陆续落地Calendar 视图、Date / Person / Multi-select 属性、导出导入、侧边栏排序等均已出现在当前仓库源码中印证了官方以 80% 用户共需功能为优先的推进节奏。对于希望深入了解 Focalboard 内部实现、或想为开源项目做贡献的开发者这份路线图连同仓库源码尤其是 webapp/src/blocks、webapp/src/properties 与 webapp/src/components 三个目录构成了从产品规划到代码实现的最佳对照读本。【免费下载链接】focalboardFocalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.项目地址: https://gitcode.com/GitHub_Trending/fo/focalboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Focalboard v1.0 路线图深度解析：从开源看板到 Trello / Notion / Asana 自托管替代品的演进路径
Focalboard v1.0 路线图深度解析从开源看板到 Trello / Notion / Asana 自托管替代品的演进路径【免费下载链接】focalboardFocalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.项目地址: https://gitcode.com/GitHub_Trending/fo/focalboard本文基于 Focalboard 团队 2021 年 5 月发布的官方路线图博客《Focalboard: The road to v1.0》结合当前仓库源码逐项拆解 Focalboard 从 v0.6.5 走向 v1.0 的功能规划视图体系完善、属性类型扩充、内容类型扩展、侧边栏与个人仪表盘以及它与 Mattermost 的深度集成方向。读完本文你将完整掌握 Focalboard 的核心数据模型Board / View / Card / Block、各类视图的源码实现结构以及官方在 2021 年对 v1.0 功能边界的定义。一、背景为什么 Focalboard 需要一份明确的 v1.0 路线图2021 年 5 月Focalboard 在经历了 GitHub Trending、Hacker News、Reddit 与 Product Hunt 的社区爆发之后v0.6.5 发布时仓库已从 40 星增长到 3200 星由核心维护者 Chen Lim 发布了这篇路线图博客。文章开篇点明了项目的北极星定位Focalboard 要成为一个有吸引力的开源、自托管、可替代 Trello、Notion 和 Asana的产品。这个定位直接体现在当前仓库根目录 README 的项目描述中Focalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.也贯穿了整份路线图的所有条目——每一项规划都指向80% 用户关心的通用功能这一目标。路线图声明了即时目标先把这三个参考产品中的共性功能补齐即80% 用户都会用到的功能集合。同时文档也明确说明这只是当前计划许多条目仍处于探索阶段不构成任何承诺——这是官方对社区预期的负责任表述。二、产品差异化核心与 Mattermost 的深度集成路线图明确指出Focalboard 的主要差异化优势之一是与 Mattermost 的紧密集成。这一方向在仓库中对应的早期预览博客《Mattermost-Focalboard Early Preview》2021-04-27 发布中有详细描述每个 Mattermost 频道公开与私密关联一个对应的 Focalboard workspace仅该频道的成员可以访问通过频道头部的 Focalboard 图标即可打开对应 workspace立即可获得的好处是继承 Mattermost 的安全与访问控制系统例如按 workspace 粒度配置权限的能力当时的早期预览仅支持 Web 浏览器访问桌面端与移动端暂不支持且官方明确警告属于bleeding edge不要存放关键或敏感数据。路线图还预告了后续计划中的两类集成能力卡片链接 unfurling在 Mattermost 中预览 Focalboard 卡片链接的摘要信息Slash 命令创建卡片通过 Mattermost 的斜杠命令直接新建卡片。这两项能力在仓库中由server目录下的插件适配层支撑——例如 server/ws/plugin_adapter.go 与 server/ws/plugin_adapter_client.go 构成了 Focalboard 以 Mattermost 插件形态运行时的 WebSocket 适配通道从源码结构可以推断卡片创建、实时更新等操作正是通过这套适配层与 Mattermost 端到端打通。三、核心功能规划补齐并完善现有视图路线图的第一大块规划是完成 / 更新现有视图涵盖 Board、Table、Gallery、Card 四种视图。这些视图在当前的 webapp/src/components 目录中均有独立实现目录并配有各自的单元测试与快照测试。3.1 Board 视图看板规划中的两项关键补强是看板导出 / 导入与键盘支持。看板视图的源码实现位于 webapp/src/components/kanban/kanban.tsx从代码结构看它的核心机制是以groupByProperty分组属性驱动列结构每一列对应属性中的一个 optionkanbanColumn.tsx通过onDropToColumn/onDropToCard回调实现拖拽换列、拖拽排序并调用mutator.changePropertyValue与mutator.changeViewCardOrder持久化变更支持隐藏列hiddenGroups、折叠列、列内计算kanbanCalculations以及按defaultTemplateId从模板快速新建卡片。关于导出/导入仓库 webapp/src/archiver.ts 实现了 archive 的导出与导入逻辑服务端对应 server/api/archive.go 提供 API而键盘支持issue #29在后来的迭代中逐步落地为卡片操作快捷键。3.2 Table 视图表格规划条目为分组表格 / 列表视图与键盘支持。Table 视图实现在 webapp/src/components/table 目录其中的 tableGroup.tsx 与 tableGroupHeaderRow.tsx 正是分组表格能力的载体——Table 视图可以根据分组属性把行按组渲染这一能力后来也演化为独立的 List 视图的基础。3.3 Gallery 视图画廊与 Card 视图Gallery 视图在 v0.6.5 版本中作为新特性发布见 《Focalboard v0.6.5 发布说明》用于以矩形网格展示带图片元素的卡片。路线图中对 Gallery 和 Card 的规划主要是各类 bug 修复。当前实现 webapp/src/components/gallery/gallery.tsx 展示了其核心能力按visiblePropertyIds过滤显示属性、通过onDropToCard支持拖拽排序、配合HiddenCardCount显示被过滤隐藏的卡片数量。四、新增视图List、Calendar 与 Pages4.1 List 视图基于 Table 分组的延伸路线图明确说明 List 视图的当前计划是扩展 Table 视图以支持分组而非另起炉灶。这与源码实现吻合Table 目录中的tableGroup系列组件已具备分组渲染能力List 视图正是它的进一步产品化形态。4.2 Calendar 视图按日期属性排布卡片Calendar 视图issue #338的规划在仓库中已落地为完整实现webapp/src/components/calendar/fullCalendar.tsx 基于fullcalendar/react构建结合fullcalendar/daygrid与fullcalendar/interaction插件实现月视图与拖拽交互。从源码结构看通过dateDisplayProperty日期显示属性确定卡片在日历上的位置createDatePropertyFromCalendarDate将日历选择结果转换为DateProperty含from/to起止时间戳拖拽卡片会调用mutator.changePropertyValue更新卡片的日期属性值仅当用户具备Permission.ManageBoardCards权限时才允许新建卡片。4.3 Pages与卡片内容块同构Pages 的规划是基础实现与卡片上的内容块相同并预告了高级内容编辑器issue #166。内容块体系在源码中有清晰定义webapp/src/blocks/block.ts 声明了内容块类型列表[text, image, divider, checkbox, h1, h2, h3, list-item, attachment, quote, video]每种类型都有对应的块组件例如 textBlock.ts、imageBlock.ts、checkboxBlock.ts、dividerBlock.ts 与 attachmentBlock.tsx。Pages 与卡片共享这套内容块体系正是基本实现相同的代码级印证。五、新增属性类型Date、User 与 Multi-select路线图规划了三种新属性类型如今全部已在仓库中实现。属性类型的完整枚举定义在 webapp/src/blocks/board.tstype PropertyTypeEnum text | number | select | multiSelect | date | person | multiPerson | file | checkbox | url | email | phone | createdTime | createdBy | updatedTime | updatedBy | unknown属性类型的注册中心在 webapp/src/properties/index.tsxregistry.register()依次注册了 Text、Number、Email、Phone、Url、Select、MultiSelect、Date、Person、MultiPerson、Checkbox、CreatedTime、CreatedBy、UpdatedTime、UpdatedBy 等类型每种类型对应 webapp/src/properties 下的一个子目录如date/、person/、multiselect/、multiperson/。对照路线图路线图规划当前仓库实现源码位置Date 属性issue #38date/createdTime/updatedTimewebapp/src/properties/dateUser 属性issue #185person/multiperson并衍生createdBy/updatedBywebapp/src/properties/personMulti-selectissue #110multiSelectwebapp/src/properties/multiselect其中 Date 属性在 Calendar 视图中扮演核心角色其from/to时间戳结构直接参与日历事件的生成见 fullCalendar.tsx 中的DateProperty处理逻辑。六、新增内容类型卡片互链路线图规划的链接到另一张卡片issue #324内容类型目标是让卡片之间可以互相引用。这属于内容块Content Block体系的扩展方向。当前内容块类型清单见 webapp/src/blocks/block.ts已包含文本、图片、分割线、复选框、标题、列表项、附件、引用、视频等多种类型卡片互链将作为新的块类型加入这一体系。卡片间的关系在数据层通过 card 的parentId字段关联卡片可以嵌套在卡片内容中这一点在 webapp/src/blocks/card.ts 与 server/model/block.go 的 Block 结构定义中可以找到支撑。七、侧边栏改进与个人仪表盘7.1 侧边栏手动排序与键盘导航路线图规划了侧边栏的手动排序issue #299与键盘导航issue #28。当前侧边栏实现在 webapp/src/components/sidebar 目录包含 13 个 tsx 组件与配套的 scss / snap 快照测试。从组件结构可以推断侧边栏管理着分类Category、看板列表与工作区导航手动排序能力依赖 webapp/src/store 中的状态管理与mutator的持久化写入。7.2 个人仪表盘状态页规划中的 Personal Dashboard 包含一个状态页issue #305作为用户的个人工作总览入口。该能力与后来社区讨论中的个人待办 / 个人项目定位一脉相承——这与 Personal Desktop Edition个人桌面版的场景相呼应桌面端代码位于 mac/Focalboard 与 win-wpf/Focalboard。八、关于视图与数据模型一张视图的完整字段画像理解上述所有视图规划绕不开 Focalboard 的核心数据模型一切皆 Block。视图View本身也是一个 Block其字段结构定义在 webapp/src/blocks/boardView.tstype IViewType board | table | gallery | calendar type BoardViewFields { viewType: IViewType groupById?: string dateDisplayPropertyId?: string sortOptions: ISortOption[] visiblePropertyIds: string[] visibleOptionIds: string[] hiddenOptionIds: string[] collapsedOptionIds: string[] filter: FilterGroup cardOrder: string[] columnWidths: Recordstring, number columnCalculations: Recordstring, string kanbanCalculations: Recordstring, KanbanCalculationFields defaultTemplateId: string }这份字段清单恰好解释了路线图中几乎所有视图相关条目viewType区分 Board / Table / Gallery / Calendar 四种视图类型新增的 List 视图沿用 Table 的分组能力Calendar 视图则额外依赖dateDisplayPropertyIdgroupById驱动看板分组与表格分组对应分组表格 / 列表视图sortOptions、cardOrder分别对应自动排序与手动拖拽排序Gallery 视图中isManualSort activeView.fields.sortOptions.length 0即未配置排序时允许手动排序filterFilterGroup定义于 webapp/src/blocks/filterGroup.ts与visibleOptionIds/hiddenOptionIds支撑视图级筛选与隐藏列visiblePropertyIds决定每张卡片 / 每一行展示哪些属性Kanban 与 Gallery 组件均通过它过滤属性模板。九、参与共建反馈、贡献与后续演进路线图在最后向社区发出两项号召这也是理解 Focalboard 开源协作模式的关键持续反馈特性建议与 Bug 报告是产品方向的重要输入。仓库的 CONTRIBUTING.md 与 pull_request_template.md 提供了完整的贡献流程说明docs/contribution-checklist.md 与 docs/contributions-without-ticket.md 分别给出了合入前检查清单与免工单贡献的说明认领任务社区可以在带有 up for grabs 标签的 issue 中挑选适合自己的任务——仓库的 docs/core-committers.md 也记录了核心提交者的协作机制。从后续发展看这份路线图上的大部分条目都在随后的版本中陆续落地Calendar 视图、Date / Person / Multi-select 属性、导出导入、侧边栏排序等均已出现在当前仓库源码中印证了官方以 80% 用户共需功能为优先的推进节奏。对于希望深入了解 Focalboard 内部实现、或想为开源项目做贡献的开发者这份路线图连同仓库源码尤其是 webapp/src/blocks、webapp/src/properties 与 webapp/src/components 三个目录构成了从产品规划到代码实现的最佳对照读本。【免费下载链接】focalboardFocalboard is an open source, self-hosted alternative to Trello, Notion, and Asana.项目地址: https://gitcode.com/GitHub_Trending/fo/focalboard创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考