diff --git a/README.md b/README.md new file mode 100644 index 0000000..8f233d7 --- /dev/null +++ b/README.md @@ -0,0 +1,42 @@ +# 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 +``` diff --git a/app/Controllers/EmployeeController.php b/app/Controllers/EmployeeController.php deleted file mode 100644 index 6ff7eae..0000000 --- a/app/Controllers/EmployeeController.php +++ /dev/null @@ -1,208 +0,0 @@ -buildViewModel((string) $request->input('search', '')); - $viewModel->saved = $request->input('saved') === '1'; - - return $this->view('employees.create', [ - 'model' => $viewModel, - 'pageTitle' => $viewModel->title, - ]); - } - - public function store() - { - $request = Request::capture(); - $form = $this->sanitizeFormData($request); - $errors = $this->validateForm($form, $request); - - if (empty($errors) && $this->employees()->findByEmail($form['email']) !== null) { - $errors['email'][] = 'That email address is already in use.'; - } - - if (!empty($errors)) { - $viewModel = $this->buildViewModel(); - $viewModel->form = $form; - $viewModel->errors = $errors; - - if ($this->isHtmxRequest($request)) { - return $this->fragment('employees.partials.form', [ - 'model' => $viewModel, - ]); - } - - return $this->view('employees.create', [ - 'model' => $viewModel, - 'pageTitle' => $viewModel->title, - ]); - } - - $employee = new Employee(); - $employee->firstName = $form['first_name']; - $employee->lastName = $form['last_name']; - $employee->email = $form['email']; - $employee->department = $form['department']; - $employee->jobTitle = $form['job_title']; - $employee->startDate = $form['start_date']; - - $this->employees()->create($employee); - - if ($this->isHtmxRequest($request)) { - $viewModel = $this->buildViewModel(); - $viewModel->saved = true; - - return $this->fragment('employees.partials.form', [ - 'model' => $viewModel, - ], 200, [ - 'HX-Trigger' => json_encode(['employees-changed' => true]), - ]); - } - - return $this->redirect('/employees?saved=1'); - } - - public function create() - { - return $this->redirect('/employees'); - } - - public function summary() - { - $request = Request::capture(); - $viewModel = $this->buildViewModel((string) $request->input('search', '')); - - return $this->fragment('employees.partials.summary', [ - 'model' => $viewModel, - ]); - } - - public function data() - { - $request = Request::capture(); - $search = trim((string) $request->input('search', '')); - $rows = $this->employees()->search($search); - - $data = array_map( - static function (array $row): array { - return [ - 'id' => (int) $row['id'], - 'full_name' => trim($row['first_name'] . ' ' . $row['last_name']), - 'first_name' => (string) $row['first_name'], - 'last_name' => (string) $row['last_name'], - 'email' => (string) $row['email'], - 'department' => (string) $row['department'], - 'job_title' => (string) $row['job_title'], - 'start_date' => (string) $row['start_date'], - 'created_at' => (string) $row['created_at'], - ]; - }, - $rows - ); - - return $this->json($data); - } - - /** - * @return array - */ - private function sanitizeFormData(Request $request): array - { - return [ - 'first_name' => trim((string) $request->input('first_name', '')), - 'last_name' => trim((string) $request->input('last_name', '')), - 'email' => trim((string) $request->input('email', '')), - 'department' => trim((string) $request->input('department', '')), - 'job_title' => trim((string) $request->input('job_title', '')), - 'start_date' => trim((string) $request->input('start_date', '')), - ]; - } - - /** - * @param array $form - * @return array> - */ - private function validateForm(array $form, Request $request): array - { - $validator = new Validator(); - - $validator - ->required('first_name', $form['first_name'], 'First name is required.') - ->maxLength('first_name', $form['first_name'], 100, 'First name must be 100 characters or fewer.') - ->required('last_name', $form['last_name'], 'Last name is required.') - ->maxLength('last_name', $form['last_name'], 100, 'Last name must be 100 characters or fewer.') - ->required('email', $form['email'], 'Email is required.') - ->maxLength('email', $form['email'], 255, 'Email must be 255 characters or fewer.') - ->required('department', $form['department'], 'Department is required.') - ->maxLength('department', $form['department'], 100, 'Department must be 100 characters or fewer.') - ->required('job_title', $form['job_title'], 'Job title is required.') - ->maxLength('job_title', $form['job_title'], 150, 'Job title must be 150 characters or fewer.') - ->required('start_date', $form['start_date'], 'Start date is required.'); - - $errors = $validator->errors(); - - if (!verify_csrf_token((string) $request->input('_token', ''))) { - $errors['_token'][] = 'Your form session expired. Please refresh the page and try again.'; - } - - if ($form['email'] !== '' && filter_var($form['email'], FILTER_VALIDATE_EMAIL) === false) { - $errors['email'][] = 'Enter a valid email address.'; - } - - if ($form['start_date'] !== '' && !$this->isValidDate($form['start_date'])) { - $errors['start_date'][] = 'Enter a valid start date.'; - } - - return $errors; - } - - private function isValidDate(string $value): bool - { - $date = \DateTimeImmutable::createFromFormat('Y-m-d', $value); - - return $date !== false && $date->format('Y-m-d') === $value; - } - - private function employees(): EmployeeRepository - { - return new EmployeeRepository(database()); - } - - private function isHtmxRequest(Request $request): bool - { - return strtolower((string) $request->server('HTTP_HX_REQUEST', '')) === 'true'; - } - - private function buildViewModel(string $search = ''): EmployeeFormViewModel - { - $viewModel = new EmployeeFormViewModel(); - $viewModel->search = trim($search); - - $employees = $this->employees()->search($viewModel->search); - $newestEmployee = $this->employees()->newestMatching($viewModel->search); - - $viewModel->employees = array_slice($employees, 0, 5); - $viewModel->newestEmployee = $newestEmployee; - $viewModel->summary = [ - 'employee_count' => $this->employees()->countMatching($viewModel->search), - 'department_count' => $this->employees()->countDepartments($viewModel->search), - 'latest_start_date' => $newestEmployee['start_date'] ?? 'N/A', - ]; - - return $viewModel; - } -} diff --git a/app/Controllers/HomeController.php b/app/Controllers/HomeController.php index 230df0d..d6624b6 100644 --- a/app/Controllers/HomeController.php +++ b/app/Controllers/HomeController.php @@ -4,29 +4,38 @@ declare(strict_types=1); namespace App\Controllers; -use App\ViewModels\HomeIndexViewModel; +use App\Repositories\ActivityRepository; +use App\Repositories\ProjectRepository; +use App\Repositories\TaskRepository; use Core\Controller; class HomeController extends Controller { public function index() { - $model = new HomeIndexViewModel(); - $model->title = 'MindVisionCode PHP'; - $model->eyebrow = 'Small MVC framework'; - $model->message = 'A lightweight PHP MVC starter with a central dispatcher, clean controllers, SQLite-backed repositories, and readable conventions.'; - $model->routeExample = '/employees'; + $projects = new ProjectRepository(); + $tasks = new TaskRepository(); + $activities = new ActivityRepository(); return $this->view('home.index', [ - 'model' => $model, - 'pageTitle' => $model->title, + 'pageTitle' => 'Project Compass', + 'summary' => $projects->dashboardSummary(), + 'featuredProjects' => $projects->recent(5), + 'dueSoon' => $tasks->dueSoon(6), + 'overdue' => $tasks->overdue(4), + 'activity' => $activities->recent(8), ]); } - public function user(string $id) + public function activity() { - return $this->json([ - 'userId' => $id, + $activities = new ActivityRepository(); + $projects = new ProjectRepository(); + + return $this->view('home.activity', [ + 'pageTitle' => 'Activity feed', + 'activity' => $activities->recent(30), + 'projects' => $projects->recent(8), ]); } } diff --git a/app/Controllers/ProjectController.php b/app/Controllers/ProjectController.php new file mode 100644 index 0000000..30df031 --- /dev/null +++ b/app/Controllers/ProjectController.php @@ -0,0 +1,209 @@ +input('search', '')); + $status = trim((string) request()->input('status', '')); + + $repository = new ProjectRepository(); + + return $this->view('projects.index', [ + 'pageTitle' => 'Projects', + 'projects' => $repository->all($search, $status), + 'summary' => $repository->dashboardSummary(), + 'search' => $search, + 'status' => $status, + 'statusOptions' => self::STATUS_OPTIONS, + ]); + } + + public function create() + { + return $this->view('projects.create', [ + 'pageTitle' => 'Create project', + 'statusOptions' => self::STATUS_OPTIONS, + 'old' => $this->defaultProjectForm(), + 'errors' => [], + ]); + } + + public function store() + { + $this->requirePost(request()); + + if (!verify_csrf_token((string) request()->input('_token'))) { + return $this->renderCreateWithErrors([ + '_token' => ['The security token expired. Refresh the page and try again.'], + ], $this->defaultProjectForm(request()->all())); + } + + $data = $this->projectDataFromRequest(); + $errors = $this->validateProject($data); + + if ($errors !== []) { + return $this->renderCreateWithErrors($errors, $data); + } + + $projectId = (new ProjectRepository())->create($data); + + return $this->redirect('/projects/' . $projectId); + } + + public function show(string $id) + { + $projectId = (int) $id; + $repository = new ProjectRepository(); + $project = $repository->findBoard($projectId); + + if ($project === null) { + return \Core\Response::notFound('Project not found.'); + } + + return $this->view('projects.show', [ + 'pageTitle' => $project['name'], + 'project' => $project, + 'taskStatusOptions' => self::TASK_STATUS_OPTIONS, + 'priorityOptions' => self::PRIORITY_OPTIONS, + 'activity' => (new ActivityRepository())->forProject($projectId, 12), + 'taskErrors' => [], + 'taskOld' => $this->defaultTaskForm(), + ]); + } + + public function updateStatus(string $id) + { + $this->requirePost(request()); + + if (!verify_csrf_token((string) request()->input('_token'))) { + return $this->redirect('/projects/' . (int) $id . '?error=token'); + } + + $status = trim((string) request()->input('status', '')); + + if (!in_array($status, self::STATUS_OPTIONS, true)) { + return $this->redirect('/projects/' . (int) $id . '?error=status'); + } + + (new ProjectRepository())->updateStatus((int) $id, $status); + + return $this->redirect('/projects/' . (int) $id . '?updated=1'); + } + + private function renderCreateWithErrors(array $errors, array $old) + { + return $this->view('projects.create', [ + 'pageTitle' => 'Create project', + 'statusOptions' => self::STATUS_OPTIONS, + 'errors' => $errors, + 'old' => array_merge($this->defaultProjectForm(), $old), + ]); + } + + private function defaultProjectForm(array $input = []): array + { + return [ + 'name' => (string) ($input['name'] ?? ''), + 'code' => (string) ($input['code'] ?? ''), + 'client_name' => (string) ($input['client_name'] ?? ''), + 'description' => (string) ($input['description'] ?? ''), + 'status' => (string) ($input['status'] ?? 'planned'), + 'start_date' => (string) ($input['start_date'] ?? date('Y-m-d')), + 'due_date' => (string) ($input['due_date'] ?? ''), + 'budget_cents' => (string) ($input['budget_cents'] ?? '0'), + 'owner_name' => (string) ($input['owner_name'] ?? ''), + 'color_token' => (string) ($input['color_token'] ?? 'teal'), + 'members_text' => (string) ($input['members_text'] ?? ''), + ]; + } + + private function defaultTaskForm(array $input = []): array + { + return [ + 'title' => (string) ($input['title'] ?? ''), + 'description' => (string) ($input['description'] ?? ''), + 'priority' => (string) ($input['priority'] ?? 'normal'), + 'status' => (string) ($input['status'] ?? 'backlog'), + 'assignee' => (string) ($input['assignee'] ?? ''), + 'estimate_hours' => (string) ($input['estimate_hours'] ?? ''), + 'due_date' => (string) ($input['due_date'] ?? ''), + ]; + } + + private function projectDataFromRequest(): array + { + $input = request()->all(); + + return [ + 'name' => trim((string) ($input['name'] ?? '')), + 'code' => trim((string) ($input['code'] ?? '')), + 'client_name' => trim((string) ($input['client_name'] ?? '')), + 'description' => trim((string) ($input['description'] ?? '')), + 'status' => trim((string) ($input['status'] ?? 'planned')), + 'start_date' => trim((string) ($input['start_date'] ?? '')), + 'due_date' => trim((string) ($input['due_date'] ?? '')), + 'budget_cents' => max(0, (int) preg_replace('/[^0-9]/', '', (string) ($input['budget_cents'] ?? '0'))), + 'owner_name' => trim((string) ($input['owner_name'] ?? '')), + 'color_token' => trim((string) ($input['color_token'] ?? 'teal')), + 'members' => $this->parseMembers((string) ($input['members_text'] ?? '')), + 'members_text' => (string) ($input['members_text'] ?? ''), + ]; + } + + private function validateProject(array $data): array + { + $validator = new Validator(); + + $validator->required('name', $data['name'], 'Project name is required.')->maxLength('name', $data['name'], 120); + $validator->required('client_name', $data['client_name'], 'Client name is required.')->maxLength('client_name', $data['client_name'], 120); + $validator->required('owner_name', $data['owner_name'], 'Project owner is required.')->maxLength('owner_name', $data['owner_name'], 120); + $validator->required('description', $data['description'], 'Project summary is required.')->maxLength('description', $data['description'], 800); + $validator->required('status', $data['status'], 'Choose a project status.'); + $validator->required('start_date', $data['start_date'], 'Start date is required.'); + + if ($data['due_date'] !== '' && !preg_match('/^\d{4}-\d{2}-\d{2}$/', $data['due_date'])) { + $validator->required('due_date', null, 'Use a valid due date.'); + } + + if (!in_array($data['status'], self::STATUS_OPTIONS, true)) { + $validator->required('status', null, 'Choose a valid project status.'); + } + + return $validator->errors(); + } + + private function parseMembers(string $value): array + { + $lines = preg_split('/[\r\n,]+/', $value) ?: []; + $members = []; + + foreach ($lines as $index => $line) { + $name = trim($line); + if ($name === '') { + continue; + } + + $members[] = [ + 'full_name' => $name, + 'role' => $index === 0 ? 'Project Lead' : 'Contributor', + 'allocation_percent' => $index === 0 ? 40 : 20, + ]; + } + + return $members; + } +} diff --git a/app/Controllers/TaskController.php b/app/Controllers/TaskController.php new file mode 100644 index 0000000..2287615 --- /dev/null +++ b/app/Controllers/TaskController.php @@ -0,0 +1,160 @@ +requirePost(request()); + + if (!verify_csrf_token((string) request()->input('_token'))) { + return $this->renderProjectWithTaskErrors((int) $projectId, ['_token' => ['The security token expired. Refresh the page and try again.']], $this->taskFormFromRequest()); + } + + $projectRepository = new ProjectRepository(); + $project = $projectRepository->findBoard((int) $projectId); + + if ($project === null) { + return \Core\Response::notFound('Project not found.'); + } + + $data = $this->taskDataFromRequest(); + $errors = $this->validateTask($data); + + if ($errors !== []) { + return $this->renderProjectWithTaskErrors((int) $projectId, $errors, $data); + } + + $taskId = (new TaskRepository())->create((int) $projectId, $data); + (new ActivityRepository())->record( + 'task_created', + 'Added task ' . $data['title'], + 'Task created on the project board.', + (int) $projectId, + $taskId + ); + + return $this->redirect('/projects/' . (int) $projectId . '?task=created#task-' . $taskId); + } + + public function updateStatus(string $id) + { + $this->requirePost(request()); + + if (!verify_csrf_token((string) request()->input('_token'))) { + return $this->redirect('/projects'); + } + + $status = trim((string) request()->input('status', '')); + if (!in_array($status, self::TASK_STATUS_OPTIONS, true)) { + return $this->redirect('/projects'); + } + + $projectId = (new TaskRepository())->updateStatus((int) $id, $status); + + if ($projectId === null) { + return \Core\Response::notFound('Task not found.'); + } + + (new ActivityRepository())->record( + 'task_status_changed', + 'Task updated to ' . task_status_label($status), + 'Task status changed on the project board.', + $projectId, + (int) $id + ); + + return $this->redirect('/projects/' . $projectId . '?task-updated=1#task-' . (int) $id); + } + + private function taskFormFromRequest(): array + { + $input = request()->all(); + + return [ + 'title' => (string) ($input['title'] ?? ''), + 'description' => (string) ($input['description'] ?? ''), + 'priority' => (string) ($input['priority'] ?? 'normal'), + 'status' => (string) ($input['status'] ?? 'backlog'), + 'assignee' => (string) ($input['assignee'] ?? ''), + 'estimate_hours' => (string) ($input['estimate_hours'] ?? ''), + 'due_date' => (string) ($input['due_date'] ?? ''), + ]; + } + + private function taskDataFromRequest(): array + { + $input = request()->all(); + $estimateHours = trim((string) ($input['estimate_hours'] ?? '')); + $dueDate = trim((string) ($input['due_date'] ?? '')); + + return [ + 'title' => trim((string) ($input['title'] ?? '')), + 'description' => trim((string) ($input['description'] ?? '')), + 'priority' => trim((string) ($input['priority'] ?? 'normal')), + 'status' => trim((string) ($input['status'] ?? 'backlog')), + 'assignee' => trim((string) ($input['assignee'] ?? '')), + 'estimate_hours' => $estimateHours !== '' ? (float) $estimateHours : null, + 'due_date' => $dueDate !== '' ? $dueDate : null, + ]; + } + + private function validateTask(array $data): array + { + $validator = new Validator(); + + $validator->required('title', $data['title'], 'Task title is required.')->maxLength('title', $data['title'], 140); + $validator->required('description', $data['description'], 'Task description is required.')->maxLength('description', $data['description'], 800); + $validator->required('assignee', $data['assignee'], 'Assign the task to someone.')->maxLength('assignee', $data['assignee'], 100); + + if (!in_array($data['priority'], self::PRIORITY_OPTIONS, true)) { + $validator->required('priority', null, 'Choose a valid task priority.'); + } + + if (!in_array($data['status'], self::TASK_STATUS_OPTIONS, true)) { + $validator->required('status', null, 'Choose a valid task status.'); + } + + if ($data['due_date'] !== null && !preg_match('/^\d{4}-\d{2}-\d{2}$/', $data['due_date'])) { + $validator->required('due_date', null, 'Use a valid due date.'); + } + + if ($data['estimate_hours'] !== null && $data['estimate_hours'] < 0) { + $validator->required('estimate_hours', null, 'Estimate hours must be 0 or more.'); + } + + return $validator->errors(); + } + + private function renderProjectWithTaskErrors(int $projectId, array $errors, array $old) + { + $projectRepository = new ProjectRepository(); + $project = $projectRepository->findBoard($projectId); + + if ($project === null) { + return \Core\Response::notFound('Project not found.'); + } + + return $this->view('projects.show', [ + 'pageTitle' => $project['name'], + 'project' => $project, + 'taskStatusOptions' => self::TASK_STATUS_OPTIONS, + 'priorityOptions' => self::PRIORITY_OPTIONS, + 'activity' => (new ActivityRepository())->forProject($projectId, 12), + 'taskErrors' => $errors, + 'taskOld' => array_merge($this->taskFormFromRequest(), $old), + ]); + } +} diff --git a/app/Models/Employee.php b/app/Models/Employee.php deleted file mode 100644 index 6418db5..0000000 --- a/app/Models/Employee.php +++ /dev/null @@ -1,16 +0,0 @@ -database ??= database(); + } + + public function record( + string $eventType, + string $headline, + string $detail = '', + ?int $projectId = null, + ?int $taskId = null + ): void { + $this->database->execute( + 'INSERT INTO activity_log (project_id, task_id, event_type, headline, detail) + VALUES (:project_id, :task_id, :event_type, :headline, :detail)', + [ + 'project_id' => $projectId, + 'task_id' => $taskId, + 'event_type' => $eventType, + 'headline' => $headline, + 'detail' => $detail, + ] + ); + } + + public function recent(int $limit = 10): array + { + $limit = max(1, min(50, $limit)); + + return $this->database->query( + 'SELECT a.*, p.name AS project_name, p.code AS project_code, t.title AS task_title + FROM activity_log a + LEFT JOIN projects p ON p.id = a.project_id + LEFT JOIN tasks t ON t.id = a.task_id + ORDER BY a.created_at DESC, a.id DESC + LIMIT ' . $limit + ); + } + + public function forProject(int $projectId, int $limit = 12): array + { + $limit = max(1, min(50, $limit)); + + return $this->database->query( + 'SELECT a.*, t.title AS task_title + FROM activity_log a + LEFT JOIN tasks t ON t.id = a.task_id + WHERE a.project_id = :project_id + ORDER BY a.created_at DESC, a.id DESC + LIMIT ' . $limit, + ['project_id' => $projectId] + ); + } +} diff --git a/app/Repositories/EmployeeRepository.php b/app/Repositories/EmployeeRepository.php deleted file mode 100644 index 6de1b25..0000000 --- a/app/Repositories/EmployeeRepository.php +++ /dev/null @@ -1,122 +0,0 @@ -database->execute( - 'INSERT INTO employees (first_name, last_name, email, department, job_title, start_date) - VALUES (:first_name, :last_name, :email, :department, :job_title, :start_date)', - [ - 'first_name' => $employee->firstName, - 'last_name' => $employee->lastName, - 'email' => $employee->email, - 'department' => $employee->department, - 'job_title' => $employee->jobTitle, - 'start_date' => $employee->startDate, - ] - ); - } - - public function findByEmail(string $email): ?array - { - return $this->database->first( - 'SELECT * FROM employees WHERE email = :email', - ['email' => $email] - ); - } - - /** - * @return list> - */ - public function latest(int $limit = 8): array - { - $limit = max(1, $limit); - - return $this->database->query( - "SELECT * FROM employees ORDER BY created_at DESC, id DESC LIMIT {$limit}" - ); - } - - /** - * @return list> - */ - public function search(string $search = ''): array - { - [$whereClause, $parameters] = $this->buildSearchClause($search); - - return $this->database->query( - 'SELECT id, first_name, last_name, email, department, job_title, start_date, created_at - FROM employees' . $whereClause . ' - ORDER BY created_at DESC, id DESC', - $parameters - ); - } - - public function countMatching(string $search = ''): int - { - [$whereClause, $parameters] = $this->buildSearchClause($search); - $row = $this->database->first( - 'SELECT COUNT(*) AS total FROM employees' . $whereClause, - $parameters - ); - - return (int) ($row['total'] ?? 0); - } - - public function countDepartments(string $search = ''): int - { - [$whereClause, $parameters] = $this->buildSearchClause($search); - $row = $this->database->first( - 'SELECT COUNT(DISTINCT department) AS total FROM employees' . $whereClause, - $parameters - ); - - return (int) ($row['total'] ?? 0); - } - - public function newestMatching(string $search = ''): ?array - { - [$whereClause, $parameters] = $this->buildSearchClause($search); - - return $this->database->first( - 'SELECT id, first_name, last_name, department, job_title, start_date - FROM employees' . $whereClause . ' - ORDER BY created_at DESC, id DESC - LIMIT 1', - $parameters - ); - } - - /** - * @return array{0:string,1:array} - */ - private function buildSearchClause(string $search): array - { - $search = trim($search); - - if ($search === '') { - return ['', []]; - } - - return [ - ' WHERE first_name LIKE :search - OR last_name LIKE :search - OR email LIKE :search - OR department LIKE :search - OR job_title LIKE :search - OR start_date LIKE :search', - ['search' => '%' . $search . '%'], - ]; - } -} diff --git a/app/Repositories/ProjectRepository.php b/app/Repositories/ProjectRepository.php new file mode 100644 index 0000000..e9f7b15 --- /dev/null +++ b/app/Repositories/ProjectRepository.php @@ -0,0 +1,383 @@ +database ??= database(); + } + + public function dashboardSummary(): array + { + $projectCount = (int) ($this->database->first('SELECT COUNT(*) AS total FROM projects')['total'] ?? 0); + $activeProjects = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM projects WHERE status IN ("active", "at-risk")' + )['total'] ?? 0); + $openTasks = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM tasks WHERE status != "done"' + )['total'] ?? 0); + $blockedTasks = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM tasks WHERE status = "blocked"' + )['total'] ?? 0); + $dueSoonTasks = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM tasks WHERE status != "done" AND due_date IS NOT NULL AND date(due_date) BETWEEN date("now") AND date("now", "+7 day")' + )['total'] ?? 0); + $overdueTasks = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM tasks WHERE status != "done" AND due_date IS NOT NULL AND date(due_date) < date("now")' + )['total'] ?? 0); + + return [ + 'project_count' => $projectCount, + 'active_projects' => $activeProjects, + 'open_tasks' => $openTasks, + 'blocked_tasks' => $blockedTasks, + 'due_soon_tasks' => $dueSoonTasks, + 'overdue_tasks' => $overdueTasks, + ]; + } + + public function recent(int $limit = 6): array + { + $limit = max(1, min(25, $limit)); + + $rows = $this->database->query( + 'SELECT p.*, + COUNT(t.id) AS task_count, + SUM(CASE WHEN t.status = "done" THEN 1 ELSE 0 END) AS done_task_count, + SUM(CASE WHEN t.status = "blocked" THEN 1 ELSE 0 END) AS blocked_task_count, + SUM(CASE WHEN t.status != "done" AND t.due_date IS NOT NULL AND date(t.due_date) < date("now") THEN 1 ELSE 0 END) AS overdue_task_count, + MAX(t.updated_at) AS latest_task_update + FROM projects p + LEFT JOIN tasks t ON t.project_id = p.id + GROUP BY p.id + ORDER BY CASE p.status WHEN "active" THEN 0 WHEN "at-risk" THEN 1 WHEN "planned" THEN 2 WHEN "paused" THEN 3 WHEN "done" THEN 4 ELSE 5 END, + p.updated_at DESC, + p.id DESC + LIMIT ' . $limit + ); + + return array_map([$this, 'decorateProjectRow'], $rows); + } + + public function all(string $search = '', string $status = ''): array + { + $where = []; + $params = []; + + if ($search !== '') { + $where[] = '(p.name LIKE :search OR p.code LIKE :search OR p.client_name LIKE :search OR p.description LIKE :search)'; + $params['search'] = '%' . $search . '%'; + } + + if ($status !== '') { + $where[] = 'p.status = :status'; + $params['status'] = $status; + } + + $sql = 'SELECT p.*, + COUNT(t.id) AS task_count, + SUM(CASE WHEN t.status = "done" THEN 1 ELSE 0 END) AS done_task_count, + SUM(CASE WHEN t.status = "blocked" THEN 1 ELSE 0 END) AS blocked_task_count, + SUM(CASE WHEN t.status != "done" AND t.due_date IS NOT NULL AND date(t.due_date) < date("now") THEN 1 ELSE 0 END) AS overdue_task_count, + MAX(t.updated_at) AS latest_task_update + FROM projects p + LEFT JOIN tasks t ON t.project_id = p.id'; + + if ($where !== []) { + $sql .= ' WHERE ' . implode(' AND ', $where); + } + + $sql .= ' GROUP BY p.id + ORDER BY CASE p.status WHEN "active" THEN 0 WHEN "at-risk" THEN 1 WHEN "planned" THEN 2 WHEN "paused" THEN 3 WHEN "done" THEN 4 ELSE 5 END, + COALESCE(p.due_date, "9999-12-31") ASC, + p.updated_at DESC, + p.id DESC'; + + return array_map( + [$this, 'decorateProjectRow'], + $this->database->query($sql, $params) + ); + } + + public function find(int $projectId): ?array + { + $project = $this->database->first( + 'SELECT p.*, + COUNT(t.id) AS task_count, + SUM(CASE WHEN t.status = "done" THEN 1 ELSE 0 END) AS done_task_count, + SUM(CASE WHEN t.status = "blocked" THEN 1 ELSE 0 END) AS blocked_task_count, + SUM(CASE WHEN t.status != "done" AND t.due_date IS NOT NULL AND date(t.due_date) < date("now") THEN 1 ELSE 0 END) AS overdue_task_count, + MAX(t.updated_at) AS latest_task_update + FROM projects p + LEFT JOIN tasks t ON t.project_id = p.id + WHERE p.id = :id + GROUP BY p.id', + ['id' => $projectId] + ); + + if ($project === null) { + return null; + } + + return $this->decorateProjectDetail($project); + } + + public function findBoard(int $projectId): ?array + { + $project = $this->find($projectId); + + if ($project === null) { + return null; + } + + $tasks = $this->database->query( + 'SELECT * FROM tasks WHERE project_id = :project_id ORDER BY + CASE status + WHEN "backlog" THEN 0 + WHEN "in-progress" THEN 1 + WHEN "review" THEN 2 + WHEN "blocked" THEN 3 + WHEN "done" THEN 4 + ELSE 5 + END, + CASE priority + WHEN "urgent" THEN 0 + WHEN "high" THEN 1 + WHEN "normal" THEN 2 + ELSE 3 + END, + due_date IS NULL, + due_date ASC, + position ASC, + id ASC', + ['project_id' => $projectId] + ); + + $buckets = [ + 'backlog' => [], + 'in-progress' => [], + 'review' => [], + 'blocked' => [], + 'done' => [], + ]; + + foreach ($tasks as $task) { + $task['is_overdue'] = $task['status'] !== 'done' && !empty($task['due_date']) && strtotime((string) $task['due_date']) < strtotime(date('Y-m-d')); + $task['priority_label'] = ucfirst(str_replace('-', ' ', $task['priority'])); + $task['status_label'] = task_status_label($task['status']); + $task['status_class'] = status_class($task['status']); + $bucketKey = array_key_exists($task['status'], $buckets) ? $task['status'] : 'backlog'; + $buckets[$bucketKey][] = $task; + } + + $members = $this->database->query( + 'SELECT * FROM project_members WHERE project_id = :project_id ORDER BY is_primary DESC, id ASC', + ['project_id' => $projectId] + ); + + $project['members'] = $members; + $project['task_buckets'] = $buckets; + $project['tasks'] = $tasks; + $project['progress_percent'] = $this->progressPercentage($projectId, (int) $project['task_count'], (int) $project['done_task_count']); + $project['throughput'] = $this->throughputLabel((int) $project['done_task_count'], (int) $project['task_count']); + $project['health_class'] = $this->healthClass((string) $project['status'], (int) $project['overdue_task_count']); + $project['latest_activity'] = $this->database->first( + 'SELECT created_at FROM activity_log WHERE project_id = :project_id ORDER BY created_at DESC, id DESC LIMIT 1', + ['project_id' => $projectId] + )['created_at'] ?? null; + + return $project; + } + + public function create(array $data): int + { + $code = $data['code'] !== '' ? strtoupper($data['code']) : $this->generateProjectCode($data['name']); + $code = $this->ensureUniqueCode($code); + + $this->database->execute( + 'INSERT INTO projects ( + code, name, client_name, description, status, start_date, due_date, budget_cents, owner_name, color_token + ) VALUES ( + :code, :name, :client_name, :description, :status, :start_date, :due_date, :budget_cents, :owner_name, :color_token + )', + [ + 'code' => $code, + 'name' => $data['name'], + 'client_name' => $data['client_name'] ?? '', + 'description' => $data['description'] ?? '', + 'status' => $data['status'] ?? 'planned', + 'start_date' => $data['start_date'] ?? null, + 'due_date' => $data['due_date'] ?? null, + 'budget_cents' => $data['budget_cents'] ?? 0, + 'owner_name' => $data['owner_name'] ?? '', + 'color_token' => $data['color_token'] ?? 'teal', + ] + ); + + $projectId = (int) $this->database->pdo()->lastInsertId(); + + if (!empty($data['members']) && is_array($data['members'])) { + $this->saveMembers($projectId, $data['members']); + } + + (new ActivityRepository($this->database))->record( + 'project_created', + 'Created project ' . $data['name'], + trim((($data['client_name'] ?? '') !== '' ? 'Client: ' . $data['client_name'] : '') . (($data['description'] ?? '') !== '' ? ' ' . ($data['description'] ?? '') : '')), + $projectId, + null + ); + + return $projectId; + } + + public function updateStatus(int $projectId, string $status): bool + { + $project = $this->database->first('SELECT id, name, status FROM projects WHERE id = :id', ['id' => $projectId]); + + if ($project === null) { + return false; + } + + $this->database->execute( + 'UPDATE projects SET status = :status, updated_at = CURRENT_TIMESTAMP WHERE id = :id', + [ + 'status' => $status, + 'id' => $projectId, + ] + ); + + (new ActivityRepository($this->database))->record( + 'project_status_changed', + 'Project moved to ' . project_status_label($status), + 'Project status updated from ' . project_status_label($project['status']) . ' to ' . project_status_label($status) . '.', + $projectId, + null + ); + + return true; + } + + protected function decorateProjectRow(array $row): array + { + $row['task_count'] = (int) ($row['task_count'] ?? 0); + $row['done_task_count'] = (int) ($row['done_task_count'] ?? 0); + $row['blocked_task_count'] = (int) ($row['blocked_task_count'] ?? 0); + $row['overdue_task_count'] = (int) ($row['overdue_task_count'] ?? 0); + $row['progress_percent'] = $this->progressPercentage((int) $row['id'], $row['task_count'], $row['done_task_count']); + $row['health_class'] = $this->healthClass((string) $row['status'], $row['overdue_task_count']); + $row['status_label'] = project_status_label((string) $row['status']); + $row['budget_label'] = money_cents((int) ($row['budget_cents'] ?? 0)); + $row['task_traffic'] = $this->throughputLabel($row['done_task_count'], $row['task_count']); + $row['due_label'] = format_date($row['due_date'] ?? null); + $row['start_label'] = format_date($row['start_date'] ?? null); + + return $row; + } + + protected function decorateProjectDetail(array $project): array + { + $project = $this->decorateProjectRow($project); + $project['member_count'] = (int) ($this->database->first( + 'SELECT COUNT(*) AS total FROM project_members WHERE project_id = :project_id', + ['project_id' => $project['id']] + )['total'] ?? 0); + + return $project; + } + + protected function saveMembers(int $projectId, array $members): void + { + $statement = $this->database->pdo()->prepare( + 'INSERT INTO project_members (project_id, full_name, role, allocation_percent, is_primary) VALUES (:project_id, :full_name, :role, :allocation_percent, :is_primary)' + ); + + foreach ($members as $index => $member) { + $name = trim((string) ($member['full_name'] ?? '')); + if ($name === '') { + continue; + } + + $statement->execute([ + 'project_id' => $projectId, + 'full_name' => $name, + 'role' => trim((string) ($member['role'] ?? 'Contributor')), + 'allocation_percent' => max(0, min(100, (int) ($member['allocation_percent'] ?? 0))), + 'is_primary' => $index === 0 ? 1 : 0, + ]); + } + } + + protected function generateProjectCode(string $name): string + { + $slug = strtoupper(preg_replace('/[^A-Za-z0-9]+/', '', $name) ?? 'PROJECT'); + $slug = substr($slug, 0, 6) ?: 'PROJECT'; + + return 'PRJ-' . $slug . '-' . date('ym'); + } + + protected function ensureUniqueCode(string $code): string + { + $candidate = $code; + $suffix = 2; + + while ($this->database->first('SELECT id FROM projects WHERE code = :code', ['code' => $candidate]) !== null) { + $candidate = $code . '-' . $suffix; + $suffix++; + } + + return $candidate; + } + + protected function progressPercentage(int $projectId, ?int $taskCount = null, ?int $doneCount = null): int + { + $taskCount ??= (int) ($this->database->first('SELECT COUNT(*) AS total FROM tasks WHERE project_id = :project_id', ['project_id' => $projectId])['total'] ?? 0); + $doneCount ??= (int) ($this->database->first('SELECT COUNT(*) AS total FROM tasks WHERE project_id = :project_id AND status = "done"', ['project_id' => $projectId])['total'] ?? 0); + + if ($taskCount <= 0) { + return 0; + } + + return (int) round(($doneCount / $taskCount) * 100); + } + + protected function throughputLabel(int $doneCount, int $taskCount): string + { + if ($taskCount === 0) { + return 'No tasks yet'; + } + + if ($doneCount === 0) { + return 'Starting up'; + } + + if ($doneCount >= $taskCount) { + return 'Ready to ship'; + } + + return $doneCount . '/' . $taskCount . ' completed'; + } + + protected function healthClass(string $status, int $overdueTasks): string + { + if ($status === 'done') { + return 'is-green'; + } + + if ($overdueTasks > 0 || $status === 'at-risk') { + return 'is-red'; + } + + if ($status === 'paused') { + return 'is-slate'; + } + + return 'is-blue'; + } +} diff --git a/app/Repositories/TaskRepository.php b/app/Repositories/TaskRepository.php new file mode 100644 index 0000000..3393637 --- /dev/null +++ b/app/Repositories/TaskRepository.php @@ -0,0 +1,153 @@ +database ??= database(); + } + + public function create(int $projectId, array $data): int + { + $position = (int) ($this->database->first( + 'SELECT COALESCE(MAX(position), 0) + 1 AS next_position FROM tasks WHERE project_id = :project_id AND status = :status', + [ + 'project_id' => $projectId, + 'status' => $data['status'] ?? 'backlog', + ] + )['next_position'] ?? 1); + + $this->database->execute( + 'INSERT INTO tasks ( + project_id, title, description, status, priority, assignee, estimate_hours, due_date, position, completed_at + ) VALUES ( + :project_id, :title, :description, :status, :priority, :assignee, :estimate_hours, :due_date, :position, :completed_at + )', + [ + 'project_id' => $projectId, + 'title' => $data['title'], + 'description' => $data['description'] ?? '', + 'status' => $data['status'] ?? 'backlog', + 'priority' => $data['priority'] ?? 'normal', + 'assignee' => $data['assignee'] ?? '', + 'estimate_hours' => $data['estimate_hours'] ?? null, + 'due_date' => $data['due_date'] ?? null, + 'position' => $position, + 'completed_at' => ($data['status'] ?? 'backlog') === 'done' ? date('Y-m-d H:i:s') : null, + ] + ); + + return (int) $this->database->pdo()->lastInsertId(); + } + + public function updateStatus(int $taskId, string $status): ?int + { + $task = $this->database->first('SELECT id, project_id, title, status FROM tasks WHERE id = :id', ['id' => $taskId]); + + if ($task === null) { + return null; + } + + $completedAt = $status === 'done' ? date('Y-m-d H:i:s') : null; + + $this->database->execute( + 'UPDATE tasks + SET status = :status, + completed_at = :completed_at, + updated_at = CURRENT_TIMESTAMP + WHERE id = :id', + [ + 'status' => $status, + 'completed_at' => $completedAt, + 'id' => $taskId, + ] + ); + + return (int) $task['project_id']; + } + + public function dueSoon(int $limit = 6): array + { + $limit = max(1, min(25, $limit)); + + return $this->database->query( + 'SELECT t.*, p.name AS project_name, p.code AS project_code + FROM tasks t + INNER JOIN projects p ON p.id = t.project_id + WHERE t.status != "done" + AND t.due_date IS NOT NULL + AND date(t.due_date) BETWEEN date("now") AND date("now", "+7 day") + ORDER BY date(t.due_date) ASC, CASE t.priority WHEN "urgent" THEN 0 WHEN "high" THEN 1 WHEN "normal" THEN 2 ELSE 3 END, t.id DESC + LIMIT ' . $limit + ); + } + + public function overdue(int $limit = 6): array + { + $limit = max(1, min(25, $limit)); + + return $this->database->query( + 'SELECT t.*, p.name AS project_name, p.code AS project_code + FROM tasks t + INNER JOIN projects p ON p.id = t.project_id + WHERE t.status != "done" + AND t.due_date IS NOT NULL + AND date(t.due_date) < date("now") + ORDER BY date(t.due_date) ASC, t.id DESC + LIMIT ' . $limit + ); + } + + public function countsByStatus(int $projectId): array + { + $rows = $this->database->query( + 'SELECT status, COUNT(*) AS total + FROM tasks + WHERE project_id = :project_id + GROUP BY status', + ['project_id' => $projectId] + ); + + $counts = []; + foreach ($rows as $row) { + $counts[$row['status']] = (int) $row['total']; + } + + return $counts; + } + + public function forProject(int $projectId): array + { + return $this->database->query( + 'SELECT * + FROM tasks + WHERE project_id = :project_id + ORDER BY + CASE status + WHEN "backlog" THEN 0 + WHEN "in-progress" THEN 1 + WHEN "review" THEN 2 + WHEN "blocked" THEN 3 + WHEN "done" THEN 4 + ELSE 5 + END, + CASE priority + WHEN "urgent" THEN 0 + WHEN "high" THEN 1 + WHEN "normal" THEN 2 + ELSE 3 + END, + due_date IS NULL, + due_date ASC, + position ASC, + id ASC', + ['project_id' => $projectId] + ); + } +} diff --git a/app/Repositories/UserRepository.php b/app/Repositories/UserRepository.php deleted file mode 100644 index a2e0d70..0000000 --- a/app/Repositories/UserRepository.php +++ /dev/null @@ -1,21 +0,0 @@ -database->first( - 'SELECT * FROM users WHERE email = :email', - ['email' => $email] - ); - } -} diff --git a/app/ViewModels/EmployeeFormViewModel.php b/app/ViewModels/EmployeeFormViewModel.php deleted file mode 100644 index 18800e2..0000000 --- a/app/ViewModels/EmployeeFormViewModel.php +++ /dev/null @@ -1,50 +0,0 @@ - - */ - public array $form = [ - 'first_name' => '', - 'last_name' => '', - 'email' => '', - 'department' => '', - 'job_title' => '', - 'start_date' => '', - ]; - - /** - * @var array> - */ - public array $errors = []; - - /** - * @var list> - */ - public array $employees = []; - - /** - * @var array - */ - public array $summary = [ - 'employee_count' => 0, - 'department_count' => 0, - 'latest_start_date' => 'N/A', - ]; - - /** - * @var array|null - */ - public ?array $newestEmployee = null; -} diff --git a/app/ViewModels/HomeIndexViewModel.php b/app/ViewModels/HomeIndexViewModel.php deleted file mode 100644 index 458b11f..0000000 --- a/app/ViewModels/HomeIndexViewModel.php +++ /dev/null @@ -1,13 +0,0 @@ - -
- eyebrow) ?> -

