Time Registration 플러그인

:information_source: 요약 Discourse에서 시간 등록을 허용합니다
:hammer_and_wrench: 저장소 링크 https://github.com/communiteq/discourse-time-registration
:open_book: 설치 가이드 Discourse에서 플러그인 설치 방법

Discourse Time Registration

Discourse Time Registration은 Discourse를 위한 가볍고 통합된 시간 추적 솔루션입니다. 특정 주제에 사용된 시간을 추적할 수 있어, 지원 팀, 프리랜서, 또는 토론 컨텍스트 내에서 직접 청구나 시간 회계가 필요한 내부 프로젝트 관리에 이상적입니다.

주요 기능

  • 두 가지 추적 모드:
    • 스톱워치: 주제 작업을 시작할 때 타이머를 시작하고 완료 시 중지합니다.
    • 수동 입력: 작업이 이미 완료된 경우 특정 시간(예: “1시간” 또는 “15분”)을 즉시 기록합니다.
  • 주제 통합: 시간 로그는 주제 스트림 내에서 “작은 액션” 게시물(예: “사용자가 버그 수정에 대해 01:30 작업함”)로 표시되어, 대화와 함께 작업 이력을 시각적으로 보여줍니다.
  • 전체 타이머: 사이트 헤더에 활성 타이머 표시기가 나타나 사용자는 시계가 돌아가는 동안 포럼을 탐색할 수 있고 어디서든 타이머를 중지할 수 있습니다.
  • 스마트 반올림: 청구 계산을 자동화하기 위한 설정 가능한 반올림 규칙(예: 가장 가까운 15분 단위로 올림).
  • 보고서 대시보드: 시간 데이터를 조회하기 위한 전용 인터페이스.

작동 방식

시간 추적

시간 등록은 항상 주제와 연결됩니다.

주제를 볼 때, 권한이 있는 사용자는 헤더 우측 상단에 시간 등록 버튼(시계 아이콘)을 볼 수 있습니다. 이 버튼을 클릭하면 모달이 열리며, 여기서 다음을 수행할 수 있습니다:

  1. 시계 시작: 실시간 카운터를 시작합니다.
  2. 시간 기록: 수동으로 시간(예: 분을 나타내는 “30” 또는 시간/분을 나타내는 “1:30”)과 설명을 즉시 입력할 수 있습니다.

타이머가 중지되면 사용자는 수행한 작업에 대한 설명을 입력하도록 요청받습니다.

이로 인해 주제 내에 작은 액션 게시물이 생성되어 사용자, 설명, 최종 시간을 기록합니다.

image

해당 주제는 타이머가 시작된 주제입니다.

시간 등록은 특정 그룹의 사용자가 수행할 수 있습니다. 시간 등록 게시물은 주제에 접근할 수 있는 모든 사람에게 표시됩니다.

로그 편집

실수는 일어날 수 있습니다. 사용자(또는 관리자)는 기존 시간 등록 게시물을 편집하여 설명이나 시간을 수정할 수 있습니다. 단순히 작은 액션 게시물 위에 마우스를 올리면 연필 아이콘이 나타납니다.
시스템은 자동으로 로그와 보고서 데이터를 업데이트합니다.

보고서

이 플러그인에는 사이드바를 통해 접근할 수 있는 포괄적인 시간 등록 보고서가 포함되어 있습니다.

  • 필터: 날짜 범위, 카테고리, 특정 사용자로 필터링할 수 있습니다.
  • 데이터: 주제, 카테고리(또는 “개인 메시지”), 사용자, 설명, 시간, 날짜가 포함된 테이블을 표시합니다.
  • 합계: 현재 필터를 기반으로 총 사용 시간을 자동으로 계산합니다.

모든 사용자는 볼 수 있는 카테고리에 대한 보고서를 생성할 수 있습니다.

설정

이름 설명
time registration groups 시간 등록을 수행할 수 있는 그룹
time registration rounding interval 등록한 시간을 X분 단위로 반올림
time registration round up at 어디서부터 올림할지 지정

예:

  • 반올림 간격: 10, 올림 기준: 1 → 12가 20이 됨
  • 반올림 간격: 15, 올림 기준: 7.5 → 22가 15가 되고, 23이 30이 됨
23개의 좋아요

아, 정말. 지난 주에 이런 걸 생각하고 있었어요. 내 인스턴스에서는 스태프가 투입한 업무량에 따라 보상을 지급하거든요. 제가 틀린 거면 고쳐주세요. 하지만 이건 SWAPD에 이상적으로 적용될 것 같지 않나요? PM(개인 메시지)까지 추적하나요, 아니면 토픽만 추적하나요?

1개의 좋아요

기술적으로 PM은 주제(topic)입니다.

이것은 자기 보고 방식(self-reporting)이며, 시간을 등록하는 사람은 자신이 소비한 시간을 수정할 수 있습니다.
신뢰가 있다면 잘 작동할 것입니다.

2개의 좋아요

정말 좋습니다! 하지만 현재 Chrome Dev Tools 콘솔에서 다음과 같은 내용이 표시됩니다:

[PLUGIN discourse-time-registration] Deprecation notice: Defining connector classes via registerConnectorClass is deprecated. See https://meta.discourse.org/t/32727 for more modern patterns. [deprecation id: discourse.register-connector-class-legacy]
a	@	deprecated.js:62
p	@	plugin-connectors.js:23
registerConnectorClass	@	plugin-api.gjs:1087
(anonymous)	@	time-registration-route.js:9
eH	@	plugin-api.gjs:3238
initialize	@	api.js:21
(anonymous)	@	app.js:265
(anonymous)	@	index.js:379
e.each	@	index.js:183
e.walk	@	index.js:112
e.each	@	index.js:59
e.topsort	@	index.js:65
_runInitializer	@	index.js:392
runInstanceInitializers	@	index.js:377
_bootSync	@	instance.js:116
didBecomeReady	@	index.js:784
invoke	@	index.js:262
flush	@	index.js:180
flush	@	index.js:334
_end	@	index.js:762
(anonymous)	@	index.js:499
Promise.then		
(anonymous)	@	index.js:18
flush	@	index.js:29
_scheduleAutorun	@	index.js:928
_ensureInstance	@	index.js:919
schedule	@	index.js:618
f	@	index.js:343
waitForDOMReady	@	index.js:512
init	@	index.js:412
_	@	core.js:97
create	@	core.js:599
(anonymous)	@	start-app.js:18
await in (anonymous)		
(anonymous)	@	discourse-boot.js:13
(anonymous)	@	discourse-boot.js:1
2개의 좋아요

보고해 주셔서 감사합니다! 문제가 해결되었습니다.

이제 ‘편집’ 기능을 사용하여 등록 항목의 날짜도 변경할 수 있습니다.

2개의 좋아요

몇 가지 사소한 업데이트를 더 했습니다. 그중 하나는 플러그인이 실수로 기본적으로 활성화되어 있던 것입니다. 플러그인을 사용 중이시라면 업데이트 후 한 번만 수동으로 다시 활성화해 주세요.

3개의 좋아요