# Project Compass

Project Compass is a project-management app built on a small PHP MVC framework.

## Features

- portfolio dashboard
- project cards with progress, budget, and risk status
- Kanban-style project boards
- task creation and status changes
- activity feed
- SQLite storage with migrations and seed data

## Run locally

```bash
php scripts/migrate.php up
php scripts/seed_projects.php --reset
php -S localhost:8000 -t public
```

Then open:

```text
http://localhost:8000/
```

## Useful routes

- `/` — dashboard
- `/projects` — project index
- `/projects/create` — new project form
- `/projects/{id}` — project board
- `/activity` — activity feed

## CLI helpers

```bash
php scripts/migrate.php status
php scripts/migrate.php fresh --seed
php scripts/seed_projects.php 6
```

## Framework flow

See `docs/REQUEST_FLOW.md` for a chart of how requests and responses move through the framework.