BLOXXWAVE DIGITAL — PROJECT PROGRESS PORTAL
============================================

This is a lightweight PHP + MySQL portal for the PaperGarden WebDev project.
It includes a password-protected client page and a separate admin dashboard.
Progress is calculated automatically as:
  completed tasks / total tasks * 100
Only tasks with status "Completed" count as finished.

IMPORTANT SECURITY NOTES
------------------------
- Use HTTPS for the subdomain.
- Choose strong, unique admin and client passwords.
- Delete setup.php immediately after the initial setup completes.
- Do not place credentials or sensitive information in task notes.
- Keep regular database backups.
- This starter does not process payments or store files yet. It tracks project
  status only. Payment records, file uploads, client feedback, and notifications
  would be separate features to add later.
- The .htaccess file uses Apache directives. If your hosting uses a different
  web server or blocks these directives, ask your host before changing them.

DEPLOYMENT ON CPANEL
--------------------
1. Create a subdomain:
   cPanel > Domains (or Subdomains) > create projects.bloxxwave.com.
   Let cPanel create/use a dedicated document root for this subdomain.
   Do not replace or move your existing BloxxWave website files.

2. Enable SSL for projects.bloxxwave.com:
   Use cPanel SSL/TLS Status or your hosting provider's SSL tool.
   Confirm the portal opens with https:// before sharing it.

3. Create a MySQL database and database user:
   cPanel > MySQL Database Wizard (or MySQL Databases).
   Create a database, create a user with a strong password, and grant that user
   privileges on this database. cPanel may prefix the database/user names.

4. Upload the contents of this ZIP to the subdomain's document root.
   The document root should contain index.php, config.php, setup.php, admin/,
   includes/, and assets/ directly. Do not upload the outer ZIP folder itself
   as an extra nested directory.

5. Edit config.php and set:
   db_host = usually localhost (confirm with your host)
   db_name = full cPanel-prefixed database name
   db_user = full cPanel-prefixed database username
   db_pass = database user's password
   Do not share config.php. File permissions should generally be 644.

6. Visit https://projects.bloxxwave.com/setup.php.
   Create a unique admin username/password and a separate client page password.
   The installer creates the tables and initial PaperGarden project/tasks.
   If you see a database connection error, double-check config.php and database
   privileges. If setup partly failed, inspect the database before retrying.

7. Immediately delete setup.php using cPanel File Manager after success.
   Then visit /admin/login.php and sign in. Review task statuses and project
   status. The initial task list contains 14 tasks and zero completed tasks, so
   the initial calculated progress is 0%. Domain registration is awaiting
   approval and is not counted as complete.

8. Visit https://projects.bloxxwave.com/login.php and test the client password.
   Only share the client URL and client password with PaperGarden.LK. Keep
   /admin/login.php and admin credentials for yourself.

9. Test on desktop and mobile, log out, and verify client pages require the
   password. Confirm no setup.php remains online.

HOW TO UPDATE PROJECT PROGRESS
------------------------------
1. Go to /admin/login.php.
2. Edit project status and the client update message as needed.
3. In the task checklist, change each task status.
4. Mark a task "Completed" only when it is genuinely finished.
5. Click "Save task checklist". The progress bar recalculates automatically.
6. Add tasks if needed. Adding a task changes the denominator and therefore
   recalculates the percentage. Delete a task only if it is no longer in scope.

STATUS MEANINGS
---------------
Not started          Work has not begun.
In progress          Work is currently being done.
Awaiting approval    Waiting for an external approval or decision.
Completed            Work is finished; counts toward progress.
Blocked              Work cannot proceed until a blocker is resolved.

INITIAL TASKS
-------------
1. Domain registration — Awaiting approval
2. Purchase domain & hosting — In progress
3. Start web development locally — Not started
4. Homepage design — Not started
5. Homepage development — Not started
6. Shop page design — Not started
7. Shop page development — Not started
8. Contact page design & setup — Not started
9. Other essential page setup — Not started
10. Inner pages — Not started
11. Mobile responsiveness — Not started
12. Client review — Not started
13. Testing and launch — Not started
14. Final handover — Not started

CURRENT LIMITATIONS
-------------------
This is a simple first version. It does not yet include uploads, comments,
payment gateway integration, invoice generation, automated email notifications,
or individual accounts for multiple clients. The client page is protected by
one shared project password. Anyone who knows that password can view this
project, so do not put confidential content there. For stronger access control,
use per-client accounts and project-level authorization.

For production use, keep PHP and the server patched, use HTTPS, use a strong
database password, and maintain backups.
