Pre-Alpha to Alpha Ready

pre-alpha/docs/README.md

@@ -0,0 +1,62 @@
+# 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 1–9). 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 |