title) ?>

-

intro) ?>

-
- -
-
-
-

Employee Workspace

-

Use htmx for server updates, Alpine for page state, and Tabulator for a richer table experience.

-
- - -
- -
- -
-
- -
-
- -
- -
-
-

Employee Directory Table

-

Browse, search, and sort all employees in one place. The table refreshes after new employee records are saved.

-
- -
- HTMX + Alpine + Tabulator - Live data endpoint: /employees/data -
- -
-
-
- diff --git a/app/Views/employees/partials/form.php b/app/Views/employees/partials/form.php deleted file mode 100644 index 00d2b50..0000000 --- a/app/Views/employees/partials/form.php +++ /dev/null @@ -1,83 +0,0 @@ -
-
-

Add Employee

-

Store a clean employee record with basic contact and role details.

-
- - saved): ?> -
- Employee information was saved to SQLite successfully. -
- - - errors['_token'])): ?> -
errors['_token'][0]) ?>
- - -
- - -
- - - - - - - - - - - -
- -
- - Saving employee... -
-
-
diff --git a/app/Views/employees/partials/summary.php b/app/Views/employees/partials/summary.php deleted file mode 100644 index 57b4999..0000000 --- a/app/Views/employees/partials/summary.php +++ /dev/null @@ -1,34 +0,0 @@ -
-

