v2.1.2 - Verified cleanup architecture checkpoint

Summary

This release captures the verified cleanup and architecture pass merged through PR #10.

Highlights

• Consolidated demo auth, app routes, report export helpers, and release status documentation.
• Removed stale release docs, generated Playwright artifacts, unused assets, dead components, orphan hooks/helpers, and unused dependencies.
• Optimized PWA/fav icon assets.
• Fixed admin audit-log filters, report export filtering, backup export, faculty dark mode, uploaded-file category/removal persistence, and profile dialog accessibility/close behavior.
• Expanded unit and Playwright coverage for reusable helpers, admin actions, faculty settings, profile edits, uploaded-file persistence, and Pages-style preview behavior.

Verification

• Local verified before merge: lint, unit tests, security scan, SEO/link checks, audit, build, local Playwright, and Pages-style Playwright.
• Main CI after merge: passed.
• GitHub Pages deploy after merge: passed.
• Live post-deploy smoke: 8/8 Playwright tests passed against https://iron-mark.github.io/Hackathon-Smart-Profile-Management-System/.

Merge

• PR: #10
• Merge commit: bde3762

v2.1.1 - Public demo QA checkpoint

Summary

• Captures the verified GitHub Pages public demo checkpoint for faculty credential upload, admin review, browser-local data, sample files, and local Web Vitals reporting.
• Marks the final deployed main commit after PR #5, PR #6, and PR #7.
• Documents the static-demo safety posture: generated sample files only, no real faculty records, no required backend or OpenAI secrets.

Verification

• Tag v2.1.1 dereferences to 09573665db005f4a1114dcaf9606886a7cfbc73f.
• GitHub Pages deploy run 27897209662 completed successfully for 09573665db005f4a1114dcaf9606886a7cfbc73f.
• Live public URL returned 200 OK.
• Full live GitHub Pages Playwright suite passed: 17 passed.

Safety

• Public demo state remains browser-local.
• Reviewers should use generated sample files only.
• Optional Clerk and OpenAI integrations remain local showcase paths.

v2.1 Public Demo Handoff Release

v2.1 Public Demo Handoff Release

This release closes the restoration pass for the Smart Profile Management System hackathon project. The app is now positioned as a GitHub Pages-friendly public showcase that can be cloned, installed, run locally, and demonstrated without a hosted backend.

Highlights

• Restored the faculty-to-admin demo flow with browser-local seeded accounts, document upload metadata, admin approval, faculty status visibility, and demo file previews.
• Converted the unsupported hosted backend path into a browser-local demo backend, so no Supabase, Appwrite, Firebase, or custom server is required.
• Added optional Clerk showcase authentication with sign-in, sign-up, user menu, and Organization switcher controls when VITE_CLERK_PUBLISHABLE_KEY is configured.
• Kept admin access on the seeded demo admin account rather than trusting browser-side Clerk Organization state.
• Updated SEO, AEO, GEO, social preview, robots, sitemap, llms.txt, and public demo copy for the canonical GitHub Pages URL.
• Reworked the demo information panel into a responsive bottom-right snackbar with dismiss, reset, and seeded-account actions.
• Added focused tests and Playwright coverage for the restored demo flow, responsive auth screens, SEO smoke checks, route noindex behavior, duplicate registration messaging, and demo reset behavior.

Public Demo

• URL: https://iron-mark.github.io/Hackathon-Smart-Profile-Management-System/
• Runtime model: browser-local demo storage
• Supported setup: npm ci, then npm run dev or the documented GitHub Pages build/preview commands
• Optional Clerk setup: add VITE_CLERK_PUBLISHABLE_KEY only if you want the hosted Clerk UI layer

Safety Notes

• Uploaded demo files and generated previews stay in the visitor's browser-local state.
• No backend secrets are required for the public showcase.
• The app does not claim production authentication, production document storage, or durable multi-user institutional records.
• Optional OpenAI and Clerk keys are public/demo configuration paths only; the app continues to work without them.

Verification Gate

The v2.1 release should be considered valid only when these checks pass on the release commit:

• npm ci
• npm test -- --run
• npm run lint
• npm run security:scan
• npm run seo:check
• npm run links:check
• GitHub Pages-style npm run build
• GitHub Pages-style npx playwright test --reporter=line

Handoff Notes

• Continue from the v2.1 tag or the latest main commit.
• Do not add a real backend unless the project goal changes from showcase to production.
• If continuing on another PC, clone the repo, run npm ci, copy .env.example to .env.local if needed, and keep VITE_DEMO_MODE=true.

v2.0.0: The Modernization Update 🚀

The Modernization Update 🚀 (v2.0.0)

