thekevjames/mosura Docker Image Overview

thekevjames/mosura

Mosura是一个定制化的任务管理前端，旨在提供简化的任务管理体验，支持与Jira集成，具备最小化界面和个性化工作流，确保团队使用无冲突且仅展示必要功能。

0 次下载

🙃 代码没问题，结果发布失败在拉镜像

中文简介版本下载

🙃 代码没问题，结果发布失败在拉镜像

Mosura 镜像文档

镜像概述和主要用途

Mosura是一个定制化的任务管理前端，设计目标包括：使用无冲突（团队中使用和不使用Mosura的成员可共存）、最小化视图（不使用的功能不会占用界面或拖慢操作）、个性化工作流（提供简化体验，去除非必要功能）。主要用于与Jira集成，帮助用户高效管理任务、查看任务时间线及跟踪OKR等。

核心功能和特性

使用无冲突：团队成员使用Mosura不会与不使用的成员产生冲突
最小化界面：仅展示必要功能，避免界面臃肿，提升操作效率
个性化工作流：提供简化的任务管理流程，专注核心功能
Jira集成：支持连接Jira实例，获取并管理任务数据
任务时间线：根据任务的开始日期和预估时间，在时间线上可视化展示任务
任务状态高亮：对无组件、无标签或状态为"Needs Triage"的任务进行高亮提示

使用场景和适用范围

适用于需要简化任务管理界面、与Jira集成的团队或个人；尤其适合希望通过最小化界面提升效率、关注任务时间线和OKR跟踪的用户场景。

使用方法和配置说明

前提条件

使用前需创建Jira API令牌，可通过Atlassian API令牌管理页面生成。

Docker部署示例

推荐通过Docker/Podman等容器工具运行：

console
docker run -d \
    --name=mosura \
    -p 8080:8080 \  # 端口映射（主机端口:容器端口）
    -v /path/to/appdata:/data \  # 挂载数据卷（本地目录:容器内目录）
    -e JIRA_AUTH_TOKEN=mytoken*** \  # 必填，Jira API令牌
    -e JIRA_AUTH_USER=*** \  # 必填，Jira认证用户***
    -e JIRA_DOMAIN=[***] \  # 必填，Jira实例域名
    -e JIRA_LABEL_OKR=okr \  # 可选，OKR标签，默认：okr
    -e JIRA_PROJECT=MOS \  # 必填，Jira项目键
    -e JIRA_TEAM='1234-5678' \  # 可选，团队ID
    -e JIRA_OTHER_PROJECTS='ASDF,FDSA' \  # 可选，其他项目键（逗号分隔）
    -e MOSURA_APPDATA=/data \  # 可选，应用数据目录，默认：.
    -e MOSURA_HEADER_USER_EMAIL=X-Token-User-Email \  # 必填，HTTP头中用户***字段
    -e MOSURA_PORT=8080 \  # 可选，服务监听端口，默认：8080
    --restart unless-stopped \
    quay.io/thekevjames/mosura:latest

开发模式运行

本地开发环境运行方法：

console
# 导出必要环境变量（参考Docker部署的环境变量配置）
export JIRA_AUTH_TOKEN=mytoken***
export JIRA_AUTH_USER=***
export JIRA_DOMAIN=[***]
export JIRA_PROJECT=MOS
export MOSURA_HEADER_USER_EMAIL=X-Token-User-Email
export MOSURA_USER=...  # 可选，强制指定用户（无需认证）

# 安装依赖并启动服务
poetry install --sync
poetry run uvicorn mosura.app:app --reload

开发模式下可添加额外环境变量：

PYTHONDEVMODE=1：启用Python开发模式
PYTHONWARNINGS=error：将警告视为错误
MOSURA_POLL_INTERVAL_OPEN=60：开放任务轮询间隔（秒）
MOSURA_POLL_INTERVAL_CLOSED=600：关闭任务轮询间隔（秒）

环境变量配置说明

环境变量	描述	是否必填	默认值
`JIRA_AUTH_TOKEN`	Jira API令牌	是	-
`JIRA_AUTH_USER`	Jira认证用户***	是	-
`JIRA_DOMAIN`	Jira实例域名（如[***]	是	-
`JIRA_PROJECT`	Jira项目键	是	-
`JIRA_LABEL_OKR`	OKR标签（用于标识OKR任务）	否	`okr`
`JIRA_TEAM`	团队ID	否	-
`JIRA_OTHER_PROJECTS`	其他项目键（逗号分隔）	否	-
`MOSURA_APPDATA`	应用数据目录	否	`.`
`MOSURA_HEADER_USER_EMAIL`	HTTP请求头中用户***的字段名	是	-
`MOSURA_PORT`	服务监听端口	否	`8080`

Jira任务字段要求

Mosura对Jira任务字段有以下假设，以确保功能正常：

key：任务键（如MOS-123）
summary：任务标题
description：任务详细描述
status：任务状态，其中"Needs Triage"在任务列表中高亮（红色），"In Progress"/"Code Review"在时间线中显示为黄色，"Closed"仅在图表中显示为红色且不在其他页面可见
priority：任务优先级（"Low"/"Medium"/"High"/"Urgent"显示特殊图标）
assignee：任务负责人，若与配置的Jira凭据匹配，会显示在"我的任务"页面
customfield_***：开始日期（Start Date），结合"Original estimate"（预估时间），若时间跨度在过去几周至未来几个月内，会显示在时间线上
components：任务组件列表，无组件的任务会高亮提示需关注
labels：任务标签列表，无标签的任务会高亮提示需关注；匹配OKR标签（默认okr）的任务会显示在时间线页面
votes：任务投票用户集合
Original estimate：任务预估时间，结合开始日期用于时间线展示