Live Summary

-

Server-rendered fragments refresh here with htmx whenever employees change or search terms update.

-
- -
-
- Total Employees - summary['employee_count']) ?> -
- -
- Departments - summary['department_count']) ?> -
- -
- Latest Start Date - summary['latest_start_date']) ?> -
-
- -newestEmployee !== null): ?> -
- Newest matching record -

newestEmployee['first_name'] . ' ' . $model->newestEmployee['last_name']) ?>

-

newestEmployee['job_title']) ?> in newestEmployee['department']) ?>

-
- -
-

No matching employees yet.

-

Try a broader search or add a new employee record.

-
- diff --git a/app/Views/home/activity.php b/app/Views/home/activity.php new file mode 100644 index 0000000..bf08b46 --- /dev/null +++ b/app/Views/home/activity.php @@ -0,0 +1,52 @@ +
+
+ Activity feed +

What changed across the portfolio

+

A chronological log of project creation, status changes, and task movement.

+
+ +
+
+ +
+
+
+ +

+
+ +
+

+
+ +
+ + +
+
diff --git a/app/Views/home/index.php b/app/Views/home/index.php index 9cc963f..2322704 100644 --- a/app/Views/home/index.php +++ b/app/Views/home/index.php @@ -1,39 +1,135 @@
- eyebrow) ?> -

