# MTU-DSpace - Implementation Plan (Laravel 12)

This document outlines the step-by-step roadmap for building **MTU-DSpace**, a modern, lightweight digital repository for **Mountain Top University**.

---

## Phase 1: Foundation & Custom Authentication
- [x] **1.1 Base Setup:** Configure `.env` with SQLite and App details.
- [x] **1.2 Custom Identity:** Implemented 100% custom Auth (Standard Login + Google OAuth) with roles: `user`, `staff`, `admin`.
- [x] **1.3 UI Brand:** Established **MTU-DSpace** branding with a premium **Light Theme** (Glassmorphism, Micro-animations).
- [x] **1.4 Storage Config:** Configure `config/filesystems.php` for `repository` disk (Bitstream management).

## Phase 2: Core Data Engine (COMPLETED)
- [x] **2.1 Migrations:** Core structure for Communities, Collections, Items, and Metadata values created.
- [x] **2.2 Models:** Implemented `Community`, `Collection`, `Item`, `Bitstream`, and `MetadataValue` models with full relationships.
- [x] **2.3 UUID Support:** Items automatically generate UUIDs for secure, persistent URLs.
- [x] **2.4 Slugs:** Automatic slug generation for Communities and Collections.

## Phase 3: Administrative Dashboard (Management) (COMPLETED)
- [x] **3.1 User Management:** Custom UI for Admins to provision and manage accounts.
- [x] **3.2 Community Management:** CRUD for Communities (Name, Description, Sub-community nesting).
- [x] **3.3 Collection Management:** CRUD for Collections linked to Communities.
- [x] **3.4 Metadata Registry:** Create a UI to manage available Dublin Core fields.

## Phase 4: Submission Workflow (Digital Objects) (COMPLETED)
- [x] **4.1 Submission Wizard:** A multi-step form for depositors:
    - Step 1: Select Collection.
    - Step 2: Metadata Entry (Title, Author, Abstract).
    - Step 3: File Upload (Bitstreams).
- [x] **4.2 Chunked Uploads:** Handle large PDF/video files.
- [x] **4.3 Automatic Thumbnails:** Generate image previews for uploaded PDF covers.

## Phase 5: Discovery & Public Interface (COMPLETED)
- [x] **5.1 Public Landing Page:** Fully dynamic MTU-themed landing page with community/item feeds.
- [x] **5.2 Browse Pages:** High-performance browsing by Author, Date, or Subject.
- [x] **5.3 Item Detail Page:** Premium display of metadata, file download links, and "How to Cite" section.
- [x] **5.4 Search Engine:** Implement Laravel Scout for faceted filtering.

## Phase 6: Knowledge Base & Advocacy (COMPLETED)
- [x] **6.1 Interactive Q&A Section:** FAQ/About DSpace section explaining repository advantages.
- [x] **6.2 Advantage Showcase:** Highlight Google Scholar indexing, OAI-PMH, and Persistence.

## Phase 7: Compliance & Interoperability (COMPLETED)
- [x] **7.1 OAI-PMH Provider:** Implement endpoint for metadata harvesting.
- [x] **7.2 Handles/Permanent Links:** Ensure item URLs are static using Persistent Identifiers.
- [x] **7.3 Enterprise SEO Architecture:** Google Scholar Highwire Press tags, Dublin Core standards, Schema.org JSON-LD (ScholarlyArticle, EducationalOrganization, WebSite Sitelinks Searchbox, Breadcrumbs), dynamic XML sitemaps (/sitemap.xml), robots.txt crawler directives, crawler protection middleware (X-Robots-Tag: noindex for admin/submissions), and canonical URL sanitizer.

## Phase 8: Polish & Launch (COMPLETED)
- [x] **8.1 Performance & Caching:** Audit DB queries and implement caching.
- [x] **8.2 Responsive Audit:** Ensure 100% accessibility on mobile/tablet.
- [x] **8.3 Security Audit:** Metadata integrity and file access controls.
