# Enterprise Agile Demo Data Guide

**Seeder:** `Database\Seeders\EnterpriseAgileDemoSeeder`  
**Prerequisite:** `Database\Seeders\DemoDataSeeder` (creates ACME company and base users)

---

## Setup

```bash
php artisan migrate
php artisan db:seed --class=DemoDataSeeder
php artisan db:seed --class=EnterpriseAgileDemoSeeder
```

If `DemoDataSeeder` fails with missing `cache` table, run migrations first:

```bash
php artisan migrate --force
```

---

## What Gets Seeded

### Projects (6 scenarios)

| Project | Scenario | Health Profile |
|---------|----------|----------------|
| MV Community App | Healthy | High completion, stable velocity, low risk |
| Customer Portal Refresh | Attention | Moderate blockers, capacity pressure |
| Data Platform Migration | At Risk | Overdue items, elevated risks |
| Mobile SDK Rollout | Delayed | Missed milestones, slipping sprints |
| Internal Tools Suite | Completed | Closed project with historical velocity |
| API Gateway Modernization | Mixed | Cross-team dependencies |

Each project includes:

- Realistic epics and backlog items (no lorem ipsum)
- Sprint participants with capacity allocations
- Active and completed sprints with meaningful velocity/burndown data
- Milestones, risks, and dependencies
- Releases linked to work items
- Cross-project portfolio dependencies

---

## Validation Checklist

After seeding, verify in UI:

1. **Sprints list** — different health badges per project
2. **Sprint planning** — capacity requires participants; zero participants shows warning
3. **Executive dashboard** — bottlenecks, dependencies, forecast accuracy visible
4. **Portfolio** — cross-project dependency count
5. **Reports** — velocity and burndown charts show data for completed/active sprints

---

## Re-running

The seeder is idempotent for the primary demo set:

```
Enterprise agile demo already seeded, skipping.
```

To re-seed, remove enterprise agile projects for ACME or reset the database.

---

## Troubleshooting

| Issue | Fix |
|-------|-----|
| `ACME company not found` | Run `DemoDataSeeder` first |
| Parse error in seeder | Run `php -l database/seeders/EnterpriseAgileDemoSeeder.php` |
| Empty velocity/burndown | Ensure sprint has participants and tickets assigned to participants |
| Zero capacity | Add sprint participants via Sprint Planning → Team panel |