# Sportz Docs

- [Sportz Engineering Handbook](https://sportzdocs.mintlify.app/index.md): Architecture, decisions, and operations for the Sportz real-time match platform.
- [Project Status & Scope](https://sportzdocs.mintlify.app/project-status.md): An honest boundary between what Sportz has, what's wired but inactive, and what doesn't exist yet.
- [User Stories](https://sportzdocs.mintlify.app/stories.md): Real people using Sportz, what they experience moment to moment, and why it behaves that way because of what we built.
- [System Architecture (C4)](https://sportzdocs.mintlify.app/architecture/system.md): The Sportz system at four levels of zoom: context, containers, components, and code.
- [Frontend Architecture](https://sportzdocs.mintlify.app/architecture/frontend.md): The Next.js client: data layer, components, state strategy, and the design system.
- [Backend Architecture](https://sportzdocs.mintlify.app/architecture/backend.md): The Express + WebSocket API: structure, responsibilities, boundaries, and failure modes.
- [Real-Time System Deep Dive](https://sportzdocs.mintlify.app/architecture/realtime.md): How a live event travels from API call to a pixel changing on screen.
- [Architectural Decision Records](https://sportzdocs.mintlify.app/decisions.md): Every major technical choice in Sportz, with the alternatives weighed and tradeoffs accepted.
- [Engineering Log: Issues & Post-Mortems](https://sportzdocs.mintlify.app/issues.md): Every real bug encountered building Sportz, with root cause, investigation, and prevention.
- [Testing Strategy](https://sportzdocs.mintlify.app/operations/testing.md): What we test, how, and why: 95 Vitest tests across the backend plus a Playwright end-to-end suite on the frontend.
- [DevOps & CI/CD](https://sportzdocs.mintlify.app/operations/devops.md): How code moves from a laptop to production: Docker, GitHub Actions, and Render.
- [Observability](https://sportzdocs.mintlify.app/operations/observability.md): What's instrumented, end to end, and what's not built yet.
- [Security](https://sportzdocs.mintlify.app/operations/security.md): The threats Sportz defends against today, the mitigations in place, and the honest gaps.
- [API Reference](https://sportzdocs.mintlify.app/reference/api.md): REST endpoints and the WebSocket protocol.
- [Learning Curriculum](https://sportzdocs.mintlify.app/learning/curriculum.md): Each core technology in Sportz, explained at four levels, beginner to staff.
- [Best Practices](https://sportzdocs.mintlify.app/learning/best-practices.md): The engineering practices Sportz actually follows, frontend and backend, each tied to real code and the reason behind it.
- [Knowledge Checks](https://sportzdocs.mintlify.app/learning/quizzes.md): Quizzes by difficulty: test your understanding of the Sportz system.
- [Senior Engineer Interview Prep](https://sportzdocs.mintlify.app/interview/senior.md): Comprehensive Q&A across every domain in Sportz: frontend, backend, real-time, data, DevOps, security, observability, scaling, and architecture.
- [Staff Engineer Interview Prep](https://sportzdocs.mintlify.app/interview/staff.md): Large-scale design, tradeoffs, incident response, evolution, and leadership, grounded in Sportz.

## Optional

- [Live Demo](https://sportz-ui.vercel.app)
- [Backend Repo](https://github.com/Jheff4/sportz-websockets)
- [Frontend Repo](https://github.com/Jheff4/sportz-ui)