# Q Tech Logistics Portal - Project Plan

**Client:** Q Tech Logistics  
**Delivered by:** MOMATSTUDIO IT Solutions  
**Created:** 21 October 2026  
**Current phase:** Phase 2 - Milestone 9 courses and materials ready for review
**Delivery rule:** Complete, review and approve one milestone before starting the next.

Milestones 6-10 were started at the project owner's direction before the account-specific Milestone 5 hosting checks were complete. Those checks remain mandatory before deployment and this exception does not authorise Milestone 11.

## 1. Goal

Build a secure administration and learner-management portal that continues the journey started by the production website at https://www.qtechlogistics.co.za. The website remains the public source of company and course information. The portal will manage applications, supporting documents, admissions decisions, enrolments, learning materials, assessments and results.

The portal is a separate Laravel application named Q-Tech-Logistics-Portal at portal.qtechlogistics.co.za. One application will contain a branded Filament learner panel at /learner and a Filament staff panel at /admin.

## 2. Success Criteria

- Applicants can register, verify their email and apply for one of the three initial courses.
- Learners can access only their own applications, documents, enrolments, materials, submissions and published results.
- Administrators can review applications, manage statuses and documents, enrol learners, publish materials and assessments, and release results.
- Personal files remain private and are never exposed through public URLs.
- The portal works on mobile and desktop and can be operated by Q Tech Logistics after handover.
- The production website remains stable while the portal is developed separately.

## 3. Confirmed Scope

### Learner

- Registration, verification, login, logout and password reset.
- Profile and course application with recorded privacy consent.
- Application status and learner-facing messages.
- One administrator-configured global supporting-document checklist.
- Secure document and assessment uploads.
- Materials for assigned courses only.
- Published scores, outcomes and feedback.

### Administrator

- Secure login and operational dashboard.
- Application search, filtering, review and status management.
- Private notes kept separate from learner-facing messages.
- Global document-checklist management and document review.
- Enrolment, material, assessment and result management.
- Manual capture of selected active applications received before portal launch.

### Website integration

- The current Web3Forms application remains active during development.
- After portal approval, Apply links direct applicants to the learner panel and may pass a valid course slug.
- Web3Forms remains in use for general enquiries.
- The email-based application flow is retired only after portal launch approval.

## 4. Core Workflow

1. An applicant registers, verifies their email and completes a draft application.
2. Submission records the consent version, locks the application for review and sends confirmations.
3. An administrator moves it through Submitted, Under Review, Accepted or Unsuccessful.
4. The learner completes the approved global document checklist.
5. An accepted applicant receives an active course enrolment.
6. The learner accesses assigned materials and submits assessment work.
7. The administrator records and deliberately publishes the result.

## 5. Milestones

### Milestone 5 - Planning and hosting validation (waiting for hosting validation)

- Create the portal plan, progress tracker and architecture specification.
- Confirm the application boundary, panels, roles, workflows and initial data model.
- Validate the Afrihost environment against the architecture checklist.
- Record client decisions and content still required.

**Approval gate:** the documents are consistent, the client approves the workflow and the mandatory hosting checks pass.

### Milestone 6 - Platform foundation (completed locally)

- Create the Laravel application and Git repository.
- Install a hosting-compatible, security-supported Laravel and Filament combination.
- Configure the panels, authentication, roles, MySQL, private storage, SMTP and logging.

**Approval gate:** both roles authenticate successfully, panel separation is enforced and no secrets are committed.

### Milestone 7 - Applications and review (completed locally)

- Build the approved application form and seed the three courses.
- Implement the state workflow, admin review, filters, notes, messages and notifications.

**Approval gate:** a test learner can apply and an administrator can complete the review without exposing another learner's data.

### Milestone 8 - Learner records and documents (completed locally)

- Configure the approved global checklist.
- Implement private uploads, replacements, validation and review.
- Add manual capture for selected historical applications.

**Approval gate:** authorised users can retrieve test files; public and unauthorised requests are denied.

### Milestone 9 - Courses and materials (ready for review)

- Implement enrolments and administrator-managed learning materials.
- Restrict course content to active enrolments.

**Approval gate:** course access follows enrolment and is removed when enrolment is inactive.

### Milestone 10 - Assessments and results (ready for review)

- Implement assessment instructions, due dates, learner submissions and receipts.
- Implement scores, outcomes, feedback and controlled result publication.

**Approval gate:** draft results remain private and the complete journey passes ownership tests.

### Milestone 11 - Migration, testing, training and launch (not started)

- Capture the client-approved historical applications manually.
- Complete security, functional, email, upload, mobile, browser and user-acceptance testing.
- Deliver administrator training and a handover guide.
- Deploy the portal, update website application links and start the 30-day defect warranty.

**Approval gate:** Q Tech Logistics signs off the production portal and handover.

## 6. Indicative Sequence

The portal is expected to take approximately six to eight weeks after Milestone 5 approval and receipt of the required access, content and decisions.

| Milestone | Indicative effort | Starts when |
|---|---:|---|
| 5 - Planning and hosting validation | 2-3 working days | Planning starts |
| 6 - Platform foundation | 1 week | Milestone 5 approved |
| 7 - Applications and review | 1-2 weeks | Milestone 6 approved |
| 8 - Learner records and documents | 1-2 weeks | Milestone 7 approved |
| 9 - Courses and materials | 1 week | Milestone 8 approved |
| 10 - Assessments and results | 1 week | Milestone 9 approved |
| 11 - Testing, training and launch | 1 week | Milestone 10 approved |

## 7. Client Inputs Required

- Approved global supporting-document list.
- File-size limit and any formats in addition to PDF, JPEG and PNG.
- Personal-information retention and deletion period.
- First administrator's name and email address.
- Final application fields and consent wording.
- Assessment scoring, outcome and publication rules.
- Initial course materials and assessment instructions.
- Historical applications selected for manual capture.
- Afrihost technical information needed for the readiness assessment.

Production document collection stays disabled until the checklist, privacy wording and retention rules are approved.

## 8. Out of Scope

- Online examinations, quizzes, live classes, video conferencing and in-platform marking.
- Certificates, transcripts, attendance tracking, payments, SMS, WhatsApp and CRM integrations.
- Advanced analytics, custom reports, bulk imports, multiple staff roles, full audit trails and cohort automation.
- Native mobile applications, offline access and automatic mailbox migration.
- Ongoing maintenance, monitoring, backups or content updates after the agreed warranty unless separately contracted.

## 9. Milestone Control

Milestone 9 is implemented locally and ready for review. Administrators can manage enrolments and private course files, while learners can access only published materials for current active enrolments. Initial course files, production material limits and the Milestone 9 review remain open. Milestone 5 hosting checks must still pass before deployment, production document collection remains disabled until its client approval gates are closed, and Milestones 10-11 remain unimplemented.
