Project_Compass/docs/README.md

Project Compass PHP

A small PHP MVC app for managing projects, tasks, and activity.

Run

composer install
php scripts/migrate.php up
php scripts/seed_projects.php --reset
php -S localhost:8000 -t public

Open:

http://localhost:8000/

Request Flow

Browser → public/index.php → Request → Dispatcher → Router → Route → Controller → Repository → View → Response

Main Folders

• core/ framework classes
• app/Controllers/ application controllers
• app/Repositories/ data access classes
• app/Views/ PHP templates
• routes/web.php route definitions
• database/migrations/ migrations
• database/seed_projects.php sample data loader
• scripts/ runnable PHP CLI scripts

SQLite

The default database is SQLite and points to:

database/app.sqlite

Run migrations from the PHP CLI:

php scripts/migrate.php up
php scripts/migrate.php down
php scripts/migrate.php status
php scripts/migrate.php make create_project_management_tables
php scripts/migrate.php fresh
php scripts/migrate.php fresh --seed
php scripts/seed_projects.php 6

Flow chart

See REQUEST_FLOW.md for the request/response flow chart.