Files
svsmspcalc/pre-alpha/docs/README.md
2026-03-16 01:42:17 -04:00

63 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# SVS MSP Calculator
Static sales-facing quote builder for SVS Managed Services.
Plain HTML/CSS/JS — no frameworks, no build tools, no npm.
**Status:** Beta complete (Stages 19). 254/254 tests passing.
## Quick Start
1. Open `SVS-MSP-Calculator.html` in a browser (works on `file://`)
2. Edit pricing in `package-prices-data.js`
3. Run tests: `node svsmspcalc/tests/test-quote-engine.js`
## What It Does
- Configures managed service packages (Users, Endpoints, Servers, ZT, VoIP)
- Contract terms with auto-calculated onboarding and discounts
- Live quote sidebar with MRR breakdown, VS Hiring comparison
- 4 themes: Dark, Light, Glass, Retro Cyberpunk
- Print/PDF export, JSON export/import, localStorage persistence
- Mobile-responsive with full-screen quote panel
## File Map
### Runtime JS
| File | Purpose |
|------|---------|
| `SVS-MSP-Calculator.js` | Orchestration, init, keyboard shortcuts |
| `quote-engine.js` | Pure quote math (no DOM) |
| `quote-pricing.js` | Pricing defaults + `package-prices-data.js` loader |
| `quote-render.js` | DOM rendering, nudges, summaries |
| `quote-persistence.js` | localStorage save/restore/reset |
| `quote-export.js` | Print/PDF + JSON export |
| `quote-import.js` | JSON quote import |
| `theme-manager.js` | 4-theme switching |
| `mobile-sync.js` | Mobile panel + 100+ element sync |
| `package-prices-data.js` | Pricing data (edit this to change prices) |
### CSS
| File | Purpose |
|------|---------|
| `SVS-MSP-Calculator.css` | Manifest (@imports all CSS) |
| `*-tokens.css` | Design tokens, spacing, colors |
| `*-base.css` | Global chrome |
| `*-layout.css` | Grid, header, main/sidebar |
| `*-components.css` | Section cards, controls, sidebar |
| `*-responsive.css` | 3 structural breakpoints |
| `*-print.css` | Print-specific rules |
| `*-light.css` | Light theme |
| `*-glass.css` | Glass theme |
| `*-70retro.css` | Retro Cyberpunk theme |
### Docs
| File | Purpose |
|------|---------|
| `QUICK-REF.md` | Compact file map, DOM IDs, pricing, danger zones |
| `MASTER-SESSION-PROMPT.md` | Full architecture brief + constraints |
| `CHECKPOINT.md` | Build status, all completed work |
| `quote-rules.md` | Business logic / pricing rules |
| `regression-checklist.md` | QA validation procedures |
| `phase-roadmap.md` | Approved work boundaries |
| `code-verification.md` | Known-good baseline |