title) ?>

-

message) ?>

+ Command center +

See every project, task, and risk in one view.

+

Project Compass is a focused delivery system for keeping portfolios organized. Track budgets, deadlines, blocked work, and team momentum without losing the narrative of what is happening next.

- Open Employee Form - See Highlights + Open projects + Create a project + View activity +
+ +
+
Projects
+
Active
+
Open tasks
+
Blocked
-
-
-
-

Readable by design

-

Small files, explicit routing, and plain PHP views keep the framework approachable for day-to-day work.

-
- -
-

Classic MVC feel

-

Controllers, repositories, and view models stay separate so request handling remains predictable and easy to follow.

-
- -
-

SQLite ready

-

Typed PHP 8.2 code, Composer autoloading, PDO access, and auto-run migrations make the project feel current without becoming heavyweight.

-
+
+
+
+
+ Featured projects +

Most active workstreams

+
+ Browse all +
+ +
+ +
+
+
+ +

+
+ +
+

+
+
+ tasks + + Budget +
+
+ +
+
+ +
+
+
+
+ Due soon +

Tasks needing attention

+
+
+
+ +
+
+ + +
+

·

+
+ +
+
+ +
+
+
+ Overdue +

Risk items

+
+
+
+ +
+
+ + +
+

·

+
+ +
+
+ +
+
+
+ Activity feed +

Recent changes

+
+ Open full feed +
+
+ +
+
+ + +
+

+
+ +
+
+
diff --git a/app/Views/layouts/app.php b/app/Views/layouts/app.php index 5796585..c030b68 100644 --- a/app/Views/layouts/app.php +++ b/app/Views/layouts/app.php @@ -5,7 +5,7 @@ declare(strict_types=1); require __DIR__ . '/../partials/header.php'; ?> -
+
diff --git a/app/Views/partials/footer.php b/app/Views/partials/footer.php index d2a38dd..edb57f2 100644 --- a/app/Views/partials/footer.php +++ b/app/Views/partials/footer.php @@ -1,7 +1,7 @@
-

MindVisionCode PHP keeps the framework small, readable, and ready for real features.

-

© MindVisionCode

+

Project Compass keeps delivery visible across projects, tasks, and team activity.

+

© Project Compass

diff --git a/app/Views/partials/header.php b/app/Views/partials/header.php index 7844f3a..8cd68fa 100644 --- a/app/Views/partials/header.php +++ b/app/Views/partials/header.php @@ -3,9 +3,10 @@ declare(strict_types=1); $navigationItems = [ - ['label' => 'Home', 'href' => '/'], - ['label' => 'Employees', 'href' => '/employees'], - ['label' => 'Example JSON', 'href' => '/users/123'], + ['label' => 'Dashboard', 'href' => '/'], + ['label' => 'Projects', 'href' => '/projects'], + ['label' => 'Activity', 'href' => '/activity'], + ['label' => 'New project', 'href' => '/projects/create'], ]; $currentPath = parse_url($_SERVER['REQUEST_URI'] ?? '/', PHP_URL_PATH); @@ -16,32 +17,27 @@ $currentPath = is_string($currentPath) && $currentPath !== '' ? $currentPath : ' - <?= e($pageTitle ?? 'MindVisionCode PHP') ?> - + <?= e($pageTitle ?? 'Project Compass') ?> - - - - +>
+
- MV + PC - MindVisionCode - PHP MVC + Project Compass + Portfolio command center
diff --git a/app/Views/projects/create.php b/app/Views/projects/create.php new file mode 100644 index 0000000..7e7a763 --- /dev/null +++ b/app/Views/projects/create.php @@ -0,0 +1,88 @@ +
+
+ New project +

Create a project

+

Set up a new workstream with budget, team members, and delivery milestones in one pass.

+
+ + +
+ + +
+ +
+ + + + + + + + + + + + + + + + + +
+ + + + + +
+ + Cancel +
+
+
diff --git a/app/Views/projects/index.php b/app/Views/projects/index.php new file mode 100644 index 0000000..2fbadca --- /dev/null +++ b/app/Views/projects/index.php @@ -0,0 +1,66 @@ +
+
+
+ Portfolio view +

Projects

+

Filter every project by status, workstream, and delivery risk.

+
+
+ Create project + View activity +
+
+ +
+
Projects
+
Open tasks
+
Overdue
+
+ +
+ + + + +
+ + Reset +
+
+ +
+ +
+
+
+ +

+
+ +
+

+
+
+ tasks + + Due +
+
+ Owner: + +
+
+ +
+
diff --git a/app/Views/projects/show.php b/app/Views/projects/show.php new file mode 100644 index 0000000..725f8d9 --- /dev/null +++ b/app/Views/projects/show.php @@ -0,0 +1,220 @@ + 'Backlog', + 'in-progress' => 'In progress', + 'review' => 'In review', + 'blocked' => 'Blocked', + 'done' => 'Done', +]; +?> + +
+
+
+
+
+ +

+

+
+
+ Back to projects + Activity feed +
+
+ +
+ + + Owner: + Last update: +
+ +
+ +
+
Client
+
Budget
+
Due date
+
Tasks total / done
+
+ +
+
+ + + +
+
+
+
+ +
+
+
+
+ Kanban board +

Task flow

+
+
+ team members + blocked + overdue +
+
+ +
+ $label): ?> +
+
+

+ +
+ +
+
+
+ +

+
+ +
+
+

