# ShiftOps Documentation

**Last Updated:** 2026-01-09

Complete documentation for ShiftOps – Betriebsanalyse für Schichtbetriebe, a comprehensive business analysis tool for shift-based businesses.

## Documentation Structure

This documentation is organized into focused modules for easy navigation and maintenance:

1. **[Overview](01-overview.md)** - Tool purpose, use cases, target audience, visual descriptions
2. **[User Flow](02-user-flow.md)** - Complete user journey with chat-style interface, loading sequences, and report display
3. **[Technical Implementation](03-technical-implementation.md)** - File structure, JavaScript modules, API endpoints, data flow
4. **[Scoring System](04-scoring-system.md)** - 5 pillar calculations, formulas, examples, customer boost logic
5. **[API Endpoints](05-api-endpoints.md)** - All 11 API endpoints with request/response formats and error handling
6. **[Content Strategy](06-content-strategy.md)** - Hero copy, FAQs, meta tags, schema markup, SEO optimization
7. **[Testing & Maintenance](07-testing-maintenance.md)** - Testing procedures, maintenance checklist, update requirements
8. **[Quick Reference](QUICK_REFERENCE.md)** - Quick lookup for common tasks and key information

## Quick Links

### For Users

- [User Flow Documentation](02-user-flow.md) - How to use ShiftOps
- [Content Strategy](06-content-strategy.md) - FAQs and help content

### For Developers

- [Technical Implementation](03-technical-implementation.md) - Code structure and architecture
- [API Endpoints](05-api-endpoints.md) - API reference and integration
- [Scoring System](04-scoring-system.md) - Calculation formulas and logic

### For Content Managers

- [Content Strategy](06-content-strategy.md) - Copy, meta tags, schema
- [Testing & Maintenance](07-testing-maintenance.md) - Update procedures

## Related Documentation

### System Documentation

- [ShiftOps Architecture](../../../systems/shiftops/SHIFTOPS_ARCHITECTURE.md) - System architecture overview
- [ShiftOps API Documentation](../../../systems/shiftops/SHIFTOPS_API_DOCUMENTATION.md) - Complete API reference
- [ShiftOps Scoring System](../../../systems/shiftops/SHIFTOPS_SCORING_SYSTEM.md) - Detailed scoring documentation
- [ShiftOps Developer Guide](../../../systems/shiftops/SHIFTOPS_DEVELOPER_GUIDE.md) - Developer setup and workflow

### Tool Documentation

- [Tools Inventory](../TOOLS_INVENTORY.md) - Complete tools inventory
- [Tool Documentation Template](../TOOL_DOCUMENTATION_TEMPLATE.md) - Template for other tools

## Key Features

- **Two-Phase Loading:** Essential mode (< 2s) + Enhanced mode (3-5s background)
- **Chat-Style Interface:** Progressive analysis display with rotating messages
- **5 Pillar Scoring:** Scheduling, Absence, Time Tracking, Compliance, Payroll
- **Cost Savings Analysis:** Team size estimation, ROI calculations, break-even analysis
- **Competitive Analysis:** Market positioning, competitor density, growth potential
- **Email Gating:** Lead capture with HubSpot integration
- **PDF Export:** Complete report export functionality
- **NPS Survey:** Post-unlock feedback collection

## Status

- **Tool Status:** Available (Beta)
- **Documentation Status:** Complete (Modular structure)
- **Last Updated:** 2026-01-09

## Support

For questions or issues:

- See [Testing & Maintenance](07-testing-maintenance.md) for troubleshooting
- See [Technical Implementation](03-technical-implementation.md) for technical details
- See [System Documentation](../../../systems/shiftops/SHIFTOPS_TROUBLESHOOTING.md) for advanced troubleshooting