metrics/.env.example at main · clutcher/metrics · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
# ==================================================
# BASIC CONFIGURATION
# ==================================================

# Task tracker selection: 'jira' or 'azure'
METRICS_TASK_TRACKER=azure

# Azure DevOps Configuration
METRICS_AZURE_ORGANIZATION_URL=https://dev.azure.com/your-org
METRICS_AZURE_PAT=your-personal-access-token
METRICS_AZURE_PROJECT=YourProject

# JIRA Configuration
METRICS_JIRA_SERVER_URL=https://your-company.atlassian.net
METRICS_JIRA_EMAIL=your-email@company.com
METRICS_JIRA_API_TOKEN=your-api-token

# Project filtering (JSON array format)
METRICS_PROJECT_KEYS=["PROJ", "TEAM"]

# JIRA Story Points Custom Field ID (find in JIRA field configuration)
METRICS_STORY_POINT_CUSTOM_FIELD_ID=customfield_10016

# Team members configuration (JSON format)
METRICS_MEMBERS={"John Doe": {"level": "senior", "member_groups": ["Team A"], "stages": ["Development"]}, "Jane Smith": {"level": "middle", "member_groups": ["Team B"], "stages": ["Validation"]}}

# Custom query filters per member group (JSON format)
# Replaces default assignee-based filtering with custom JQL/query for specific member groups
# JIRA example - filter by parent epic:
# METRICS_MEMBER_GROUP_CUSTOM_FILTERS='{"TeamA": "parent in (PROJ-123, PROJ-456)"}'
# Azure example - filter by parent work items:
# METRICS_MEMBER_GROUP_CUSTOM_FILTERS='{"TeamB": "[System.Parent] IN (174641, 176747)"}'

# Merge unassigned tasks into filtered member group (default: false)
# When enabled and filtering by a specific member group, tasks labeled "Unassigned"
# are relabeled under that member group's header instead of appearing separately
# METRICS_MERGE_UNASSIGNED_INTO_FILTERED_GROUP=false

# ==================================================
# WORKFLOW STATUS CONFIGURATION
# ==================================================

# Customize status mappings to match your workflow
METRICS_IN_PROGRESS_STATUS_CODES=["Analysis", "Active", "In Progress", "In Development", "QA", "Validation", "Testing", "Review"]
METRICS_PENDING_STATUS_CODES=["Blocked", "On Hold", "Pending", "Waiting"]
METRICS_DONE_STATUS_CODES=["Done", "Closed", "Resolved"]

# Workflow stages configuration (JSON format)
METRICS_STAGES={"Analysis": ["Analysis"], "Development": ["Active", "In Progress", "In Development", "Review"], "Validation": ["QA", "Validation", "Testing"], "Recently Finished": ["Done", "Closed", "Resolved"], "Pending": ["Blocked", "On Hold", "Pending", "Waiting"]}

# Stage-specific sorting configuration (optional)
# Maps stage names to custom sort criteria (overrides default sorting)
# Format: {"Stage Name": "comma-separated-criteria"}
# Supported criteria: priority, assignee, health, spent_time
# Use '-' prefix for descending order (e.g., "-health" for worst health first)
# No prefix means ascending order (e.g., "priority" for priority 1, 2, 3...)
# Example: {"Ready for Dev": "priority,assignee,-health,-spent_time"}
METRICS_STAGE_SORT_OVERRIDES={}

# Default sorting criteria for stages without specific overrides
# Applied to all stages unless overridden by METRICS_STAGE_SORT_OVERRIDES
# Default: "-health,-spent_time" (worst health first, then most time spent)
METRICS_DEFAULT_SORT_CRITERIA=-health,-spent_time

# ==================================================
# PERFORMANCE & CALCULATION SETTINGS
# ==================================================

# Working days and capacity settings
METRICS_WORKING_DAYS_PER_MONTH=22
METRICS_IDEAL_HOURS_PER_DAY=4.0
METRICS_STORY_POINTS_TO_IDEAL_HOURS_CONVERTION_RATIO=1.0

# Recently finished tasks lookback period (days)
METRICS_RECENTLY_FINISHED_TASKS_DAYS=14

# Seniority level velocity multipliers (JSON format)
METRICS_SENIORITY_LEVELS={"senior": 1.0, "middle": 2.0, "junior": 4.0}

# Velocity calculation settings
METRICS_DEFAULT_VELOCITY_TIME_UNIT=DAY

# ==================================================
# FILTERING OPTIONS
# ==================================================

# Global filters applied to both current tasks and velocity pages
# METRICS_GLOBAL_TASK_TYPES_FILTER=["Story", "Task", "Bug"]
# METRICS_GLOBAL_TEAM_FILTER=["Flow Team", "Backend Team"]

# ==================================================
# DEFAULT/FALLBACK VALUES
# ==================================================

# Values used when data is missing or incomplete
# METRICS_DEFAULT_STORY_POINTS_VALUE_WHEN_MISSING=3
METRICS_DEFAULT_SENIORITY_LEVEL_WHEN_MISSING=middle
METRICS_DEFAULT_HEALTH_STATUS_WHEN_MISSING=GREEN
# METRICS_MEMBER_GROUP_WHEN_MISSING=Unassigned

# ==================================================
# DEPLOYMENT CONFIGURATION
# ==================================================

# Application deployment settings
# METRICS_BASE_URL=some/url/prefix
# METRICS_BASIC_AUTH_USERS={"username": "password"}