+
+ Assigned to + +
+
+
+
+ + + +
+
+
+ +
+ +
+
+ + +
+
diff --git a/autoload.php b/autoload.php new file mode 100644 index 0000000..a4f8077 --- /dev/null +++ b/autoload.php @@ -0,0 +1,27 @@ + __DIR__ . '/app/', + 'Core\\' => __DIR__ . '/core/', + ]; + + foreach ($prefixes as $prefix => $baseDir) { + if (!str_starts_with($class, $prefix)) { + continue; + } + + $relative = substr($class, strlen($prefix)); + $file = $baseDir . str_replace('\\', DIRECTORY_SEPARATOR, $relative) . '.php'; + + if (is_file($file)) { + require_once $file; + } + + return; + } +}); + +require_once __DIR__ . '/core/helpers.php'; diff --git a/composer.json b/composer.json index fa53963..15c984f 100644 --- a/composer.json +++ b/composer.json @@ -1,6 +1,6 @@ { "name": "kci/mindvisioncode", - "description": "A small PHP MVC framework inspired by a Classic ASP MVC framework.", + "description": "A project management app built on a small PHP MVC framework.", "type": "project", "autoload": { "psr-4": { @@ -16,7 +16,9 @@ "migrate:down": "php scripts/migrate.php down", "migrate:status": "php scripts/migrate.php status", "migrate:fresh": "php scripts/migrate.php fresh", - "migrate:fresh-seed": "php scripts/migrate.php fresh --seed" + "migrate:fresh-seed": "php scripts/migrate.php fresh --seed", + "seed": "php scripts/seed_projects.php", + "seed:fresh": "php scripts/seed_projects.php --reset" }, "require": {} } diff --git a/core/View.php b/core/View.php index c823d3a..d00a77c 100644 --- a/core/View.php +++ b/core/View.php @@ -63,6 +63,6 @@ class View return $data['model']->title; } - return 'MindVisionCode PHP'; + return 'Project Compass'; } } diff --git a/core/helpers.php b/core/helpers.php index fffc7cb..725b883 100644 --- a/core/helpers.php +++ b/core/helpers.php @@ -5,6 +5,7 @@ declare(strict_types=1); use Core\App; use Core\Database; use Core\MigrationManager; +use Core\Request; use Core\Response; use Core\View; @@ -29,22 +30,49 @@ function redirect(string $url): Response return Response::redirect($url); } +function request(): Request +{ + return Request::capture(); +} + function database(): Database { static $database = null; - if ($database === null) { - /** @var array $config */ - $config = require __DIR__ . '/../config/database.php'; + global $databaseOverride; - prepareSqliteDatabase($config['dsn'] ?? ''); + if ($databaseOverride instanceof Database) { + return $databaseOverride; + } - $database = new Database($config); + if ($database instanceof Database) { + return $database; } + /** @var array $config */ + $config = require __DIR__ . '/../config/database.php'; + + prepareSqliteDatabase($config['dsn'] ?? ''); + + $database = new Database($config); + return $database; } +function set_database(Database $database): void +{ + global $databaseOverride; + + $databaseOverride = $database; +} + +function reset_database(): void +{ + global $databaseOverride; + + $databaseOverride = null; +} + function migration_manager(): MigrationManager { static $migrationManager = null; @@ -132,3 +160,78 @@ function verify_csrf_token(?string $token): bool return is_string($sessionToken) && hash_equals($sessionToken, $token); } + +function h(string $value): string +{ + return htmlspecialchars($value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'); +} + +function format_date(?string $value, string $format = 'M j, Y'): string +{ + if (!is_string($value) || trim($value) === '') { + return '—'; + } + + try { + $date = new DateTimeImmutable($value); + } catch (Throwable) { + return $value; + } + + return $date->format($format); +} + +function format_number(int|float|null $value): string +{ + if ($value === null) { + return '0'; + } + + return number_format((float) $value); +} + +function money_cents(int|null $value): string +{ + if ($value === null) { + return '$0'; + } + + return '$' . number_format($value / 100, 0); +} + +function project_status_label(string $status): string +{ + return match ($status) { + 'planned' => 'Planned', + 'active' => 'Active', + 'at-risk' => 'At risk', + 'paused' => 'Paused', + 'done' => 'Done', + default => ucfirst($status), + }; +} + +function task_status_label(string $status): string +{ + return match ($status) { + 'backlog', 'todo' => 'Backlog', + 'in-progress', 'doing' => 'In progress', + 'blocked' => 'Blocked', + 'review' => 'In review', + 'done' => 'Done', + default => ucfirst($status), + }; +} + +function status_class(string $status): string +{ + return match ($status) { + 'planned', 'backlog', 'todo' => 'is-neutral', + 'active', 'in-progress', 'doing' => 'is-blue', + 'blocked', 'at-risk' => 'is-red', + 'review' => 'is-amber', + 'done' => 'is-green', + 'paused' => 'is-slate', + default => 'is-neutral', + }; +} diff --git a/database/migrations/20260509_000001_create_employees_table.php b/database/migrations/20260509_000001_create_employees_table.php deleted file mode 100644 index 2ac3812..0000000 --- a/database/migrations/20260509_000001_create_employees_table.php +++ /dev/null @@ -1,30 +0,0 @@ -execute( - 'CREATE TABLE IF NOT EXISTS employees ( - id INTEGER PRIMARY KEY AUTOINCREMENT, - first_name VARCHAR(100) NOT NULL, - last_name VARCHAR(100) NOT NULL, - email VARCHAR(255) NOT NULL UNIQUE, - department VARCHAR(100) NOT NULL, - job_title VARCHAR(150) NOT NULL, - start_date DATE NOT NULL, - created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP - )' - ); - } - - public function down(Database $database): void - { - $database->execute('DROP TABLE IF EXISTS employees'); - } -}; diff --git a/database/migrations/20260509_000001_create_project_management_tables.php b/database/migrations/20260509_000001_create_project_management_tables.php new file mode 100644 index 0000000..eee78e5 --- /dev/null +++ b/database/migrations/20260509_000001_create_project_management_tables.php @@ -0,0 +1,93 @@ +execute('DROP TABLE IF EXISTS project_members'); + $database->execute('DROP TABLE IF EXISTS tasks'); + $database->execute('DROP TABLE IF EXISTS activity_log'); + $database->execute('DROP TABLE IF EXISTS projects'); + + $database->execute( + 'CREATE TABLE IF NOT EXISTS projects ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + code VARCHAR(32) NOT NULL UNIQUE, + name VARCHAR(120) NOT NULL, + client_name VARCHAR(120) NOT NULL, + description TEXT NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT "planned", + start_date DATE NOT NULL, + due_date DATE NULL, + budget_cents INTEGER NOT NULL DEFAULT 0, + owner_name VARCHAR(120) NOT NULL, + color_token VARCHAR(32) NOT NULL DEFAULT "teal", + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP + )' + ); + + $database->execute( + 'CREATE TABLE IF NOT EXISTS project_members ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + project_id INTEGER NOT NULL, + full_name VARCHAR(120) NOT NULL, + role VARCHAR(80) NOT NULL, + allocation_percent INTEGER NOT NULL DEFAULT 0, + is_primary INTEGER NOT NULL DEFAULT 0, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE + )' + ); + + $database->execute( + 'CREATE TABLE IF NOT EXISTS tasks ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + project_id INTEGER NOT NULL, + title VARCHAR(140) NOT NULL, + description TEXT NOT NULL, + status VARCHAR(20) NOT NULL DEFAULT "backlog", + priority VARCHAR(20) NOT NULL DEFAULT "normal", + assignee VARCHAR(100) NOT NULL, + estimate_hours REAL NULL, + due_date DATE NULL, + position INTEGER NOT NULL DEFAULT 0, + completed_at DATETIME NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE + )' + ); + + $database->execute( + 'CREATE TABLE IF NOT EXISTS activity_log ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + project_id INTEGER NULL, + task_id INTEGER NULL, + event_type VARCHAR(40) NOT NULL, + headline VARCHAR(180) NOT NULL, + detail TEXT NOT NULL, + created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, + FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE, + FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE + )' + ); + + $database->execute('CREATE INDEX IF NOT EXISTS idx_tasks_project_status ON tasks (project_id, status, due_date)'); + $database->execute('CREATE INDEX IF NOT EXISTS idx_activity_project_created ON activity_log (project_id, created_at DESC)'); + $database->execute('CREATE INDEX IF NOT EXISTS idx_project_members_project_primary ON project_members (project_id, is_primary DESC)'); + } + + public function down(Database $database): void + { + $database->execute('DROP TABLE IF EXISTS activity_log'); + $database->execute('DROP TABLE IF EXISTS tasks'); + $database->execute('DROP TABLE IF EXISTS project_members'); + $database->execute('DROP TABLE IF EXISTS projects'); + } +}; diff --git a/database/seed_employees.php b/database/seed_employees.php deleted file mode 100644 index 82317e3..0000000 --- a/database/seed_employees.php +++ /dev/null @@ -1,107 +0,0 @@ -runPending(); - $database = database(); - - if ($resetExisting) { - $database->execute('DELETE FROM employees'); - } - - $currentTotal = (int) (database()->first('SELECT COUNT(*) AS total FROM employees')['total'] ?? 0); - - if ($currentTotal >= $targetTotal) { - echo "Employee table already has {$currentTotal} records." . PHP_EOL; - return; - } - -$firstNames = [ - 'Ava', 'Liam', 'Noah', 'Emma', 'Olivia', 'Mason', 'Sophia', 'Ethan', 'Isabella', 'Lucas', - 'Mia', 'Amelia', 'James', 'Harper', 'Benjamin', 'Ella', 'Henry', 'Evelyn', 'Jack', 'Abigail', - 'Alexander', 'Emily', 'Michael', 'Charlotte', 'Daniel', 'Grace', 'Elijah', 'Scarlett', 'William', 'Chloe', - 'Matthew', 'Victoria', 'Samuel', 'Lily', 'David', 'Aria', 'Joseph', 'Zoey', 'Carter', 'Hannah', - 'Owen', 'Addison', 'Wyatt', 'Natalie', 'John', 'Aubrey', 'Luke', 'Brooklyn', 'Gabriel', 'Layla', - 'Anthony', 'Zoe', 'Isaac', 'Penelope', 'Dylan', 'Riley', 'Grayson', 'Nora', 'Levi', 'Lillian', - 'Julian', 'Eleanor', 'Christopher', 'Stella', 'Joshua', 'Savannah', 'Andrew', 'Audrey', 'Nathan', 'Claire', - 'Thomas', 'Skylar', 'Caleb', 'Lucy', 'Ryan', 'Paisley', 'Christian', 'Everly', 'Hunter', 'Anna', - 'Jonathan', 'Caroline', 'Aaron', 'Nova', 'Charles', 'Genesis', 'Connor', 'Kennedy', 'Eli', 'Samantha', - 'Landon', 'Maya', 'Adrian', 'Willow', 'Nicholas', 'Kinsley', 'Jeremiah', 'Naomi', 'Easton', 'Ariana', -]; - -$lastNames = [ - 'Carter', 'Brooks', 'Hayes', 'Parker', 'Turner', 'Sullivan', 'Reed', 'Ward', 'Price', 'Foster', - 'Powell', 'Bennett', 'Coleman', 'Russell', 'Long', 'Perry', 'Morgan', 'Peterson', 'Cooper', 'Bailey', - 'Smith', 'Johnson', 'Williams', 'Brown', 'Jones', 'Garcia', 'Miller', 'Davis', 'Rodriguez', 'Martinez', - 'Hernandez', 'Lopez', 'Gonzalez', 'Wilson', 'Anderson', 'Thomas', 'Taylor', 'Moore', 'Jackson', 'Martin', - 'Lee', 'Perez', 'Thompson', 'White', 'Harris', 'Sanchez', 'Clark', 'Ramirez', 'Lewis', 'Robinson', - 'Walker', 'Young', 'Allen', 'King', 'Wright', 'Scott', 'Torres', 'Nguyen', 'Hill', 'Flores', - 'Green', 'Adams', 'Nelson', 'Baker', 'Hall', 'Rivera', 'Campbell', 'Mitchell', 'Roberts', 'Gomez', - 'Phillips', 'Evans', 'Edwards', 'Collins', 'Stewart', 'Morris', 'Rogers', 'Murphy', 'Cook', 'Ramos', - 'Richardson', 'Cox', 'Howard', 'Bell', 'Ortiz', 'Gutierrez', 'Chavez', 'Wood', 'James', 'Bennett', - 'Gray', 'Mendoza', 'Ruiz', 'Hughes', 'Grant', 'Stone', 'Spencer', 'Warren', 'Porter', 'Bryant', -]; - - $departments = [ - 'Engineering', 'Finance', 'Operations', 'Sales', 'Marketing', 'People', 'Support', 'Legal', - ]; - - $jobTitles = [ - 'Coordinator', 'Analyst', 'Manager', 'Specialist', 'Administrator', 'Engineer', 'Consultant', 'Lead', - ]; - - $statement = $database->pdo()->prepare( - 'INSERT INTO employees (first_name, last_name, email, department, job_title, start_date) - VALUES (:first_name, :last_name, :email, :department, :job_title, :start_date)' - ); - - $database->pdo()->beginTransaction(); - - try { - for ($i = $currentTotal + 1; $i <= $targetTotal; $i++) { - $firstName = $firstNames[$i % count($firstNames)]; - $lastName = $lastNames[$i % count($lastNames)]; - $department = $departments[$i % count($departments)]; - $jobTitle = $jobTitles[$i % count($jobTitles)]; - $email = sprintf( - '%s.%s.%04d@example.test', - strtolower($firstName), - strtolower($lastName), - $i - ); - - $month = (($i - 1) % 12) + 1; - $day = (($i - 1) % 28) + 1; - $year = 2019 + (($i - 1) % 8); - $startDate = sprintf('%04d-%02d-%02d', $year, $month, $day); - - $statement->execute([ - 'first_name' => $firstName, - 'last_name' => $lastName, - 'email' => $email, - 'department' => $department, - 'job_title' => $jobTitle, - 'start_date' => $startDate, - ]); - } - - $database->pdo()->commit(); - } catch (Throwable $exception) { - $database->pdo()->rollBack(); - throw $exception; - } - - $inserted = $targetTotal - $currentTotal; - echo "Inserted {$inserted} sample employees. Total is now {$targetTotal}." . PHP_EOL; -} - -if (PHP_SAPI === 'cli' && realpath($_SERVER['SCRIPT_FILENAME'] ?? '') === __FILE__) { - $targetTotal = isset($argv[1]) ? max(1, (int) $argv[1]) : 1000; - seed_employees($targetTotal); -} diff --git a/database/seed_projects.php b/database/seed_projects.php new file mode 100644 index 0000000..ba63b6e --- /dev/null +++ b/database/seed_projects.php @@ -0,0 +1,138 @@ +runPending(); + $database = database(); + + if ($resetExisting) { + $database->execute('DELETE FROM activity_log'); + $database->execute('DELETE FROM tasks'); + $database->execute('DELETE FROM project_members'); + $database->execute('DELETE FROM projects'); + } + + $projects = [ + [ + 'name' => 'Atlas Portfolio Rollout', + 'client_name' => 'Atlas Financial', + 'description' => 'A multi-quarter portfolio site refresh with content migration, editorial workflow, and KPI reporting.', + 'status' => 'active', + 'start_date' => '2026-02-10', + 'due_date' => '2026-06-30', + 'budget_cents' => 1450000, + 'owner_name' => 'Maya Chen', + 'color_token' => 'teal', + 'members_text' => "Maya Chen\nJordan Ellis\nPriya Singh", + 'tasks' => [ + ['title' => 'Finalize content inventory', 'description' => 'Audit all portfolio assets and map old URLs to the new structure.', 'status' => 'done', 'priority' => 'high', 'assignee' => 'Maya Chen', 'estimate_hours' => 12, 'due_date' => '2026-03-05'], + ['title' => 'Build editorial review queue', 'description' => 'Create approvals and publish scheduling for content editors.', 'status' => 'in-progress', 'priority' => 'urgent', 'assignee' => 'Jordan Ellis', 'estimate_hours' => 28, 'due_date' => '2026-05-18'], + ['title' => 'Launch executive dashboard', 'description' => 'Surface conversion, retention, and campaign metrics for leadership.', 'status' => 'review', 'priority' => 'high', 'assignee' => 'Priya Singh', 'estimate_hours' => 24, 'due_date' => '2026-05-22'], + ['title' => 'Prepare stakeholder training', 'description' => 'Document the content workflow and publish timeline for the business team.', 'status' => 'backlog', 'priority' => 'normal', 'assignee' => 'Maya Chen', 'estimate_hours' => 10, 'due_date' => '2026-06-05'], + ], + ], + [ + 'name' => 'Northstar Launch Pad', + 'client_name' => 'Northstar Logistics', + 'description' => 'A cross-department launch program covering operations, onboarding, and service readiness.', + 'status' => 'at-risk', + 'start_date' => '2026-03-01', + 'due_date' => '2026-05-28', + 'budget_cents' => 980000, + 'owner_name' => 'Diego Flores', + 'color_token' => 'amber', + 'members_text' => "Diego Flores\nAvery Brooks\nNina Patel", + 'tasks' => [ + ['title' => 'Resolve deployment blocker', 'description' => 'Investigate the shipping API timeout and document the fix.', 'status' => 'blocked', 'priority' => 'urgent', 'assignee' => 'Avery Brooks', 'estimate_hours' => 16, 'due_date' => '2026-05-10'], + ['title' => 'Coordinate ops handoff', 'description' => 'Align training, support, and fulfillment teams before launch.', 'status' => 'in-progress', 'priority' => 'high', 'assignee' => 'Diego Flores', 'estimate_hours' => 18, 'due_date' => '2026-05-19'], + ['title' => 'Validate onboarding scripts', 'description' => 'Check each script against the latest workflow and signoff notes.', 'status' => 'backlog', 'priority' => 'normal', 'assignee' => 'Nina Patel', 'estimate_hours' => 8, 'due_date' => '2026-05-21'], + ], + ], + [ + 'name' => 'Studio Systems Upgrade', + 'client_name' => 'Bluebird Studios', + 'description' => 'An internal tooling rebuild that unifies scheduling, budgeting, and show reporting.', + 'status' => 'planned', + 'start_date' => '2026-04-15', + 'due_date' => '2026-08-01', + 'budget_cents' => 650000, + 'owner_name' => 'Elena Rossi', + 'color_token' => 'violet', + 'members_text' => "Elena Rossi\nSam Walker", + 'tasks' => [ + ['title' => 'Map legacy workflows', 'description' => 'Document existing scheduling and finance handoffs.', 'status' => 'backlog', 'priority' => 'normal', 'assignee' => 'Elena Rossi', 'estimate_hours' => 9, 'due_date' => '2026-05-30'], + ['title' => 'Define reporting schema', 'description' => 'Outline the data that finance and production teams need.', 'status' => 'backlog', 'priority' => 'high', 'assignee' => 'Sam Walker', 'estimate_hours' => 14, 'due_date' => '2026-06-10'], + ], + ], + [ + 'name' => 'Summit Care Portal', + 'client_name' => 'Summit Health', + 'description' => 'A patient-facing portal modernization with secure messaging and appointment flow improvements.', + 'status' => 'paused', + 'start_date' => '2026-01-12', + 'due_date' => '2026-07-15', + 'budget_cents' => 2100000, + 'owner_name' => 'Ari Johnson', + 'color_token' => 'blue', + 'members_text' => "Ari Johnson\nTaylor Nguyen\nRita Gomez", + 'tasks' => [ + ['title' => 'Stabilize auth workflow', 'description' => 'Review the sign-in edge cases before resuming development.', 'status' => 'done', 'priority' => 'high', 'assignee' => 'Ari Johnson', 'estimate_hours' => 20, 'due_date' => '2026-03-28'], + ['title' => 'Resume design review', 'description' => 'Pick up the paused UX feedback from the accessibility team.', 'status' => 'blocked', 'priority' => 'normal', 'assignee' => 'Taylor Nguyen', 'estimate_hours' => 6, 'due_date' => '2026-06-01'], + ], + ], + ]; + + $projectRepo = new ProjectRepository($database); + $taskRepo = new TaskRepository($database); + $activityRepo = new ActivityRepository($database); + + foreach (array_slice($projects, 0, $projectTotal) as $project) { + $projectId = $projectRepo->create([ + 'name' => $project['name'], + 'code' => '', + 'client_name' => $project['client_name'], + 'description' => $project['description'], + 'status' => $project['status'], + 'start_date' => $project['start_date'], + 'due_date' => $project['due_date'], + 'budget_cents' => $project['budget_cents'], + 'owner_name' => $project['owner_name'], + 'color_token' => $project['color_token'], + 'members' => array_map( + static function (string $name, int $index): array { + return [ + 'full_name' => $name, + 'role' => $index === 0 ? 'Project Lead' : 'Contributor', + 'allocation_percent' => $index === 0 ? 40 : 20, + ]; + }, + preg_split('/[\r\n]+/', $project['members_text']) ?: [], + array_keys(preg_split('/[\r\n]+/', $project['members_text']) ?: []) + ), + ]); + + foreach ($project['tasks'] as $task) { + $taskId = $taskRepo->create($projectId, $task); + $activityRepo->record( + 'task_seeded', + 'Seeded task ' . $task['title'], + 'Sample project data loaded for the dashboard.', + $projectId, + $taskId + ); + } + } +} + +if (PHP_SAPI === 'cli' && realpath($_SERVER['SCRIPT_FILENAME'] ?? '') === __FILE__) { + $count = isset($argv[1]) ? max(1, (int) $argv[1]) : 6; + seed_projects($count, in_array('--reset', $argv, true)); +} diff --git a/docs/README.md b/docs/README.md index 813a37e..7deaf13 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,46 +1,35 @@ -# MindVisionCode PHP +# Project Compass PHP -A small PHP MVC framework inspired by a Classic ASP MVC framework. +A small PHP MVC app for managing projects, tasks, and activity. ## Run ```bash composer install php scripts/migrate.php up +php scripts/seed_projects.php --reset php -S localhost:8000 -t public ``` Open: ```text -http://localhost:8000 -``` - -Try: - -```text -http://localhost:8000/users/123 -``` - -Employee form: - -```text -http://localhost:8000/employees +http://localhost:8000/ ``` ## Request Flow -Browser → public/index.php → Request → Dispatcher → Router → Route → Controller → ViewModel/Repository → View → Response +Browser → public/index.php → Request → Dispatcher → Router → Route → Controller → Repository → View → Response ## Main Folders - `core/` framework classes - `app/Controllers/` application controllers -- `app/ViewModels/` view model classes - `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 @@ -51,24 +40,14 @@ The default database is SQLite and points to: database/app.sqlite ``` -The database file is created automatically when the app first needs it. - Run migrations from the PHP CLI: ```bash php scripts/migrate.php up php scripts/migrate.php down php scripts/migrate.php status -php scripts/migrate.php make create_projects_table +php scripts/migrate.php make create_project_management_tables php scripts/migrate.php fresh php scripts/migrate.php fresh --seed -php scripts/seed_employees.php 1000 +php scripts/seed_projects.php 6 ``` - -## Frontend Libraries - -The employee directory page uses: - -- `htmx` for fragment-based form and summary updates -- `Alpine.js` for lightweight page state -- `Tabulator` for the interactive employee table diff --git a/public/css/site.css b/public/css/site.css index f0e1fa1..49a6cd8 100644 --- a/public/css/site.css +++ b/public/css/site.css @@ -1,791 +1,196 @@ :root { - --page-background: #f4efe7; + --bg: #f4efe8; --surface: rgba(255, 252, 247, 0.88); --surface-strong: #fffdf8; - --surface-border: rgba(26, 72, 64, 0.12); - --text-primary: #143631; - --text-secondary: #4f655f; - --accent: #1d7a6d; - --accent-strong: #135c52; - --accent-soft: #daf1ec; - --highlight: #ef7c4d; - --shadow-soft: 0 18px 50px rgba(20, 54, 49, 0.1); - --shadow-card: 0 20px 40px rgba(20, 54, 49, 0.08); -} - -* { - box-sizing: border-box; -} - -html { - scroll-behavior: smooth; -} - + --surface-border: rgba(19, 54, 49, 0.1); + --text: #153632; + --muted: #5d706b; + --line: rgba(19, 54, 49, 0.08); + --accent: #0f766e; + --accent-deep: #115e59; + --accent-soft: #dbf2ef; + --warning: #cb6b2c; + --danger: #be2c2c; + --success: #188a51; + --slate: #5a6b79; + --shadow-lg: 0 24px 60px rgba(19, 54, 49, 0.12); + --shadow-md: 0 16px 30px rgba(19, 54, 49, 0.08); +} + +* { box-sizing: border-box; } +html { scroll-behavior: smooth; } body { margin: 0; min-height: 100vh; - font-family: "Trebuchet MS", "Lucida Sans Unicode", "Lucida Grande", sans-serif; - color: var(--text-primary); + font-family: Inter, "Segoe UI", system-ui, -apple-system, BlinkMacSystemFont, sans-serif; + color: var(--text); background: - radial-gradient(circle at top left, rgba(239, 124, 77, 0.18), transparent 28%), - radial-gradient(circle at top right, rgba(29, 122, 109, 0.18), transparent 32%), - linear-gradient(180deg, #f8f2e8 0%, var(--page-background) 48%, #efe6da 100%); -} - -a { - color: inherit; + radial-gradient(circle at top left, rgba(15, 118, 110, 0.12), transparent 25%), + radial-gradient(circle at top right, rgba(203, 107, 44, 0.12), transparent 30%), + linear-gradient(180deg, #faf5ee 0%, var(--bg) 50%, #efe6db 100%); } -code { - font-family: Consolas, "Courier New", monospace; -} - -.page-shell { - min-height: 100vh; - display: flex; - flex-direction: column; -} - -.container { - width: min(1120px, calc(100% - 2rem)); - margin: 0 auto; -} +a { color: inherit; } +img { max-width: 100%; display: block; } +code, pre, kbd { font-family: ui-monospace, SFMono-Regular, Consolas, "Liberation Mono", monospace; } +.page-shell { min-height: 100vh; display: flex; flex-direction: column; } +.container { width: min(1180px, calc(100% - 2rem)); margin: 0 auto; } +.page-content { flex: 1; padding: 2rem 0 4rem; } .site-header { - position: sticky; - top: 0; - z-index: 20; - backdrop-filter: blur(14px); - background: rgba(248, 242, 232, 0.78); - border-bottom: 1px solid rgba(20, 54, 49, 0.08); -} - -.header-inner { - display: flex; - align-items: center; - justify-content: space-between; - gap: 1rem; - padding: 1rem 0; + position: sticky; top: 0; z-index: 20; + background: rgba(250, 245, 238, 0.84); + backdrop-filter: blur(16px); + border-bottom: 1px solid var(--line); } - -.brand { - display: inline-flex; - align-items: center; - gap: 0.85rem; - text-decoration: none; -} - +.header-inner { display: flex; align-items: center; justify-content: space-between; gap: 1rem; padding: 1rem 0; } +.brand { display: inline-flex; align-items: center; gap: 0.85rem; text-decoration: none; } .brand-mark { - display: inline-flex; - align-items: center; - justify-content: center; - width: 2.75rem; - height: 2.75rem; - border-radius: 0.95rem; - background: linear-gradient(135deg, var(--accent), var(--highlight)); - color: #fff; - font-weight: 700; - letter-spacing: 0.08em; - box-shadow: var(--shadow-soft); -} - -.brand-copy { - display: flex; - flex-direction: column; - line-height: 1.1; -} - -.brand-copy strong { - font-size: 1rem; -} - -.brand-copy small { - color: var(--text-secondary); - font-size: 0.75rem; - text-transform: uppercase; - letter-spacing: 0.14em; -} - -.site-nav { - display: flex; - align-items: center; - gap: 0.6rem; - flex-wrap: wrap; -} - + width: 2.75rem; height: 2.75rem; border-radius: 0.95rem; + display: inline-flex; align-items: center; justify-content: center; + background: linear-gradient(135deg, var(--accent), #2dd4bf); + color: #fff; font-weight: 800; letter-spacing: 0.08em; box-shadow: var(--shadow-md); +} +.brand-copy { display: flex; flex-direction: column; line-height: 1.1; } +.brand-copy strong { font-size: 1rem; } +.brand-copy small { color: var(--muted); text-transform: uppercase; letter-spacing: 0.14em; font-size: 0.74rem; } +.site-nav { display: flex; flex-wrap: wrap; gap: 0.5rem; } .nav-link { - text-decoration: none; - color: var(--text-secondary); - font-weight: 600; - padding: 0.7rem 1rem; - border-radius: 999px; - transition: background-color 160ms ease, color 160ms ease, transform 160ms ease; -} - -.nav-link:hover, -.nav-link:focus-visible, -.nav-link.is-active { - color: var(--accent-strong); - background: rgba(29, 122, 109, 0.12); - transform: translateY(-1px); -} - -.page-content { - flex: 1; - padding: 3.5rem 0 4rem; -} - -.content-stack { - display: grid; - gap: 1.5rem; -} - -.section-heading { - max-width: 46rem; -} - -.section-heading h1 { - margin: 0.3rem 0 0.8rem; - font-size: clamp(2.4rem, 5vw, 4rem); - line-height: 1; - letter-spacing: -0.04em; -} - -.section-heading p { - margin: 0; - color: var(--text-secondary); - line-height: 1.8; - font-size: 1.05rem; + text-decoration: none; color: var(--muted); font-weight: 700; + padding: 0.7rem 1rem; border-radius: 999px; transition: transform 160ms ease, background 160ms ease, color 160ms ease; } +.nav-link:hover, .nav-link:focus-visible, .nav-link.is-active { background: rgba(15, 118, 110, 0.1); color: var(--accent-deep); transform: translateY(-1px); } .hero { - display: grid; - grid-template-columns: minmax(0, 1.5fr) minmax(280px, 0.9fr); - gap: 1.5rem; - align-items: stretch; + display: grid; grid-template-columns: minmax(0, 1.5fr) minmax(280px, 0.85fr); gap: 1.4rem; } - -.hero-copy, -.hero-panel, -.feature-card, -.section-panel, -.employee-card, -.alert, -.empty-state { - background: var(--surface); - border: 1px solid var(--surface-border); - box-shadow: var(--shadow-card); -} - -.hero-copy { - padding: 3rem; - border-radius: 2rem; +.hero-copy, .hero-panel, .card, .panel, .stat-card, .metric-card, .task-card, .feed-item, .notice, .empty-state { + background: var(--surface); border: 1px solid var(--surface-border); box-shadow: var(--shadow-md); } - +.hero-copy { border-radius: 2rem; padding: 2.6rem; } +.hero h1, .section-title h1 { margin: 0; line-height: 0.98; letter-spacing: -0.05em; } +.hero h1 { font-size: clamp(2.8rem, 6vw, 4.9rem); } +.section-title h1 { font-size: clamp(2.1rem, 4vw, 3.6rem); } .eyebrow { - display: inline-block; - margin-bottom: 1rem; - padding: 0.4rem 0.75rem; - border-radius: 999px; - background: var(--accent-soft); - color: var(--accent-strong); - font-size: 0.78rem; - font-weight: 700; - text-transform: uppercase; - letter-spacing: 0.14em; -} - -.hero h1 { - margin: 0; - font-size: clamp(2.8rem, 6vw, 4.8rem); - line-height: 0.98; - letter-spacing: -0.04em; -} - -.hero-text { - max-width: 44rem; - margin: 1.25rem 0 0; - font-size: 1.12rem; - line-height: 1.8; - color: var(--text-secondary); -} - -.hero-actions { - display: flex; - flex-wrap: wrap; - gap: 0.85rem; - margin-top: 2rem; -} - + display: inline-flex; align-items: center; gap: 0.4rem; margin-bottom: 1rem; + padding: 0.42rem 0.75rem; border-radius: 999px; background: var(--accent-soft); color: var(--accent-deep); + font-size: 0.78rem; font-weight: 800; text-transform: uppercase; letter-spacing: 0.16em; +} +.hero-text, .section-title p, .panel p, .card p, .feed-item p, .empty-state p { color: var(--muted); line-height: 1.7; } +.hero-text { font-size: 1.08rem; max-width: 52rem; margin: 1.2rem 0 0; } +.hero-actions, .toolbar, .summary-chips, .row-actions, .stack-actions { display: flex; flex-wrap: wrap; gap: 0.75rem; } +.hero-actions { margin-top: 1.8rem; } .button { - display: inline-flex; - align-items: center; - justify-content: center; - padding: 0.9rem 1.35rem; - border-radius: 999px; - text-decoration: none; - font-weight: 700; -} - -.button-primary { - background: linear-gradient(135deg, var(--accent), var(--accent-strong)); - color: #fff; - box-shadow: 0 18px 30px rgba(19, 92, 82, 0.25); -} - -.button-secondary { - background: rgba(29, 122, 109, 0.08); - color: var(--accent-strong); -} - -.hero-panel { - display: flex; - flex-direction: column; - justify-content: space-between; - padding: 2rem; - border-radius: 1.8rem; -} - -.panel-label { - margin: 0 0 1rem; - font-size: 0.78rem; - font-weight: 700; - letter-spacing: 0.16em; - text-transform: uppercase; - color: var(--text-secondary); -} - -.hero-panel code { - display: block; - padding: 1rem 1.1rem; - border-radius: 1.2rem; - background: #173d37; - color: #eefbf6; - line-height: 1.7; - white-space: normal; -} - -.route-callout { - margin-top: 1.5rem; - padding: 1rem 1.1rem; - border-radius: 1.2rem; - background: var(--surface-strong); -} - -.route-callout span { - display: block; - margin-bottom: 0.45rem; - color: var(--text-secondary); - font-size: 0.92rem; -} - -.route-callout a { - color: var(--highlight); - font-weight: 700; - text-decoration: none; -} - -.feature-grid { - display: grid; - grid-template-columns: repeat(3, minmax(0, 1fr)); - gap: 1.25rem; - margin-top: 1.5rem; -} - -.feature-card { - padding: 1.75rem; - border-radius: 1.6rem; -} - -.feature-card h2 { - margin-top: 0; - margin-bottom: 0.8rem; - font-size: 1.25rem; -} - -.feature-card p { - margin: 0; - color: var(--text-secondary); - line-height: 1.7; -} - -.employee-layout { + display: inline-flex; align-items: center; justify-content: center; gap: 0.5rem; + border: 0; text-decoration: none; font-weight: 800; padding: 0.9rem 1.2rem; border-radius: 999px; cursor: pointer; +} +.button-primary { background: linear-gradient(135deg, var(--accent), var(--accent-deep)); color: #fff; } +.button-secondary { background: rgba(15, 118, 110, 0.08); color: var(--accent-deep); } +.button-ghost { background: transparent; color: var(--text); border: 1px solid var(--surface-border); } +.button:hover, .button:focus-visible { transform: translateY(-1px); } + +.hero-panel { border-radius: 1.8rem; padding: 1.8rem; display: grid; gap: 1rem; } +.panel, .card, .stat-card, .metric-card, .task-card, .feed-item, .notice, .empty-state { border-radius: 1.5rem; } +.panel, .card, .stat-card, .metric-card, .notice, .empty-state { padding: 1.25rem; } +.panel h2, .card h2, .metric-card strong { margin: 0; } +.panel h2 { font-size: 1.15rem; } +.panel-label, .meta-label, .kicker { text-transform: uppercase; letter-spacing: 0.14em; font-size: 0.74rem; color: var(--muted); font-weight: 800; } +.project-grid, .metrics-grid, .stats-grid, .feed-grid { display: grid; gap: 1rem; } +.metrics-grid { grid-template-columns: repeat(4, minmax(0, 1fr)); margin-top: 1.2rem; } +.stats-grid { grid-template-columns: repeat(3, minmax(0, 1fr)); } +.project-list { display: grid; gap: 1rem; margin-top: 1rem; } +.card-grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); } +.project-card { display: grid; gap: 0.9rem; padding: 1.2rem; } +.project-card .project-top, .project-card .project-bottom, .project-card .project-meta, .project-card .project-status { display: flex; align-items: center; justify-content: space-between; gap: 0.75rem; flex-wrap: wrap; } +.project-card h3 { margin: 0; font-size: 1.1rem; } +.progress { width: 100%; height: 0.75rem; background: rgba(19, 54, 49, 0.08); border-radius: 999px; overflow: hidden; } +.progress > span { display: block; height: 100%; border-radius: inherit; background: linear-gradient(90deg, var(--accent), #34d399); } +.tag, .status-pill, .mini-pill { + display: inline-flex; align-items: center; gap: 0.35rem; padding: 0.35rem 0.68rem; border-radius: 999px; font-size: 0.76rem; font-weight: 800; +} +.is-neutral { background: rgba(90, 107, 121, 0.12); color: var(--slate); } +.is-blue { background: rgba(15, 118, 110, 0.12); color: var(--accent-deep); } +.is-amber { background: rgba(203, 107, 44, 0.14); color: var(--warning); } +.is-red { background: rgba(190, 44, 44, 0.12); color: var(--danger); } +.is-green { background: rgba(24, 138, 81, 0.12); color: var(--success); } +.is-slate { background: rgba(90, 107, 121, 0.12); color: var(--slate); } + +.shell { display: grid; - grid-template-columns: minmax(320px, 0.9fr) minmax(0, 1.5fr); - gap: 1.5rem; + grid-template-columns: minmax(0, 1.2fr) minmax(320px, 0.7fr); + gap: 1.1rem; align-items: start; } - -.controls-panel, -.table-shell { - overflow: hidden; - background: - linear-gradient(180deg, rgba(255, 255, 255, 0.92), rgba(248, 242, 232, 0.88)), - var(--surface); -} - -.controls-header { - display: flex; - align-items: flex-start; - justify-content: space-between; - gap: 1rem; -} - -.search-row { - display: grid; - grid-template-columns: minmax(0, 1fr); -} - -.field-full { - width: 100%; -} - -.section-panel { - padding: 1.75rem; - border-radius: 1.8rem; -} - -.panel-header { - margin-bottom: 1.5rem; -} - -.panel-header h2 { - margin: 0 0 0.45rem; - font-size: 1.45rem; -} - -.panel-header p { - margin: 0; - color: var(--text-secondary); - line-height: 1.7; -} - -.employee-form { - display: grid; - gap: 1.25rem; -} - -.form-grid { - display: grid; - grid-template-columns: repeat(2, minmax(0, 1fr)); - gap: 1rem; -} - -.field { - display: grid; - gap: 0.45rem; - font-weight: 600; -} - -.field span { - font-size: 0.96rem; -} - -.input { - width: 100%; - padding: 0.95rem 1rem; - border: 1px solid rgba(20, 54, 49, 0.16); - border-radius: 1rem; - background: rgba(255, 255, 255, 0.92); - color: var(--text-primary); - font: inherit; -} - -.input:focus { - outline: 2px solid rgba(29, 122, 109, 0.22); - border-color: rgba(29, 122, 109, 0.45); -} - -.field-error { - color: #a43d1f; - font-size: 0.88rem; - font-weight: 600; -} - -.form-actions { - display: flex; - justify-content: flex-start; - align-items: center; - gap: 0.85rem; -} - -.button { - border: 0; - cursor: pointer; -} - -.htmx-indicator { - display: none; -} - -.htmx-request .htmx-indicator, -.htmx-request.htmx-indicator { - display: inline-flex; -} - -.inline-indicator { - color: var(--text-secondary); - font-size: 0.9rem; - font-weight: 600; -} - -.alert, -.empty-state { - padding: 1rem 1.15rem; - border-radius: 1.2rem; -} - -.alert-success { - background: rgba(218, 241, 236, 0.92); - color: var(--accent-strong); -} - -.alert-error { - background: rgba(239, 124, 77, 0.14); - color: #8f3518; -} - -.empty-state p { - margin: 0; - color: var(--text-secondary); - line-height: 1.7; -} - -.empty-state p + p { - margin-top: 0.45rem; -} - -.employee-cards { - display: grid; - gap: 1rem; -} - -.employee-card { - padding: 1.15rem; - border-radius: 1.3rem; -} - -.employee-card-top { - display: flex; - align-items: flex-start; - justify-content: space-between; - gap: 1rem; - margin-bottom: 0.8rem; -} - -.employee-card-top h3 { - margin: 0; - font-size: 1.05rem; -} - -.employee-card-top span { - padding: 0.4rem 0.7rem; - border-radius: 999px; - background: rgba(29, 122, 109, 0.09); - color: var(--accent-strong); - font-size: 0.78rem; - font-weight: 700; -} - -.employee-card p { - margin: 0 0 1rem; - color: var(--text-secondary); -} - -.employee-meta { - display: grid; - gap: 0.75rem; - margin: 0; -} - -.employee-meta div { - display: grid; - gap: 0.2rem; -} - -.employee-meta dt { - color: var(--text-secondary); - font-size: 0.82rem; - text-transform: uppercase; - letter-spacing: 0.08em; -} - -.employee-meta dd { - margin: 0; - font-weight: 600; -} - -.stats-grid { - display: grid; - grid-template-columns: repeat(3, minmax(0, 1fr)); - gap: 0.9rem; -} - -.stat-card { - padding: 1rem; - border-radius: 1.3rem; - background: rgba(255, 255, 255, 0.72); - border: 1px solid rgba(20, 54, 49, 0.08); -} - -.stat-card span { - display: block; - color: var(--text-secondary); - font-size: 0.82rem; - text-transform: uppercase; - letter-spacing: 0.08em; -} - -.stat-card strong { - display: block; - margin-top: 0.45rem; - font-size: 1.7rem; - line-height: 1; -} - -.summary-feature { - margin-top: 1rem; - padding: 1.15rem; - border-radius: 1.3rem; - background: linear-gradient(135deg, rgba(29, 122, 109, 0.12), rgba(239, 124, 77, 0.12)); -} - -.summary-label { - display: block; - color: var(--text-secondary); - font-size: 0.82rem; - text-transform: uppercase; - letter-spacing: 0.08em; -} - -.summary-feature h3 { - margin: 0.55rem 0 0.3rem; - font-size: 1.35rem; -} - -.summary-feature p { - margin: 0; - color: var(--text-secondary); -} - -.table-toolbar { - display: flex; - align-items: center; - justify-content: space-between; - gap: 1rem; - margin-bottom: 1rem; - flex-wrap: wrap; - padding: 0.9rem 1rem; - border: 1px solid rgba(20, 54, 49, 0.08); - border-radius: 1rem; - background: rgba(255, 255, 255, 0.58); -} - -.table-pill { - display: inline-flex; - align-items: center; - padding: 0.5rem 0.8rem; - border-radius: 999px; - background: rgba(29, 122, 109, 0.12); - color: var(--accent-strong); - font-size: 0.82rem; - font-weight: 700; - letter-spacing: 0.04em; -} - -.table-caption { - color: var(--text-secondary); - font-size: 0.92rem; -} - -.directory-panel .tabulator-host { - min-height: 38rem; -} - -.tabulator-host .tabulator { +.board-shell { display: grid; gap: 1rem; } +.board { display: grid; gap: 1rem; grid-template-columns: repeat(5, minmax(0, 1fr)); } +.column { display: grid; gap: 0.85rem; align-content: start; background: rgba(255,255,255,0.4); border: 1px solid var(--surface-border); border-radius: 1.4rem; padding: 1rem; } +.column header { display: flex; justify-content: space-between; align-items: center; gap: 0.5rem; } +.column h3 { margin: 0; font-size: 0.98rem; } +.column .count { color: var(--muted); font-size: 0.84rem; font-weight: 700; } +.task-card { padding: 1rem; display: grid; gap: 0.75rem; } +.task-card header, .task-card footer, .task-card .task-meta { display: flex; justify-content: space-between; align-items: center; gap: 0.6rem; flex-wrap: wrap; } +.task-card h4 { margin: 0; font-size: 1rem; } +.task-card p { margin: 0; font-size: 0.95rem; } +.task-card .task-body { display: grid; gap: 0.5rem; } +.task-card .task-footnote { font-size: 0.82rem; color: var(--muted); } +.task-form, .project-form, .filter-bar { display: grid; gap: 1rem; } +.form-grid { display: grid; gap: 1rem; grid-template-columns: repeat(2, minmax(0, 1fr)); } +.field { display: grid; gap: 0.45rem; } +.field span { font-size: 0.86rem; font-weight: 700; color: var(--muted); } +.input, .select, .textarea { + width: 100%; border-radius: 1rem; border: 1px solid var(--surface-border); background: rgba(255,255,255,0.85); + padding: 0.9rem 1rem; color: var(--text); font: inherit; outline: none; +} +.textarea { min-height: 10rem; resize: vertical; } +.input:focus, .select:focus, .textarea:focus { border-color: rgba(15,118,110,0.4); box-shadow: 0 0 0 4px rgba(15,118,110,0.12); } +.helper, .field-error, .fineprint { color: var(--muted); font-size: 0.84rem; line-height: 1.5; } +.field-error { color: var(--danger); } +.alert { border-radius: 1rem; padding: 0.95rem 1rem; } +.alert-success { background: rgba(24, 138, 81, 0.12); color: var(--success); } +.alert-error { background: rgba(190, 44, 44, 0.12); color: var(--danger); } +.stack { display: grid; gap: 1rem; } +.layout-two { display: grid; gap: 1rem; grid-template-columns: minmax(0, 1.3fr) minmax(320px, 0.7fr); } +.side-stack { display: grid; gap: 1rem; } +.kpi { display: flex; flex-direction: column; gap: 0.35rem; } +.kpi strong { font-size: 1.6rem; } +.list { display: grid; gap: 0.8rem; } +.list-item, .feed-item { padding: 1rem; } +.feed-item { display: grid; gap: 0.45rem; } +.feed-item header { display: flex; justify-content: space-between; gap: 0.75rem; flex-wrap: wrap; } +.board-actions, .project-actions, .task-actions { display: flex; flex-wrap: wrap; gap: 0.6rem; } +.badge-row { display: flex; flex-wrap: wrap; gap: 0.5rem; } +.board-header { display: flex; justify-content: space-between; align-items: center; gap: 0.75rem; flex-wrap: wrap; } +.project-header { display: grid; gap: 1rem; } +.project-hero { + display: grid; gap: 1rem; padding: 1.4rem; border-radius: 1.8rem; background: linear-gradient(135deg, rgba(15,118,110,0.12), rgba(255,255,255,0.66)); border: 1px solid var(--surface-border); - border-radius: 1.35rem; - overflow: hidden; - background: rgba(255, 255, 255, 0.82); - box-shadow: - inset 0 1px 0 rgba(255, 255, 255, 0.5), - 0 18px 35px rgba(20, 54, 49, 0.08); -} - -.tabulator-host .tabulator-header { - border-bottom: 1px solid rgba(20, 54, 49, 0.08); - background: linear-gradient(180deg, rgba(29, 122, 109, 0.14), rgba(29, 122, 109, 0.08)); -} - -.tabulator-host .tabulator-header .tabulator-col { - min-height: 3.25rem; - background: transparent; - border-right: 1px solid rgba(20, 54, 49, 0.06); -} - -.tabulator-host .tabulator-header .tabulator-col:last-child { - border-right: 0; -} - -.tabulator-host .tabulator-header .tabulator-col .tabulator-col-content { - padding: 0.9rem 0.95rem 0.85rem; -} - -.tabulator-host .tabulator-header .tabulator-col .tabulator-col-title { - font-size: 0.78rem; - font-weight: 800; - letter-spacing: 0.08em; - text-transform: uppercase; - color: var(--accent-strong); -} - -.tabulator-host .tabulator-col, -.tabulator-host .tabulator-cell { - border-right: 1px solid rgba(20, 54, 49, 0.06); -} - -.tabulator-host .tabulator-row .tabulator-cell:last-child { - border-right: 0; -} - -.tabulator-host .tabulator-row { - background: rgba(255, 255, 255, 0.96); - border-bottom: 1px solid rgba(20, 54, 49, 0.06); - transition: background-color 160ms ease, transform 160ms ease; -} - -.tabulator-host .tabulator-row:nth-child(even) { - background: rgba(248, 242, 232, 0.82); -} - -.tabulator-host .tabulator-row:hover { - background: rgba(218, 241, 236, 0.72); -} - -.tabulator-host .tabulator-row.tabulator-selected { - background: rgba(29, 122, 109, 0.18); -} - -.tabulator-host .tabulator-cell { - padding: 0.95rem 0.95rem; - font-size: 0.96rem; - line-height: 1.4; -} - -.tabulator-host .tabulator-row .tabulator-cell:first-child { - font-weight: 700; - color: var(--text-primary); } - -.tabulator-host .tabulator-footer { - padding: 0.55rem 0.7rem; - background: rgba(255, 255, 255, 0.88); - border-top: 1px solid rgba(20, 54, 49, 0.08); -} - -.tabulator-host .tabulator-footer .tabulator-paginator { - font-family: inherit; -} - -.tabulator-host .tabulator-footer .tabulator-page { - margin: 0 0.2rem; - padding: 0.45rem 0.7rem; - border: 1px solid rgba(20, 54, 49, 0.1); - border-radius: 0.8rem; - background: rgba(255, 255, 255, 0.9); - color: var(--text-secondary); - font-weight: 700; -} - -.tabulator-host .tabulator-footer .tabulator-page.active, -.tabulator-host .tabulator-footer .tabulator-page:hover { - background: linear-gradient(135deg, var(--accent), var(--accent-strong)); - border-color: transparent; - color: #fff; -} - -.tabulator-host .tabulator-footer .tabulator-page:disabled { - opacity: 0.45; -} - -.tabulator-host .tabulator-placeholder { - padding: 2.5rem 1rem; - color: var(--text-secondary); - font-size: 1rem; - font-weight: 600; -} - -.site-footer { - margin-top: auto; - border-top: 1px solid rgba(20, 54, 49, 0.08); - background: rgba(255, 252, 247, 0.72); -} - -.footer-inner { - display: flex; - justify-content: space-between; - gap: 1rem; - padding: 1.25rem 0 2rem; - color: var(--text-secondary); - font-size: 0.95rem; -} - -.footer-inner p { - margin: 0; -} - -@media (max-width: 860px) { - .header-inner, - .footer-inner { - flex-direction: column; - align-items: flex-start; - } - - .hero, - .feature-grid, - .employee-layout { - grid-template-columns: 1fr; - } - - .controls-header, - .table-toolbar { - flex-direction: column; - align-items: flex-start; - } - - .hero-copy, - .hero-panel { - padding: 2rem; - } - - .form-grid { - grid-template-columns: 1fr; - } - - .stats-grid { - grid-template-columns: 1fr; - } - - .page-content { - padding-top: 2rem; - } -} - -@media (max-width: 560px) { - .container { - width: min(100% - 1.25rem, 1120px); - } - - .site-nav { - width: 100%; - } - - .nav-link { - width: 100%; - text-align: center; - } - - .hero h1 { - font-size: 2.5rem; - } +.project-meta-grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 1rem; } +.meta-card { padding: 0.95rem 1rem; border-radius: 1.2rem; background: rgba(255,255,255,0.8); border: 1px solid var(--surface-border); } +.meta-card span { display: block; color: var(--muted); font-size: 0.8rem; font-weight: 700; text-transform: uppercase; letter-spacing: 0.12em; } +.meta-card strong { display: block; margin-top: 0.4rem; font-size: 1rem; } +.members-list { display: grid; gap: 0.65rem; } +.member-chip { display: flex; justify-content: space-between; gap: 0.75rem; align-items: center; padding: 0.75rem 0.9rem; border-radius: 1rem; background: rgba(255,255,255,0.72); border: 1px solid var(--surface-border); } +.member-chip strong { font-size: 0.95rem; } +.member-chip small { color: var(--muted); } +.block-title { display: flex; justify-content: space-between; align-items: center; gap: 0.75rem; flex-wrap: wrap; } +.board-toolbar, .filter-bar { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: end; } +.layout-top { display: flex; justify-content: space-between; align-items: end; gap: 1rem; flex-wrap: wrap; } +.empty-state { text-align: center; padding: 2rem; } +.site-footer { border-top: 1px solid var(--line); padding: 1.8rem 0 2.4rem; color: var(--muted); } +.footer-inner { display: flex; justify-content: space-between; gap: 1rem; flex-wrap: wrap; } +.skip-link { position: absolute; left: -9999px; top: 1rem; } +.skip-link:focus { left: 1rem; z-index: 30; background: #fff; padding: 0.75rem 1rem; border-radius: 0.8rem; } + +@media (max-width: 1100px) { + .hero, .shell, .layout-two, .project-meta-grid, .metrics-grid, .stats-grid, .board { grid-template-columns: 1fr 1fr; } + .board { grid-template-columns: repeat(2, minmax(0, 1fr)); } +} + +@media (max-width: 820px) { + .header-inner, .layout-top, .board-header, .project-meta-grid, .stats-grid, .metrics-grid, .board, .shell, .layout-two { grid-template-columns: 1fr; } + .header-inner, .footer-inner { flex-direction: column; align-items: flex-start; } + .hero { grid-template-columns: 1fr; } + .form-grid { grid-template-columns: 1fr; } + .board { grid-template-columns: 1fr; } } diff --git a/public/index.php b/public/index.php index 9d26c73..b5f254f 100644 --- a/public/index.php +++ b/public/index.php @@ -2,7 +2,7 @@ declare(strict_types=1); -require_once __DIR__ . '/../vendor/autoload.php'; +require_once __DIR__ . '/../autoload.php'; use Core\App; use Core\Dispatcher; diff --git a/public/js/app.js b/public/js/app.js index 62af4cb..4876f1d 100644 --- a/public/js/app.js +++ b/public/js/app.js @@ -1,64 +1,17 @@ -window.employeeDirectory = function () { +window.projectCompass = function () { return { - search: '', - table: null, - init() { - this.search = this.$root.querySelector('#employee-search')?.value ?? ''; - this.initTable(); - - document.body.addEventListener('employees-changed', () => { - this.reloadTable(); - }); - }, - - initTable() { - const tableElement = document.getElementById('employee-table'); - - if (!tableElement || typeof Tabulator === 'undefined') { - return; - } - - this.table = new Tabulator(tableElement, { - ajaxURL: '/employees/data', - ajaxParams: { - search: this.search, - }, - layout: 'fitColumns', - responsiveLayout: 'collapse', - pagination: true, - paginationMode: 'local', - paginationSize: 8, - movableColumns: true, - placeholder: 'No employees found.', - columns: [ - { title: 'Name', field: 'full_name', minWidth: 180 }, - { title: 'Email', field: 'email', minWidth: 220 }, - { title: 'Department', field: 'department', minWidth: 140 }, - { title: 'Job Title', field: 'job_title', minWidth: 180 }, - { title: 'Start Date', field: 'start_date', hozAlign: 'left', minWidth: 130 }, - ], - }); - }, - - applySearch() { - if (!this.table) { - return; - } - - this.table.setData('/employees/data', { - search: this.search, - }); - }, - - reloadTable() { - if (!this.table) { - this.initTable(); + const filter = document.querySelector('[data-live-filter]'); + if (!filter) { return; } - this.table.setData('/employees/data', { - search: this.search, + filter.addEventListener('input', () => { + const query = filter.value.trim().toLowerCase(); + document.querySelectorAll('[data-filter-item]').forEach((item) => { + const text = item.textContent?.toLowerCase() ?? ''; + item.style.display = text.includes(query) ? '' : 'none'; + }); }); }, }; diff --git a/public/web.config b/public/web.config new file mode 100644 index 0000000..e5263cc --- /dev/null +++ b/public/web.config @@ -0,0 +1,24 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/routes/web.php b/routes/web.php index 44cc940..2c85464 100644 --- a/routes/web.php +++ b/routes/web.php @@ -3,12 +3,15 @@ declare(strict_types=1); use App\Controllers\HomeController; -use App\Controllers\EmployeeController; +use App\Controllers\ProjectController; +use App\Controllers\TaskController; $router->get('/', [HomeController::class, 'index']); -$router->get('/users/{id}', [HomeController::class, 'user']); -$router->get('/employees', [EmployeeController::class, 'index']); -$router->get('/employees/create', [EmployeeController::class, 'create']); -$router->get('/employees/summary', [EmployeeController::class, 'summary']); -$router->get('/employees/data', [EmployeeController::class, 'data']); -$router->post('/employees', [EmployeeController::class, 'store']); +$router->get('/projects', [ProjectController::class, 'index']); +$router->get('/projects/create', [ProjectController::class, 'create']); +$router->post('/projects', [ProjectController::class, 'store']); +$router->get('/projects/{id}', [ProjectController::class, 'show']); +$router->post('/projects/{id}/status', [ProjectController::class, 'updateStatus']); +$router->post('/projects/{id}/tasks', [TaskController::class, 'store']); +$router->post('/tasks/{id}/status', [TaskController::class, 'updateStatus']); +$router->get('/activity', [HomeController::class, 'activity']); diff --git a/scripts/README.md b/scripts/README.md index ff39152..34d138f 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -8,7 +8,7 @@ Examples: php scripts/migrate.php up php scripts/migrate.php status php scripts/migrate.php fresh --seed -php scripts/seed_employees.php 1000 +php scripts/seed_projects.php --reset ``` Guidelines: diff --git a/scripts/migrate.php b/scripts/migrate.php index 394781b..cf9fca5 100644 --- a/scripts/migrate.php +++ b/scripts/migrate.php @@ -2,7 +2,7 @@ declare(strict_types=1); -require_once __DIR__ . '/../vendor/autoload.php'; +require_once __DIR__ . '/../autoload.php'; $command = $argv[1] ?? 'help'; $options = array_slice($argv, 2); @@ -62,7 +62,7 @@ try { $name = $argv[2] ?? ''; if ($name === '') { - throw new InvalidArgumentException('Provide a migration name. Example: php scripts/migrate.php make create_projects_table'); + throw new InvalidArgumentException('Provide a migration name. Example: php scripts/migrate.php make create_project_management_tables'); } $path = $manager->make($name); @@ -81,8 +81,8 @@ try { } if (in_array('--seed', $options, true)) { - require __DIR__ . '/../database/seed_employees.php'; - seed_employees(1000, true); + require __DIR__ . '/../database/seed_projects.php'; + seed_projects(6, true); } echo "Fresh migration run complete." . PHP_EOL; diff --git a/scripts/seed_employees.php b/scripts/seed_employees.php deleted file mode 100644 index 2d68499..0000000 --- a/scripts/seed_employees.php +++ /dev/null @@ -1,8 +0,0 @@ -execute('CREATE TABLE projects (id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(100) NOT NULL)'); - } - - public function down(Database $database): void - { - $database->execute('DROP TABLE IF EXISTS projects'); - } -}; -PHP -); +copy(__DIR__ . '/../database/migrations/20260509_000001_create_project_management_tables.php', $tempMigrationPath . '/20260509_000001_create_projects_tables.php'); $memoryDatabase = new Database([ 'dsn' => 'sqlite::memory:', @@ -46,100 +24,115 @@ $memoryDatabase = new Database([ ], ]); -$migrationManager = new MigrationManager($memoryDatabase, $tempMigrationPath); -$ran = $migrationManager->runPending(); +set_database($memoryDatabase); +(new MigrationManager($memoryDatabase, $tempMigrationPath))->runPending(); +require_once __DIR__ . '/../database/seed_projects.php'; +seed_projects(4, true); -if ($ran !== ['20260509_120000_create_projects_table.php']) { - echo "FAIL: migration manager did not apply the expected migration\n"; - exit(1); -} +$router = new Router(); +$app = new App(); +require_once __DIR__ . '/../routes/web.php'; -$projectTable = $memoryDatabase->first("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'projects'"); +$dispatcher = new Dispatcher($router, $app); -if ($projectTable === null) { - echo "FAIL: migration up() did not create the projects table\n"; +$home = $dispatcher->dispatch(new Request([], [], [ + 'REQUEST_METHOD' => 'GET', + 'REQUEST_URI' => '/', +])); + +if ($home->status() !== 200 || strpos($home->content(), 'Project Compass') === false) { + echo "FAIL: dashboard did not render\n"; exit(1); } -$rolledBack = $migrationManager->rollback(); +$projectsPage = $dispatcher->dispatch(new Request([], [], [ + 'REQUEST_METHOD' => 'GET', + 'REQUEST_URI' => '/projects', +])); -if ($rolledBack !== ['20260509_120000_create_projects_table.php']) { - echo "FAIL: migration manager did not roll back the expected migration\n"; +if ($projectsPage->status() !== 200 || strpos($projectsPage->content(), 'Projects') === false) { + echo "FAIL: projects list did not render\n"; exit(1); } -$projectTableAfterRollback = $memoryDatabase->first("SELECT name FROM sqlite_master WHERE type = 'table' AND name = 'projects'"); +$createPage = $dispatcher->dispatch(new Request([], [], [ + 'REQUEST_METHOD' => 'GET', + 'REQUEST_URI' => '/projects/create', +])); -if ($projectTableAfterRollback !== null) { - echo "FAIL: migration down() did not remove the projects table\n"; +if ($createPage->status() !== 200 || strpos($createPage->content(), 'Create project') === false) { + echo "FAIL: create project page did not render\n"; exit(1); } -$createdMigrationPath = $migrationManager->make('create_tasks_table'); +$projectPage = $dispatcher->dispatch(new Request([], [], [ + 'REQUEST_METHOD' => 'GET', + 'REQUEST_URI' => '/projects/1', +])); -if (!file_exists($createdMigrationPath)) { - echo "FAIL: migration manager did not create a migration file\n"; +if ($projectPage->status() !== 200 || strpos($projectPage->content(), 'Kanban board') === false) { + echo "FAIL: project board did not render\n"; exit(1); } -$router = new Router(); -$app = new App(); - -(new MigrationManager(database(), __DIR__ . '/../database/migrations'))->runPending(); - -require_once __DIR__ . '/../routes/web.php'; - -$router->get('/hello/{name}', function (string $name) { - return 'Hello, ' . $name; -}); - -$request = new Request([], [], [ - 'REQUEST_METHOD' => 'GET', - 'REQUEST_URI' => '/hello/Daniel', +$newProjectRequest = new Request([ + '_token' => csrf_token(), +], [ + '_token' => csrf_token(), + 'name' => 'Orbit Mobile Relaunch', + 'code' => '', + 'client_name' => 'Orbit Labs', + 'description' => 'A fresh mobile experience with project tracking and delivery visibility.', + 'status' => 'planned', + 'start_date' => '2026-05-09', + 'due_date' => '2026-08-09', + 'budget_cents' => '750000', + 'owner_name' => 'Jordan Ellis', + 'color_token' => 'emerald', + 'members_text' => "Jordan Ellis\nRiley Kim", +], [ + 'REQUEST_METHOD' => 'POST', + 'REQUEST_URI' => '/projects', ]); -$response = (new Dispatcher($router, $app))->dispatch($request); +$created = $dispatcher->dispatch($newProjectRequest); -if ($response->status() !== 200) { - echo "FAIL: expected status 200\n"; +if ($created->status() !== 302) { + echo "FAIL: project creation did not redirect\n"; exit(1); } -if ($response->content() !== 'Hello, Daniel') { - echo "FAIL: unexpected response content\n"; - exit(1); -} +$taskRequest = new Request([ + '_token' => csrf_token(), +], [ + '_token' => csrf_token(), + 'title' => 'Design the intake flow', + 'description' => 'Create a simple intake flow for requests and approvals.', + 'priority' => 'high', + 'status' => 'backlog', + 'assignee' => 'Jordan Ellis', + 'estimate_hours' => '10', + 'due_date' => '2026-05-20', +], [ + 'REQUEST_METHOD' => 'POST', + 'REQUEST_URI' => '/projects/5/tasks', +]); -$employeePage = (new Dispatcher($router, $app))->dispatch(new Request([], [], [ - 'REQUEST_METHOD' => 'GET', - 'REQUEST_URI' => '/employees', -])); +$taskCreated = $dispatcher->dispatch($taskRequest); -if ($employeePage->status() !== 200) { - echo "FAIL: expected employee page status 200\n"; +if ($taskCreated->status() !== 302) { + echo "FAIL: task creation did not redirect\n"; exit(1); } -if (strpos($employeePage->content(), 'Add Employee') === false) { - echo "FAIL: employee page did not render form content\n"; - exit(1); -} - -$employeeData = (new Dispatcher($router, $app))->dispatch(new Request([ - 'search' => '', -], [], [ +$activity = $dispatcher->dispatch(new Request([], [], [ 'REQUEST_METHOD' => 'GET', - 'REQUEST_URI' => '/employees/data', + 'REQUEST_URI' => '/activity', ])); -if ($employeeData->status() !== 200) { - echo "FAIL: expected employee data status 200\n"; - exit(1); -} - -if (strpos($employeeData->content(), '[') === false) { - echo "FAIL: employee data endpoint did not return JSON array content\n"; +if ($activity->status() !== 200 || strpos($activity->content(), 'Activity feed') === false) { + echo "FAIL: activity feed did not render\n"; exit(1); } -echo "PASS: migration manager and route dispatch work\n"; +echo "PASS: project management app routes and data flow work\n";