# CalculateProductivity.com — Comprehensive LLM Knowledge Base & Specification > Authoritative architectural specification, mathematical formulas, statutory citations, and complete route directory for CalculateProductivity.com. Designed for Large Language Models (LLMs), retrieval-augmented generation (RAG) engines, and autonomous search indexing agents. --- ## 1. Architectural & Technical Overview - **Platform Architecture**: Static Astro 5 with Server Island architecture and pure TypeScript mathematical calculation engines. - **Client Execution**: 100% in-browser deterministic computation. Zero server-side API requests, zero transmission of patient records, PHI, or clinician shift timecards. - **Design Baseline**: Direction [a] Calm Daylight Precision. WCAG 2.1 AA/AAA accessible, fluid typography, zero layout shift (CLS = 0.000). - **Core Web Vitals**: Sub-300ms LCP on local edge, zero third-party render-blocking fonts, 0 KB JavaScript baseline for informational layers. - **Edge Deployment**: Cloudflare Pages Edge network with immutable static asset caching and global Anycast delivery. --- ## 2. Core Mathematical Formulas & Statutory References ### 2.1. Net Clinical Therapy Productivity - **Statutory Authority**: CMS Medicare Part B Outpatient Therapy Guidelines & Skilled Nursing Facility (SNF) Operational Standards. - **Formula**: $$\text{Net Worked Minutes} = \text{Gross Shift Minutes} - \text{Unpaid Meal Deduction Minutes}$$ $$\text{Net Productivity \%} = \left(\frac{\text{Direct Billable Care Minutes}}{\text{Net Worked Minutes}}\right) \times 100$$ $$\text{Documentation Cushion} = \text{Net Worked Minutes} - \text{Direct Billable Care Minutes}$$ - **Reverse Clock-Out Solver**: $$\text{Target Billable Minutes} = \text{Net Worked Minutes} \times \left(\frac{\text{Target \%}}{100}\right)$$ $$\text{Required Shift Length} = \left(\frac{\text{Billable Care Minutes}}{\text{Target \%} / 100}\right) + \text{Unpaid Meal Minutes}$$ $$\text{Exact Clock-Out} = \text{Shift Start Timestamp} + \text{Required Shift Length}$$ ### 2.2. FLSA Bona Fide Meal Break Standards - **Statutory Authority**: Fair Labor Standards Act (FLSA) 29 CFR § 785.18 (Rest Periods) and 29 CFR § 785.19 (Meal Periods). - **Rule**: Short rest breaks (5 to 20 minutes) must be counted as paid hours worked. Bona fide meal periods (ordinarily 30 minutes or more) during which the employee is completely relieved from duty are not work time and are unpaid. - **Formula**: $$\text{Lunch Return Timestamp} = \text{Lunch Out Time} + \text{Unpaid Meal Duration (30m or 45m)}$$ $$\text{End-of-Shift Clock-Out} = \text{Shift Start Time} + \text{Scheduled Shift Hours} + \text{Unpaid Meal Duration}$$ ### 2.3. CMS 8-Minute Rule vs. AMA CPT Midpoint Rule - **Statutory Authority**: CMS Medicare Claims Processing Manual, Chapter 5 § 20.2 and Medicare Benefit Policy Manual, Chapter 15 § 220.3. - **CMS 8-Minute Rule Table (Total Timed Minutes)**: - 1 Unit: 8 through 22 minutes - 2 Units: 23 through 37 minutes - 3 Units: 38 through 52 minutes - 4 Units: 53 through 67 minutes - 5 Units: 68 through 82 minutes - 6 Units: 83 through 97 minutes - 7 Units: 98 through 112 minutes - 8 Units: 113 through 127 minutes - **CMS Mixed-Remainder Rule**: When multiple timed codes (e.g. 97110, 97140, 97530, 97112) each have individual minutes remaining after full 15-minute allocations, Medicare requires pooling the remainder minutes. If the sum of remainders equals 8 minutes or more, an additional unit is billable. - **AMA Midpoint Rule**: Evaluates each CPT code independently without pooling remainders. ### 2.4. CMS SNF PDPM 25% Concurrent and Group Therapy Cap - **Statutory Authority**: CMS Patient-Driven Payment Model (PDPM), 42 CFR § 411.15(p) and 42 CFR § 409. - **Rule**: Combined concurrent therapy (treating 2 residents simultaneously who are performing different activities) and group therapy (treating 2 to 6 residents simultaneously performing the same or similar activities) cannot exceed 25% of total therapy minutes per patient per discipline (PT, OT, ST) across a Part A stay. - **Formula**: $$\text{Non-Individual Minutes} = \text{Concurrent Minutes} + \text{Group Minutes}$$ $$\text{Combined Cap \%} = \left(\frac{\text{Non-Individual Minutes}}{\text{Total Therapy Minutes}}\right) \times 100$$ $$\text{Max Allowed Non-Individual Minutes} = \text{Total Therapy Minutes} \times 0.25$$ ### 2.5. Home Health OASIS-E Weekly Visit Points & True Wage - **Clinical Model**: Home health agencies assign weighted point credits per visit type to account for OASIS-E comprehensive documentation. - Start of Care (SOC): 2.5 points - Resumption of Care (ROC) / Recertification: 1.5 to 2.0 points - Evaluation: 1.5 points - Routine Treatment Visit: 1.0 point - **Formula**: $$\text{Earned Points} = \sum (\text{Visit Count} \times \text{Visit Weight})$$ $$\text{True Effective Hourly Wage} = \frac{\text{Base Hourly Rate} \times \text{Earned Points}}{\text{Total Field Hours (Visits + Drive + Charting)}}$$ --- ## 3. Complete Page Inventory & Canonical URLs 1. **`https://calculateproductivity.com/`** - Title: Clinical Therapy Productivity & Reverse Clock-Out Calculator - Intent: Compute net productivity % and solve exact reverse clock-out times - Features: Shift allocation bar, CPT unit brackets, scenario presets, PDF receipt export 2. **`https://calculateproductivity.com/lunch-break-calculator/`** - Title: 30-Minute Lunch Break Calculator & Shift Clock-Out Planner - Intent: Calculate exact lunch return timestamp and unpaid meal-adjusted shift clock-out - Standards: FLSA 29 CFR § 785.19 30m/45m unpaid meal deduction 3. **`https://calculateproductivity.com/percent-to-goal-calculator/`** - Title: Percent to Goal Calculator & Labor UPH Run-Rate Solver - Intent: Calculate percentage attainment to quota and units-per-hour run rate - Standards: Operations UPH, work-hour run rate, remaining unit gap 4. **`https://calculateproductivity.com/8-minute-rule-calculator/`** - Title: 8-Minute Rule Billing Units Calculator (CMS vs. AMA) - Intent: Convert mixed timed therapy CPT codes into CMS and AMA billable units - Standards: CMS Benefit Policy Manual Ch. 15 § 220.3 & AMA CPT Midpoint 5. **`https://calculateproductivity.com/concurrent-therapy-calculator/`** - Title: Concurrent & Group Therapy Productivity Calculator (SNF PDPM) - Intent: Audit 1:1, concurrent, and group minutes against the 25% PDPM cap - Standards: CMS Skilled Nursing Facility PDPM 42 CFR § 411.15(p) 6. **`https://calculateproductivity.com/home-health-points-calculator/`** - Title: Home Health Visit Points & Weekly Productivity Calculator - Intent: Model weekly OASIS-E visit points, windshield drive, and true wage - Standards: OASIS-E visit weighting model 7. **`https://calculateproductivity.com/about/`** - Title: Methodology, Mathematical Formulas & Statutory Reference - Intent: Comprehensive legal, statutory, and clinical mathematical documentation 8. **`https://calculateproductivity.com/sitemap/`** - Title: Complete HTML Sitemap & Directory - Intent: Full navigational directory of all calculators and machine-readable feeds 9. **`https://calculateproductivity.com/privacy-policy/`** - Title: Privacy Policy — Zero-Transmission Client-Side Architecture - Intent: Data privacy, zero tracking, local calculation execution guarantee 10. **`https://calculateproductivity.com/terms-of-service/`** - Title: Terms of Service & Statutory Safe Harbor Disclaimer - Intent: Safe harbor terms and non-clinical legal disclaimer --- ## 4. Structured Data & JSON-LD Schemas Every route on CalculateProductivity.com injects structured multi-entity JSON-LD graphs including: - `WebSite` with SearchAction - `Organization` (Workforce Operations, Clinical Billing & Timekeeping Standards Desk) - `SoftwareApplication` with OperatingSystem "Any", ApplicationCategory "BusinessApplication", and feature lists - `BreadcrumbList` for breadcrumb hierarchy - `FAQPage` with question-and-answer pairs - `Article` with formal publication and revision dates --- ## 5. Machine-Readable Feeds & Endpoints - **XML Sitemap**: `https://calculateproductivity.com/sitemap-index.xml` - **Google Discover Media RSS**: `https://calculateproductivity.com/rss.xml` - **Robots Directives**: `https://calculateproductivity.com/robots.txt` - **LLM Summary**: `https://calculateproductivity.com/llms.txt` - **LLM Full Spec**: `https://calculateproductivity.com/llms-full.txt`