# Assignment 4 Rubric Evidence

This file maps the Assignment 4 requirements to the project evidence.

## 1. Repository Setup

Evidence:

- clear root files: `README.md`, `index.html`, `.gitignore`
- organized folders: `css/`, `js/`, `assets/images/`, `docs/`, `presentation/`
- README includes project overview, setup, testing, documentation, and deployment notes

Important final submission note:

- the public GitHub repository should be named `202277460-moayd-shahat-assignment4`

## 2. Complete Application

Evidence:

- `index.html` contains a complete portfolio with hero, about, capabilities, projects, GitHub API, process, contact, and evidence sections
- `css/styles.css` provides responsive desktop, tablet, and mobile layouts
- `js/script.js` provides interactive behavior and dynamic rendering

Implemented features:

- persistent theme
- persistent visitor name
- persistent availability status
- session timer
- project search, category filter, complexity filter, and sorting
- live project statistics
- GitHub API fetch with fallback
- validated contact form

## 3. Professional Quality

Evidence:

- consistent visual system with color tokens and reusable card styles
- sticky navigation and skip link
- responsive grids and mobile stacking
- optimized hero image: `assets/images/portfolio-workspace.jpg`
- accessible labels, focus states, live regions, and validation states
- no external framework dependency

## 4. Innovation

Evidence:

- personalized greeting stored in the browser
- live session timer
- filtered project analytics
- API fallback instead of a broken empty section
- generated visual hero asset created specifically for the portfolio
- explicit evidence section to help reviewers navigate the final submission

## 5. Presentation

Evidence:

- presentation outline: `presentation/README.md`
- detailed demo script: `presentation/demo-script.md`
- browser-based slide deck: `presentation/slides.html`

The final recorded video should be 5-7 minutes and should follow the presentation plan.

## 6. AI Integration

Evidence:

- AI report: `docs/ai-usage-report.md`
- AI usage is described by tool, use case, benefits, limitations, learning outcomes, and responsible modifications
- generated image details are documented

## 7. Code Quality

Evidence:

- `js/script.js` separates state, rendering, filtering, API loading, validation, and event binding
- `css/styles.css` uses reusable variables and responsive media queries
- `index.html` uses semantic page structure
- JavaScript syntax was checked with `node --check js/script.js`

## 8. Documentation

Evidence:

- README: `README.md`
- technical documentation: `docs/technical-documentation.md`
- AI usage report: `docs/ai-usage-report.md`
- user guide: `docs/user-guide.md`
- rubric evidence: `docs/rubric-evidence.md`
- submission checklist: `docs/submission-checklist.md`

## 9. Academic Integrity

Evidence:

- `docs/ai-usage-report.md` explains how AI assistance was used, reviewed, modified, and validated
- the project does not claim unmodified AI output as original work

## 10. Final Items Before Blackboard Submission

These items cannot be fully completed by code alone:

- create or rename the GitHub repository to `202277460-moayd-shahat-assignment4`
- deploy the site and add the live deployment link to the README
- record and submit the 5-7 minute presentation video
- submit the repository link through Blackboard