We have officially revived the year-old Smart Profile Management System hackathon project and meticulously engineered it into a production-grade, enterprise-ready SaaS application. This massive release replaces the legacy foundation with cutting-edge web technologies, an intelligent AI layer, and an industry-leading user experience.

🌟 The "Wow" Factor: What's New?

1. The Glassmorphic UI/UX Overhaul

The entire platform has been visually rebuilt from the ground up by Lead Frontend Developer Mark Siazon. The application now features a stunning, fluid Glassmorphic interface powered by Tailwind CSS and Radix UI primitives.

• Global Dark/Light Mode: Seamlessly toggles deeply integrated theme tokens for maximum accessibility and visual flair.
• Responsive Architecture: Fully optimized for both desktop administrator analytics and mobile faculty uploads.

2. Intelligent Progressive Web App (PWA)

We completely transformed the standard React Single Page Application into a true Progressive Web App (PWA).

• Offline Mode Mastery: Built-in network listeners instantly detect Wi-Fi drops, triggering elegant sonner persistent toast notifications ("Offline Mode - Operating from Cache") to ensure the presentation never breaks, even under extreme network latency.
• Installable: Beautiful custom 192x192 and 512x512 manifest icons allow users to install the platform natively on their devices.

3. Masterclass Discoverability & SEO

The application is no longer just a locked dashboard; it is a highly discoverable entity optimized for both Google and the next generation of Search.

• Open Graph (OG) Dominance: Dynamic Twitter Cards and Theme Colors ensure any shared links unfurl into beautiful graphic previews.
• AI Search Engine Integration: We architected an industry-leading llms.txt file and explicitly invited GPTBot, ClaudeBot, and PerplexityBot via robots.txt to perfectly index the specific architectural achievements of the engineering team.
• Strict Canonical Directives: W3C-compliant sitemap.xml mapping with duplicate-content protections tied directly to personal portfolios.

4. AI-Powered Autonomous Ecosystem

The core workflow is now a fully automated, hands-off pipeline.

• OCR Text Extraction: Raw faculty uploads are instantly parsed via Tesseract.js.
• GPT-4 Classification: Extracted text is fed to a custom OpenAI pipeline that autonomously classifies and categorizes the document type.
• Generative Biographies: With a single click, the platform evaluates a faculty member's Approved credentials and ghostwrites a stellar, professional biography using Generative AI.

5. Iron-Clad Security & RBAC

• Strict Route Segregation: Administrators and Faculty operate in entirely different architectural spaces, protected by our custom <ProtectedRoute /> routing wrapper that validates Supabase Auth sessions in real-time.
• Automated E2E Verification: The entire security model is permanently guarded by a 100% green headless Playwright End-to-End testing suite to ensure no RBAC regression ever reaches production.

6. Real-Time Admin Tooling

Administrators have access to a lightning-fast data layer.

• Live Global Search: The "Recent Submissions" dashboard now features a real-time, zero-latency search index for instantly filtering faculty files.
• Native CSV Exporting: Replaced buggy external libraries with a custom-engineered vanilla JS module for instantly downloading pristine CSV analytics reports.

---

👥 Meet the Team (Team 2nd Choice)

This platform represents a collaborative triumph by an elite engineering trio:

• Mark Siazon – Lead Frontend Developer & UI/UX
• Charles Nathaniel Togle – Backend & Integration
• Alexa San Jose – Systems & Architecture

Built with ❤️ for the UMak CCIS Hackathon

v1.0.0-legacy: Original Hackathon Base

Legacy Vault: The Original Hackathon Base 🏛️

This release archives the Original Version (from a year ago) of the Smart Profile Management System, prior to the massive modern infrastructure overhaul.

It serves as a historical checkpoint to preserve the raw, foundational source code before the introduction of Progressive Web App (PWA) architecture, AI-driven Knowledge Graphs, and Advanced Security integrations.

What Was Included in the Legacy Base

• Foundational React Architecture: The original Vite + React scaffolding.
• Basic Routing: Initial setup of react-router-dom before strict Protected Routes were enforced.
• Initial Component Library: The first iteration of the UI using standard Tailwind CSS classes.
• Raw Document Layouts: Unoptimized file structures prior to the ESLint and strict TypeScript cleanup.

Why We Tagged This

As we prepare to push the monumental Next-Gen Overhaul (featuring fully integrated Open Graph SEO, Dynamic React Helmet routing, PWA offline caching, and native CSV exporting), we wanted to permanently preserve the legacy roots of this application.

Note: This version is archived for historical reference. The main branch will now diverge significantly as we deploy the enterprise-grade enhancements.