1Panel-Appstore/apps/focalboard/README.md

使用说明

默认以SQLite数据库模式运行，

需要以postgres数据库运行的，需要修改目录下的postgres-config.json里的数据库信息

且修改docker-compose.yml文件里的配置映射。

原始相关

⚠️ 通告：请阅读 ⚠️

Focalboard 个人服务器和个人桌面版将从 2023 年 4 月 30 日起完全转为社区支持。此 Focalboard 仓库将成为个人版仓库，并将无限期保持开放。然而，我们不会添加任何新功能，并且仅在 2023 年 4 月 30 日之前解决 Sev-1 级别的错误。

Focalboard

喜欢你所看到的吗？ 👀 给我们一个 GitHub Star！ ⭐

Focalboard 是一个开源的多语言自托管项目管理工具，是 Trello、Notion 和 Asana 的替代品。

它有助于定义、组织、跟踪和管理个人和团队之间的工作。Focalboard 有三个版本：

• Mattermost Boards：与 Mattermost 平台集成，以便您的团队进行计划和协作。

• 个人桌面 ：一个独立的一用户 macOS、Windows 或 Linux 桌面应用程序，用于您自己的待办事项和个人项目。

• 个人服务器 ：一款独立的多用户服务器，适用于开发和个人使用。

尝试 Focalboard

Mattermost Boards

Mattermost Boards 将项目管理工具与消息传递和协作结合在一起，适用于所有规模的组织。要访问和使用 Mattermost Boards，请安装或升级到 Mattermost v6.0 或更高版本作为自托管服务器 。登录 Mattermost 后，选择左上角的菜单，然后选择 Boards。

个人桌面（Windows、Mac 或 Linux 桌面）

• Windows：从 Windows 应用商店下载或从最新版本下载 focalboard-win.zip，解压后运行 Focalboard.exe。
• Mac：从 Mac 应用商店下载。
• Linux 桌面 ：从最新版本下载 focalboard-linux.tar.gz，解压后打开 focalboard-app。

个人服务器

Ubuntu：您可以通过遵循我们最新的安装指南下载并运行编译好的 Focalboard 个人服务器 。

API 文档

Boards API 文档可以在 https://htmlpreview.github.io/?https://github.com/mattermost/focalboard/blob/main/server/swagger/docs/html/index.html 找到。

为 Focalboard 做出贡献

对于任何有兴趣成为 Focalboard 仓库官方维护者的人来说，请通过我们的 Focalboard 社区频道联系我们。如果没有维护者，而你仍然有兴趣为 Focalboard 个人版添加自己的改进，我们鼓励你进行分支并维护该仓库。

入门指南

我们的开发者指南详细说明了如何为个人服务器设置你的开发环境。它还提供了更多关于为我们的开源社区做出贡献的信息。

将 mattermost-server 克隆到同级目录。

在 focalboard 目录下创建一个 .env 文件，其中包含：

EXCLUDE_ENTERPRISE="1"

构建服务器：

make prebuild
make

运行服务器：

 ./bin/focalboard-server

然后，在浏览器中导航到 http://localhost:8000 以访问您的 Focalboard 服务器。端口号配置在 config.json 中。

一旦服务器运行，您可以在另一个终端窗口中通过 make webapp 重新构建仅网页应用。重新加载浏览器以查看更改。

构建和运行独立桌面应用

您可以构建包含服务器的独立应用，以便在本地针对 SQLite 运行：

• Windows：
  • 需要 Windows 10，Windows 10 SDK 10.0.19041.0，以及.NET 4.8 开发者包
  • 打开一个 git-bash 提示符。
  • 运行 make prebuild
  • 上述预构建步骤仅在您对项目进行更改或想要安装 npm 依赖项等时需要运行。
  • 一旦预构建完成，您可以重复以下步骤来构建应用程序并查看更改。
  • 运行 make win-wpf-app
  • Run cd win-wpf/msix && focalboard.exe
• Mac：
  • 需要 macOS 11.3+ 和 Xcode 13.2.1+
  • 运行 make prebuild
  • 上述预构建步骤仅在您对项目进行更改或想要安装 npm 依赖项等时需要运行。
  • 预构建完成后，您可以重复以下步骤来构建应用程序并查看更改。
  • 运行 make mac-app
  • 运行 open mac/dist/Focalboard.app
• Linux:
  • 在 Ubuntu 18.04 上测试过
  • 安装 webgtk 依赖
    • Run sudo apt-get install libgtk-3-dev
    • Run sudo apt-get install libwebkit2gtk-4.0-dev
  • 运行 make prebuild
  • 上述预构建步骤仅在您对项目进行更改或想要安装 npm 依赖项等时需要运行。
  • 预构建完成后，您可以重复以下步骤来构建应用程序并查看更改。
  • 运行 make linux-app
  • 解压 linux/dist/focalboard-linux.tar.gz 到您选择的目录
  • 从您选择的目录运行 focalboard-app
• Docker:
  • 要从官方镜像本地运行它：
    • docker run -it -p 80:8000 mattermost/focalboard
  • 为构建适用于您当前架构：
    • docker build -f docker/Dockerfile .
  • 为构建适用于自定义架构（实验性）：
    • docker build -f docker/Dockerfile --platform linux/arm64 .

交叉编译目前尚未完全支持，请在该平台上进行构建。请参考 GitHub Actions 工作流程（build-mac.yml、build-win.yml、build-ubuntu.yml）以获取每个平台的详细步骤列表。

单元测试

在提交检查之前，运行 make ci，这与 .gitlab-ci.yml 工作流程类似，包括：

• 服务器单元测试 ：make server-test
• Web 应用 ESLint：cd webapp; npm run check
• Web 应用单元测试 ：cd webapp; npm run test
• Web 应用 UI 测试 : cd webapp; npm run cypress:ci

翻译中

帮助翻译 Focalboard！该应用已翻译成多种语言。我们欢迎更正和新语言翻译！您可以在 Weblate 添加新语言或改进现有翻译。

保持信息更新

• 变更 ：查看最新的更新请参阅变更日志
• GitHub 讨论区 ：加入开发者讨论板块
• 错误报告 ： 提交错误报告
• 聊天 ：加入 Focalboard 社区频道