# McDonald's IT Halloween Event Page 🎃

**Project Created**: 2025-10-04 08:50:35 UTC / 2025-10-04 16:50:35 GMT+8

A minimalist, geek-style Halloween event webpage for McDonald's IT department, inspired by Homebrew's terminal aesthetic.

## Project Description

This single-page website announces the McDonald's China IT Halloween 2025 event for 300 MITA programmers. It features:

- **Terminal Aesthetic**: Pure black background (#000000) with terminal green (#00FF00) text
- **ASCII Art**: McDonald's logo with Golden Arches in ASCII characters
- **Live Countdown**: Real-time countdown to Oct 31 2025 18:00 GMT+8
- **Bilingual Content**: English and Chinese (alternating lines)
- **Responsive Design**: Adaptive ASCII art for desktop and mobile
- **Zero Dependencies**: Single self-contained HTML file (8.4KB)
- **Accessibility**: WCAG 2.1 AA compliant (21:1 contrast ratio)

## Design Philosophy

**Extreme Minimalism + Geek Aesthetic**
- No shadows, gradients, or decorative effects
- Monospace fonts only
- Command-line/terminal interface look
- Homebrew-inspired design language

## Event Details

- **Date**: October 31, 2025 (Halloween)
- **Time**: 18:00 - 21:00 GMT+8 (6:00 PM - 9:00 PM)
- **Location**: MITA Building 2F Pantry
- **Organizer**: Jessi Pan (jessi.pan@cn.mcd.com)
- **Activities**: Cosplay (encouraged!), Bug Debugging Games, Lucky Draw
- **Audience**: 300 McDonald's China IT team members (MITA)

## Quick Start

### View Locally
```bash
# Clone the repository
git clone ssh://gitea@git.shihong.me:2222/snowprint/halloween-test.git
cd halloween-test

# Open in browser
open index.html          # macOS
xdg-open index.html      # Linux
start index.html         # Windows
```

### Deploy to Web
Simply upload `index.html` to any hosting:
```bash
# GitHub Pages
git checkout gh-pages
git merge main
git push origin gh-pages

# Or use Netlify drag-and-drop
# Or AWS S3, Vercel, etc.
```

## File Structure

```
test-project/
├── .claude/                    # AI agent configurations
│   ├── agents/                 # Specialized AI agents
│   └── constitution.md         # Agent system principles
├── specs/                      # Spec-Kit documentation
│   └── 001-mcdonald-s-it/     # Feature specifications
│       ├── spec.md            # Requirements (35 functional requirements)
│       ├── plan.md            # Implementation plan
│       ├── tasks.md           # Task breakdown (32 tasks)
│       ├── research.md        # Technical decisions
│       ├── data-model.md      # Entity definitions
│       ├── quickstart.md      # Testing checklist
│       └── contracts/         # JSON Schema validation
├── CLAUDE.md                   # Project guidance for Claude AI
├── README.md                   # This file
└── index.html                  # ✅ Main event page (COMPLETE)
```

## Technical Specifications

- **HTML5**: Semantic markup with `<header>`, `<main>`, `<section>`, `<footer>`
- **CSS**: Inline styles (organized sections: base, typography, layout, responsive)
- **JavaScript**: Vanilla JS for countdown timer only (41 lines)
- **Colors**:
  - Background: `#000000` (pure black)
  - Primary text: `#00FF00` (terminal green, 21:1 contrast)
  - Accent: `#FFBF00` (amber, 12:1 contrast)
- **Fonts**: `"Courier New", Monaco, Consolas, Menlo, monospace`
- **File Size**: 8.4KB (well under 50KB requirement)
- **Performance**: Loads in < 1 second, 60fps animations
- **Encoding**: UTF-8
- **Target Browsers**: Chrome, Firefox, Safari, Edge (latest 2 versions)

## Responsive Breakpoints

- **Desktop**: 1024px and above
- **Tablet**: 768px - 1023px
- **Mobile**: 320px - 767px

## Development

### Prerequisites
- Any modern web browser
- Text editor (VS Code, Sublime, etc.)
- Git for version control

### Repository
- **Remote**: `ssh://gitea@git.shihong.me:2222/snowprint/halloween-test.git`
- **Workflow**: Feature branches with pull requests
- See `CONTRIBUTING.md` for detailed Git workflow

### Testing
- Test on multiple screen sizes
- Verify ASCII art legibility on mobile
- Check color contrast ratios
- Validate HTML5 compliance

## Deployment

Simply upload `index.html` to any web hosting service:
- GitHub Pages
- Netlify
- Vercel
- AWS S3
- Traditional web hosting

## Browser Support

- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

## License

Internal use for McDonald's IT department.

## Version Control

This project uses Git for version control. All team members must:
- Follow the branching strategy in `CONTRIBUTING.md`
- Write clear, conventional commit messages
- Never commit sensitive data
- Request code review before merging to main

## Contributing

See `CONTRIBUTING.md` for detailed guidelines on:
- Git workflow and branching strategy
- Commit message conventions
- Code review process
- DevOps responsibilities

## Contact

For questions or updates, contact the McDonald's IT team.