# Project Metrics (https://yapl.app/en/docs/user-guides/projects/project-metrics)

# Project Metrics

YAPL provides various metrics to help you track project progress, monitor budget usage, and assess overall project health.

## Dashboard Overview

Access project metrics from the project detail page. The dashboard displays key performance indicators at a glance.

### Key Metrics

| Metric | Description |
|--------|-------------|
| Task Completion | Percentage of completed tasks |
| Timeline Progress | Days elapsed vs. total duration |
| Budget Usage | Spent vs. total budget |
| Team Activity | Recent team actions |

## Task Metrics

### Completion Progress

Track task completion across your plans:

| Metric | Description |
|--------|-------------|
| Total Tasks | All tasks in project plans |
| Completed | Tasks marked complete |
| In Progress | Tasks currently being worked |
| Not Started | Tasks not yet begun |
| Completion Rate | Percentage complete |

### Progress Calculation

Progress can be calculated in different modes:

| Mode | Calculation Method |
|------|-------------------|
| Manual | User-defined percentage |
| Effort-based | Based on hours worked vs. planned |
| Checklist-based | Based on checklist item completion |
| Weighted children | Based on subtask completion |

### Task Status Distribution

View tasks by status:
- **To Do** - Not started
- **In Progress** - Active work
- **In Review** - Pending approval
- **Completed** - Finished
- **Custom statuses** - Workspace-specific

## Timeline Metrics

### Duration Tracking

| Metric | Description |
|--------|-------------|
| Start Date | Project start |
| End Date | Expected completion |
| Total Duration | Days from start to end |
| Days Elapsed | Days since start |
| Days Remaining | Days until end |

### Timeline Health

Indicators show if project is:
- **On Track** - Progress matches timeline
- **Behind** - Progress lagging timeline
- **Ahead** - Progress exceeding timeline
- **Overdue** - Past end date

### Timeline Visualization

The project overview may include:
- Progress bar showing timeline position
- Milestone markers
- Key date indicators

## Budget Metrics

<Callout type="info">
Full budget tracking requires Professional tier subscription.
</Callout>

### Budget Overview

| Metric | Description |
|--------|-------------|
| Total Budget | Planned project budget |
| Spent | Amount used |
| Remaining | Budget left |
| Usage Rate | Percentage used |

### Budget Health

Budget status indicators:
- **Under Budget** - Spending below plan
- **On Budget** - Spending matches plan
- **Over Budget** - Spending exceeds plan

### Cost Metrics (Professional)

Advanced cost tracking includes:
- Resource costs
- Task-level cost tracking
- Cash flow analysis
- S-Curve visualization

## Plan Metrics

### Plan Coverage

| Metric | Description |
|--------|-------------|
| Total Plans | Number of project plans |
| Active Plans | Plans in progress |
| Published Plans | Finalized versions |
| Draft Plans | Work in progress |

### Plan Health

For each plan:
- Task completion rate
- Resource utilization
- Critical path status
- Version information

## Team Metrics

### Team Involvement

| Metric | Description |
|--------|-------------|
| Assigned Teams | Teams with project access |
| Total Members | Members across assigned teams |
| Active Members | Members with recent activity |

### Activity Tracking

Team activity metrics:
- Recent actions by members
- Task assignments
- Updates and changes
- Comments and notes

## Activity Metrics

### Recent Activity

Track recent project changes:
- Task updates
- Status changes
- Resource assignments
- Plan modifications

### Activity Timeline

View chronological activity:
- Who made changes
- What was changed
- When changes occurred

## Viewing Metrics

### Project Dashboard

Access comprehensive metrics:

1. Open the project
2. View **Overview** tab
3. Explore metrics cards and charts

### Quick Stats

Quick statistics typically shown:
- Task completion percentage
- Timeline status
- Budget usage (if applicable)
- Recent activity count

### Detailed Views

For deeper analysis:
- Click on metric cards for details
- Use filters to focus on specific data
- Export data for external analysis

## Metric Cards

### Understanding Metric Cards

Each metric card displays:
- Primary metric value
- Comparison or context
- Trend indicator (if applicable)
- Link to detailed view

### Common Cards

| Card | Shows |
|------|-------|
| Tasks | Completion rate and status breakdown |
| Timeline | Progress and remaining time |
| Budget | Usage and remaining funds |
| Activity | Recent changes count |
| Teams | Member count and involvement |

## Metrics Refresh

### Update Frequency

Metrics update:
- Real-time for most data
- Aggregated data may have slight delay
- Refresh page for latest

### Manual Refresh

To ensure latest data:
1. Use refresh button if available
2. Refresh browser page
3. Navigate away and back

## Using Metrics

### Progress Monitoring

Use metrics to:
- Track daily/weekly progress
- Identify bottlenecks
- Forecast completion
- Report to stakeholders

### Decision Making

Metrics help with:
- Resource allocation
- Timeline adjustments
- Budget reallocation
- Team assignments

### Communication

Share metrics for:
- Status updates
- Stakeholder reports
- Team meetings
- Client communications

## Best Practices

### Regular Review

- Check metrics daily or weekly
- Note trends over time
- Address issues early

### Accurate Data

- Keep task statuses current
- Log time and costs accurately
- Update progress regularly

### Context

- Consider metrics in context
- Don't rely on single metrics
- Look at trends, not snapshots

## Troubleshooting

### Metrics Not Updating

- Refresh the page
- Verify data was saved
- Check for system delays

### Unexpected Values

- Verify underlying data
- Check calculation settings
- Review recent changes

### Missing Metrics

- Some metrics require Professional tier
- Check subscription features
- Verify project has data to display

## Related Topics

- [Project Settings](/docs/user-guides/projects/project-settings) - Configuration
- [Project Lifecycle](/docs/user-guides/projects/project-lifecycle) - Status management
- [Plans](/docs/user-guides/plans) - Schedule management
- [Tasks](/docs/user-guides/tasks) - Task management