cyclecad 2.1.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/BILLING-IMPLEMENTATION-SUMMARY.md +425 -0
  2. package/BILLING-INDEX.md +293 -0
  3. package/BILLING-INTEGRATION-GUIDE.md +414 -0
  4. package/COLLABORATION-INDEX.md +440 -0
  5. package/COLLABORATION-SYSTEM-SUMMARY.md +548 -0
  6. package/DELIVERABLES.txt +296 -445
  7. package/DOCKER-BUILD-MANIFEST.txt +483 -0
  8. package/DOCKER-FILES-REFERENCE.md +440 -0
  9. package/DOCKER-INFRASTRUCTURE.md +475 -0
  10. package/DOCKER-README.md +435 -0
  11. package/Dockerfile +33 -55
  12. package/ENHANCEMENT_COMPLETION_REPORT.md +383 -0
  13. package/ENHANCEMENT_SUMMARY.txt +308 -0
  14. package/FEATURE_INVENTORY.md +235 -0
  15. package/FUSION360_FEATURES_SUMMARY.md +452 -0
  16. package/FUSION360_PARITY_ENHANCEMENTS.md +461 -0
  17. package/FUSION360_PARITY_SUMMARY.md +520 -0
  18. package/FUSION360_QUICK_REFERENCE.md +351 -0
  19. package/MODULE_API_REFERENCE.md +712 -0
  20. package/MODULE_INVENTORY.txt +264 -0
  21. package/PWA-FILES-CREATED.txt +350 -0
  22. package/QUICK-START-TESTING.md +126 -0
  23. package/STEP-IMPORT-QUICKSTART.md +347 -0
  24. package/STEP-IMPORT-SYSTEM-SUMMARY.md +502 -0
  25. package/app/css/mobile.css +1074 -0
  26. package/app/icons/generate-icons.js +203 -0
  27. package/app/index.html +1342 -5031
  28. package/app/js/app.js +1312 -514
  29. package/app/js/billing-ui.js +990 -0
  30. package/app/js/brep-kernel.js +933 -981
  31. package/app/js/collab-client.js +750 -0
  32. package/app/js/mobile-nav.js +623 -0
  33. package/app/js/mobile-toolbar.js +476 -0
  34. package/app/js/modules/animation-module.js +497 -3
  35. package/app/js/modules/billing-module.js +724 -0
  36. package/app/js/modules/cam-module.js +507 -2
  37. package/app/js/modules/collaboration-module.js +513 -0
  38. package/app/js/modules/constraint-module.js +1266 -0
  39. package/app/js/modules/data-module.js +544 -1146
  40. package/app/js/modules/formats-module.js +438 -738
  41. package/app/js/modules/inspection-module.js +393 -0
  42. package/app/js/modules/mesh-module-enhanced.js +880 -0
  43. package/app/js/modules/plugin-module.js +597 -0
  44. package/app/js/modules/rendering-module.js +460 -0
  45. package/app/js/modules/scripting-module.js +593 -475
  46. package/app/js/modules/sketch-module.js +998 -2
  47. package/app/js/modules/step-module-enhanced.js +938 -0
  48. package/app/js/modules/surface-module.js +312 -0
  49. package/app/js/modules/version-module.js +420 -0
  50. package/app/js/offline-manager.js +705 -0
  51. package/app/js/responsive-init.js +360 -0
  52. package/app/js/touch-handler.js +429 -0
  53. package/app/manifest.json +211 -0
  54. package/app/offline.html +508 -0
  55. package/app/sw.js +571 -0
  56. package/app/tests/billing-tests.html +779 -0
  57. package/app/tests/brep-tests.html +980 -0
  58. package/app/tests/collab-tests.html +743 -0
  59. package/app/tests/mobile-tests.html +1299 -0
  60. package/app/tests/pwa-tests.html +1134 -0
  61. package/app/tests/step-tests.html +1042 -0
  62. package/app/tests/test-agent-v3.html +719 -0
  63. package/cycleCAD-Architecture-v2.pptx +0 -0
  64. package/docker-compose.yml +225 -0
  65. package/docs/BILLING-HELP.json +260 -0
  66. package/docs/BILLING-README.md +639 -0
  67. package/docs/BILLING-TUTORIAL.md +736 -0
  68. package/docs/BREP-HELP.json +326 -0
  69. package/docs/BREP-TUTORIAL.md +802 -0
  70. package/docs/COLLABORATION-HELP.json +228 -0
  71. package/docs/COLLABORATION-TUTORIAL.md +818 -0
  72. package/docs/DOCKER-HELP.json +224 -0
  73. package/docs/DOCKER-TUTORIAL.md +974 -0
  74. package/docs/MOBILE-HELP.json +243 -0
  75. package/docs/MOBILE-RESPONSIVE-README.md +378 -0
  76. package/docs/MOBILE-TUTORIAL.md +747 -0
  77. package/docs/PWA-HELP.json +228 -0
  78. package/docs/PWA-README.md +662 -0
  79. package/docs/PWA-TUTORIAL.md +757 -0
  80. package/docs/STEP-HELP.json +481 -0
  81. package/docs/STEP-IMPORT-TUTORIAL.md +824 -0
  82. package/docs/TESTING-GUIDE.md +528 -0
  83. package/docs/TESTING-HELP.json +182 -0
  84. package/fusion-vs-cyclecad.html +1771 -0
  85. package/nginx.conf +237 -0
  86. package/package.json +1 -1
  87. package/server/Dockerfile.converter +51 -0
  88. package/server/Dockerfile.signaling +28 -0
  89. package/server/billing-server.js +487 -0
  90. package/server/converter-enhanced.py +528 -0
  91. package/server/requirements-converter.txt +29 -0
  92. package/server/signaling-server.js +801 -0
  93. package/tests/docker-tests.sh +389 -0
  94. package/~$cycleCAD-Architecture-v2.pptx +0 -0
@@ -0,0 +1,736 @@
1
+ # cycleCAD Billing & Pricing Guide
2
+
3
+ ## Table of Contents
4
+ 1. [Pricing Overview](#pricing-overview)
5
+ 2. [Getting Started](#getting-started)
6
+ 3. [Free Tier](#free-tier)
7
+ 4. [Upgrading to Pro](#upgrading-to-pro)
8
+ 5. [Upgrading to Enterprise](#upgrading-to-enterprise)
9
+ 6. [Managing Your Subscription](#managing-your-subscription)
10
+ 7. [Usage Limits](#usage-limits)
11
+ 8. [Trial Period](#trial-period)
12
+ 9. [Billing & Invoices](#billing--invoices)
13
+ 10. [Payment Methods](#payment-methods)
14
+ 11. [Promo Codes & Discounts](#promo-codes--discounts)
15
+ 12. [Self-Hosting (Enterprise)](#self-hosting-enterprise)
16
+ 13. [FAQ](#faq)
17
+
18
+ ---
19
+
20
+ ## Pricing Overview
21
+
22
+ cycleCAD offers three pricing tiers to fit different needs:
23
+
24
+ ### Free Tier
25
+ - **Price**: €0/month
26
+ - **Perfect for**: Hobbyists, students, and small projects
27
+ - **Features**:
28
+ - Up to 3 projects
29
+ - 100 parts per project
30
+ - 1 GB storage
31
+ - Basic 3D viewer
32
+ - STEP import (up to 30 MB)
33
+ - 20 AI requests per day
34
+ - Community support via Discord
35
+
36
+ ### Pro Tier
37
+ - **Price**: €49/month or €468/year (save 20%)
38
+ - **Perfect for**: Professional designers and engineers
39
+ - **Features**:
40
+ - Unlimited projects
41
+ - Unlimited parts per project
42
+ - 50 GB storage
43
+ - Full feature set
44
+ - STEP import (up to 500 MB)
45
+ - 500 AI requests per day
46
+ - CAM operations
47
+ - Custom materials library
48
+ - API access for integrations
49
+ - Priority email support
50
+ - 14-day free trial
51
+
52
+ ### Enterprise Tier
53
+ - **Price**: €299/month or €2,868/year (save 20%)
54
+ - **Perfect for**: Teams, manufacturers, and organizations
55
+ - **Features**:
56
+ - Everything in Pro
57
+ - Unlimited collaborators
58
+ - 500 GB storage
59
+ - Unlimited STEP import
60
+ - Unlimited AI requests
61
+ - CAM to real-time fab network integration
62
+ - Custom branding
63
+ - Single Sign-On (SSO)
64
+ - Self-hosted option
65
+ - 99.9% SLA
66
+ - Dedicated technical support
67
+ - Training and consulting included
68
+
69
+ ---
70
+
71
+ ## Getting Started
72
+
73
+ ### 1. Create an Account
74
+ 1. Visit [cyclecad.com](https://cyclecad.com)
75
+ 2. Click "Sign Up"
76
+ 3. Enter your email and create a password
77
+ 4. Verify your email address
78
+ 5. You're automatically on the Free tier!
79
+
80
+ ### 2. Start Your Free Trial
81
+ To try Pro features risk-free:
82
+ 1. Open the app and click **"Upgrade"** button
83
+ 2. Select **"Pro"** or **"Enterprise"**
84
+ 3. You'll get a **14-day free trial**
85
+ 4. No credit card required until trial expires
86
+ 5. Cancel anytime before trial ends with zero charges
87
+
88
+ ### 3. View Your Current Plan
89
+ 1. Click **Settings** (gear icon)
90
+ 2. Select **"Billing & Subscription"**
91
+ 3. See your current tier, next billing date, and usage stats
92
+
93
+ ---
94
+
95
+ ## Free Tier
96
+
97
+ ### What You Get
98
+ Free tier is perfect for learning and hobby projects:
99
+ - 3 projects (perfect for learning different features)
100
+ - 100 parts per project
101
+ - 1 GB storage (~10-20 projects depending on size)
102
+ - Basic 3D viewer
103
+ - STEP import up to 30 MB
104
+ - 20 AI requests per day
105
+
106
+ ### When You'll Hit Limits
107
+ - **Projects**: Create 4th project → upgrade prompt
108
+ - **Parts**: Add 101st part → upgrade prompt
109
+ - **Storage**: Upload file that would exceed 1 GB → upgrade prompt
110
+ - **AI requests**: After 20 requests today → queue requests or upgrade
111
+
112
+ ### Upgrade When You Need
113
+ Click "Upgrade" button that appears when you hit a limit:
114
+ - Choose **Pro** (€49/mo) or **Enterprise** (€299/mo)
115
+ - Get 14-day free trial to test features
116
+ - If satisfied, confirm payment at end of trial
117
+ - If not satisfied, cancel anytime
118
+
119
+ ---
120
+
121
+ ## Upgrading to Pro
122
+
123
+ ### Benefits Over Free
124
+ | Feature | Free | Pro |
125
+ |---------|------|-----|
126
+ | Projects | 3 | Unlimited |
127
+ | Parts per project | 100 | Unlimited |
128
+ | Storage | 1 GB | 50 GB |
129
+ | STEP import size | 30 MB | 500 MB |
130
+ | AI requests/day | 20 | 500 |
131
+ | CAM operations | No | Yes |
132
+ | Custom materials | No | Yes |
133
+ | API access | No | Yes |
134
+ | Support | Community | Priority email |
135
+
136
+ ### Step-by-Step Upgrade
137
+
138
+ #### From Free Tier
139
+ 1. Click **Upgrade** button (appears in toolbar or on limit prompt)
140
+ 2. Choose **Pro** (€49/month)
141
+ 3. Optionally choose **yearly billing** for 20% discount (€468/year)
142
+ 4. Click **"Start 14-Day Free Trial"**
143
+ 5. Enter payment method (card, Apple Pay, Google Pay)
144
+ 6. Review charges: €0 for trial, €49 charged on day 15
145
+ 7. Click **"Subscribe"**
146
+ 8. You're on Pro! Full features unlocked immediately
147
+
148
+ #### From Web
149
+ 1. Go to [cyclecad.com/pricing](https://cyclecad.com/pricing)
150
+ 2. Click **"Start Free Trial"** under Pro card
151
+ 3. Log in to your account
152
+ 4. Complete payment setup
153
+ 5. Confirm subscription
154
+
155
+ ### Managing Pro Subscription
156
+
157
+ **To change billing cycle (monthly ↔ yearly)**:
158
+ 1. Click **Settings** → **Billing & Subscription**
159
+ 2. Click **"Change Billing Cycle"**
160
+ 3. Choose **Monthly** or **Yearly**
161
+ 4. Confirm — change takes effect next billing period
162
+
163
+ **To cancel anytime**:
164
+ 1. Click **Settings** → **Billing & Subscription**
165
+ 2. Click **"Manage Subscription"** → opens Stripe portal
166
+ 3. Click **"Cancel Subscription"**
167
+ 4. You keep access until end of current billing period
168
+ 5. Can resubscribe anytime
169
+
170
+ ---
171
+
172
+ ## Upgrading to Enterprise
173
+
174
+ ### When to Choose Enterprise
175
+ Choose Enterprise when you:
176
+ - Have a team of 3+ people collaborating
177
+ - Need unlimited storage and AI requests
178
+ - Want CAM integration with fab networks
179
+ - Require custom branding
180
+ - Need SSO for company accounts
181
+ - Want 99.9% SLA guarantee
182
+ - Prefer self-hosted option
183
+
184
+ ### Benefits Over Pro
185
+ | Feature | Pro | Enterprise |
186
+ |---------|-----|------------|
187
+ | Collaborators | 10 | Unlimited |
188
+ | Storage | 50 GB | 500 GB |
189
+ | AI requests/day | 500 | Unlimited |
190
+ | STEP import size | 500 MB | Unlimited |
191
+ | CAM to fab network | No | Yes |
192
+ | Custom branding | No | Yes |
193
+ | SSO | No | Yes |
194
+ | Self-hosted | No | Yes |
195
+ | SLA | Best effort | 99.9% |
196
+ | Support | Priority email | Dedicated + training |
197
+
198
+ ### Step-by-Step Upgrade
199
+
200
+ #### From Free or Pro Tier
201
+ 1. Click **Upgrade** button
202
+ 2. Choose **Enterprise** (€299/month)
203
+ 3. Optionally choose **yearly** for 20% discount (€2,868/year)
204
+ 4. Get **14-day free trial** (if coming from Free)
205
+ 5. Enter payment method
206
+ 6. Review: €0 trial (if eligible) or €299 charged immediately
207
+ 7. Click **"Subscribe"**
208
+
209
+ #### Contact Sales
210
+ For volume discounts or custom contracts:
211
+ 1. Go to [cyclecad.com/enterprise](https://cyclecad.com/enterprise)
212
+ 2. Click **"Contact Sales"**
213
+ 3. Team will email you within 24 hours
214
+ 4. Discuss custom pricing and terms
215
+
216
+ ### Enterprise Features
217
+
218
+ **Single Sign-On (SSO)**
219
+ - Connect your company's identity provider (Microsoft, Google, Okta)
220
+ - All employees sign in with company credentials
221
+ - Automatic access control
222
+
223
+ **Self-Hosted Option**
224
+ - Run cycleCAD on your own servers
225
+ - Full control over data and infrastructure
226
+ - Docker Compose deployment provided
227
+ - Custom domain and branding
228
+
229
+ **Dedicated Support**
230
+ - Direct email support channel
231
+ - 4-hour response time SLA
232
+ - Quarterly check-in calls
233
+ - Product training for your team
234
+
235
+ **Custom Branding**
236
+ - Add your company logo
237
+ - Use custom domain (e.g., cad.yourcompany.com)
238
+ - White-label deployment option
239
+
240
+ ---
241
+
242
+ ## Managing Your Subscription
243
+
244
+ ### Access Billing Portal
245
+ 1. Click **Settings** (gear icon) → **Billing & Subscription**
246
+ 2. Click **"Manage Subscription"**
247
+ 3. Opens Stripe Customer Portal where you can:
248
+ - Update payment method
249
+ - View and download invoices
250
+ - Change billing email
251
+ - Cancel subscription
252
+ - See next billing date
253
+
254
+ ### View Usage Stats
255
+ 1. Open **Settings** → **Billing & Subscription**
256
+ 2. See current usage bars showing:
257
+ - Projects used / limit
258
+ - Storage used / limit
259
+ - AI requests today / daily limit
260
+ 3. **Green** = <70% used ✓
261
+ 4. **Yellow** = 70-90% used ⚠️
262
+ 5. **Red** = >90% used, approaching limit
263
+
264
+ ### Export Usage Report
265
+ 1. Click **Settings** → **Billing & Subscription**
266
+ 2. Click **"Export Usage Report"**
267
+ 3. CSV file downloads with:
268
+ - All usage metrics
269
+ - Current month data
270
+ - Tier and subscription status
271
+ - Timestamp
272
+ 4. Great for expense tracking or team reports
273
+
274
+ ### Change Email on File
275
+ 1. Click **"Manage Subscription"** → opens Stripe portal
276
+ 2. Click **"Update billing information"**
277
+ 3. Change email address
278
+ 4. Save changes
279
+
280
+ ---
281
+
282
+ ## Usage Limits
283
+
284
+ ### Free Tier Limits
285
+
286
+ | Feature | Limit | What Happens |
287
+ |---------|-------|---------|
288
+ | Projects | 3 | Can't create 4th project, see upgrade prompt |
289
+ | Parts per project | 100 | Can't add 101st part, see upgrade prompt |
290
+ | Storage | 1 GB | Can't upload files exceeding quota, see suggestion to delete or upgrade |
291
+ | AI requests | 20/day | After 20 requests, queued until tomorrow OR upgrade to continue |
292
+ | STEP import | 30 MB | Files >30 MB rejected, see upgrade prompt with file size |
293
+ | Collaborators | 0 | Can't invite others, see "Pro feature" message |
294
+ | CAM operations | None | CAM buttons disabled, click for upgrade prompt |
295
+
296
+ ### Pro Tier Limits
297
+
298
+ | Feature | Limit |
299
+ |---------|-------|
300
+ | Projects | Unlimited |
301
+ | Parts per project | Unlimited |
302
+ | Storage | 50 GB (~500-1000 medium projects) |
303
+ | AI requests | 500/day |
304
+ | STEP import | 500 MB |
305
+ | Collaborators | 10 |
306
+ | CAM operations | Unlimited |
307
+
308
+ ### Enterprise Tier
309
+ No limits on almost everything. All features available.
310
+
311
+ ### When You Hit a Limit
312
+ 1. A prompt appears: "You've reached your limit"
313
+ 2. Shows current usage vs limit
314
+ 3. Suggests upgrade to Pro or Enterprise
315
+ 4. Click **"Upgrade"** to start checkout
316
+ 5. Click **"Dismiss"** to stay on current tier
317
+
318
+ ### Checking Usage Anytime
319
+ 1. **Settings** → **Billing & Subscription**
320
+ 2. View **"Current Usage"** section
321
+ 3. Progress bars show percentage used
322
+ 4. Click **"Export Usage"** for detailed report
323
+
324
+ ---
325
+
326
+ ## Trial Period
327
+
328
+ ### Free Trial Details
329
+ - **Duration**: 14 days
330
+ - **Cost**: €0
331
+ - **What's included**: Full Pro features
332
+ - **Automatic upgrade**: On day 15, first charge (€49/mo or €468/yr)
333
+ - **Cancel anytime**: No charges if you cancel before day 15
334
+
335
+ ### Starting a Trial
336
+
337
+ **As a new Free user**:
338
+ 1. Click **Upgrade** → select Pro or Enterprise
339
+ 2. Trial automatically starts
340
+ 3. Get 14 days free access to all Pro/Enterprise features
341
+ 4. No credit card charge during trial
342
+
343
+ **If you already have a Pro subscription**:
344
+ - Can't start another trial (already a customer)
345
+ - Can try Enterprise features by upgrading
346
+ - Pro → Enterprise upgrade may include pro-rata credit
347
+
348
+ ### Countdown to Trial Expiration
349
+ When on trial, you see:
350
+ - **Banner at top**: "Trial expires in 12 days"
351
+ - **Settings page**: "Trial ends March 30, 2026"
352
+ - **Reminder email**: Day before expiration
353
+ - **Final notice**: Day of expiration if payment method not set
354
+
355
+ ### Before Trial Expires
356
+
357
+ **Option 1: Continue subscription**
358
+ 1. Go to **Settings** → **Billing & Subscription**
359
+ 2. Click **"Manage Subscription"**
360
+ 3. Payment method already on file
361
+ 4. On day 15, first charge processed
362
+ 5. Subscription continues automatically
363
+
364
+ **Option 2: Cancel**
365
+ 1. Go to **Settings** → **Billing & Subscription**
366
+ 2. Click **"Cancel Subscription"**
367
+ 3. Confirm cancellation
368
+ 4. Access downgraded to Free on day 15
369
+ 5. Can resubscribe anytime
370
+
371
+ ### Grace Period
372
+ If payment fails:
373
+ - 7-day grace period to update payment method
374
+ - Full access maintained during grace period
375
+ - Reminder emails sent (days 1, 3, 5, 7)
376
+ - After 7 days, subscription canceled and tier downgraded to Free
377
+
378
+ ---
379
+
380
+ ## Billing & Invoices
381
+
382
+ ### Invoice Information
383
+ Invoices include:
384
+ - Invoice number and date
385
+ - Your billing details
386
+ - Itemized charges
387
+ - Amount due
388
+ - Payment method used
389
+ - Invoice period (e.g., March 1-31, 2026)
390
+
391
+ ### Accessing Invoices
392
+
393
+ **In cycleCAD**:
394
+ 1. **Settings** → **Billing & Subscription**
395
+ 2. Scroll to **"Recent Invoices"**
396
+ 3. Click invoice to preview or download PDF
397
+
398
+ **In Stripe Portal**:
399
+ 1. Click **"Manage Subscription"**
400
+ 2. Click **"Invoices"** tab
401
+ 3. List of all invoices with download links
402
+ 4. PDFs are standard business invoices
403
+
404
+ ### Invoice Details
405
+ Each invoice shows:
406
+ - Your company name (if provided)
407
+ - Subscription plan (Pro or Enterprise)
408
+ - Billing period
409
+ - Amount: €49 (Pro/month) or €299 (Enterprise/month)
410
+ - Payment method last 4 digits
411
+ - Transaction ID
412
+ - Tax (if applicable by region)
413
+
414
+ ### Downloading Invoices
415
+
416
+ **Method 1: From cycleCAD app**
417
+ 1. **Settings** → **Billing**
418
+ 2. Click invoice
419
+ 3. PDF opens in new tab
420
+ 4. Save or print
421
+
422
+ **Method 2: From Stripe Portal**
423
+ 1. Click **"Manage Subscription"**
424
+ 2. Click **"Invoices"** tab
425
+ 3. Click download icon next to invoice
426
+ 4. PDF saves to computer
427
+
428
+ ### Tax & Receipts
429
+ - EU VAT applied if applicable
430
+ - US states with sales tax: tax added
431
+ - Receipts available in Stripe portal
432
+ - Use invoices for business expense tracking
433
+
434
+ ### Billing Email
435
+ Update billing email address:
436
+ 1. Click **"Manage Subscription"**
437
+ 2. Click **"Update billing information"**
438
+ 3. Change email
439
+ 4. Future invoices sent to new address
440
+ 5. Old invoices still available in portal
441
+
442
+ ---
443
+
444
+ ## Payment Methods
445
+
446
+ ### Accepted Payment Methods
447
+ - **Credit cards**: Visa, Mastercard, American Express, Discover
448
+ - **Digital wallets**: Apple Pay, Google Pay
449
+ - **Bank transfers**: ACH (US), SEPA (Europe) — contact support
450
+ - **Crypto**: USDC, ETH — Enterprise only, contact sales
451
+
452
+ ### Adding a Payment Method
453
+
454
+ **During checkout**:
455
+ 1. At checkout page, enter card details
456
+ 2. Name on card, number, expiration, CVV
457
+ 3. Billing address (for fraud verification)
458
+ 4. Click **"Subscribe"**
459
+
460
+ **After subscribing**:
461
+ 1. Click **"Manage Subscription"** → Stripe portal
462
+ 2. Click **"Update payment method"**
463
+ 3. Enter new card details
464
+ 4. Confirm
465
+
466
+ ### Updating Payment Method
467
+ 1. **Settings** → **Billing & Subscription**
468
+ 2. Click **"Manage Subscription"**
469
+ 3. Click **"Update payment information"**
470
+ 4. Select new payment method or add new card
471
+ 5. Save changes
472
+
473
+ ### Removing a Payment Method
474
+ Don't remove your only payment method! To replace:
475
+ 1. Add new payment method first
476
+ 2. Set as default
477
+ 3. Then remove old method
478
+
479
+ ### Failed Payments
480
+ If payment fails:
481
+ 1. You get email notification immediately
482
+ 2. 7-day grace period to update payment method
483
+ 3. Reminder emails sent (days 1, 3, 5, 7)
484
+ 4. Full access maintained during grace period
485
+ 5. After 7 days, subscription canceled if not resolved
486
+
487
+ **To fix failed payment**:
488
+ 1. Click email link or go to **Settings**
489
+ 2. Click **"Update Payment Method"**
490
+ 3. Enter valid card
491
+ 4. Retry payment
492
+ 5. Subscription continues
493
+
494
+ ---
495
+
496
+ ## Promo Codes & Discounts
497
+
498
+ ### Applying a Promo Code
499
+
500
+ **During checkout**:
501
+ 1. At checkout page, scroll to **"Promo Code"**
502
+ 2. Enter code (e.g., SUMMER20)
503
+ 3. Click **"Apply"**
504
+ 4. Discount shown on next line
505
+ 5. Final price updated
506
+ 6. Complete checkout
507
+
508
+ **Existing subscription**:
509
+ Promo codes apply only at checkout time. To use a code on an existing subscription, contact sales@cyclecad.com.
510
+
511
+ ### Common Promotions
512
+ - **STUDENT20**: 20% off Pro for students (verify with .edu email)
513
+ - **NONPROFIT30**: 30% off for registered nonprofits
514
+ - **ANNUAL20**: 20% off yearly billing (auto-applied)
515
+ - **REFERRAL25**: 25% credit for each successful referral
516
+
517
+ ### Finding Promo Codes
518
+ - Check emails from cycleCAD
519
+ - Follow [@cyclecad](https://twitter.com/cyclecad) on Twitter/X for announcements
520
+ - Join Discord community for exclusive codes
521
+ - Contact sales for corporate/volume discounts
522
+
523
+ ### Discount Eligibility
524
+ - **Student**: .edu email, proof of enrollment
525
+ - **Nonprofit**: 501(c)(3) status or equivalent
526
+ - **Volume**: 5+ licenses, contact sales for quote
527
+ - **Community**: Nightly, beta, startup programs
528
+
529
+ ### Yearly Billing Discount
530
+ **Automatic 20% discount** when you choose yearly:
531
+ - Pro: €468/year = €39/month (normally €49)
532
+ - Enterprise: €2,868/year = €239/month (normally €299)
533
+ - No promo code needed, applied automatically at checkout
534
+
535
+ ---
536
+
537
+ ## Self-Hosting (Enterprise)
538
+
539
+ ### What is Self-Hosting?
540
+ Run cycleCAD on your own servers instead of using cyclecad.com. Benefits:
541
+ - Complete data privacy
542
+ - Full control over infrastructure
543
+ - Custom domain and branding
544
+ - Integration with existing systems
545
+ - Compliance with industry regulations
546
+
547
+ ### Who Should Self-Host?
548
+ - Large organizations with data security requirements
549
+ - Companies with HIPAA, GDPR, or SOC 2 compliance needs
550
+ - Teams wanting full control over data
551
+ - Organizations with existing infrastructure
552
+
553
+ ### Getting Started with Self-Hosting
554
+
555
+ **Step 1: Contact Sales**
556
+ 1. Go to [cyclecad.com/enterprise](https://cyclecad.com/enterprise)
557
+ 2. Click **"Contact Sales"** or email sales@cyclecad.com
558
+ 3. Mention you want self-hosting
559
+ 4. Sales will discuss:
560
+ - Infrastructure requirements
561
+ - Licensing terms
562
+ - Deployment support
563
+ - Custom pricing
564
+
565
+ **Step 2: Docker Deployment**
566
+ Once you purchase, you get:
567
+ - `docker-compose.yml` for quick start
568
+ - `Dockerfile` and all dependencies
569
+ - Deployment guide (Linux, Mac, Windows)
570
+ - Health check scripts
571
+
572
+ **Step 3: Quick Start**
573
+ ```bash
574
+ # 1. Get deployment files
575
+ git clone https://github.com/cyclecad/self-hosted.git
576
+ cd self-hosted
577
+
578
+ # 2. Configure environment
579
+ cp .env.example .env
580
+ # Edit .env with your settings (domain, SMTP, etc.)
581
+
582
+ # 3. Start services
583
+ docker-compose up -d
584
+
585
+ # 4. Access at https://your-domain.com
586
+ ```
587
+
588
+ **Step 4: Ongoing Support**
589
+ - Quarterly updates provided
590
+ - Security patches within 48 hours
591
+ - Dedicated support email
592
+ - Training for your ops team
593
+
594
+ ### System Requirements
595
+ - **CPU**: 4+ cores recommended
596
+ - **RAM**: 8 GB minimum, 16 GB recommended
597
+ - **Storage**: 100 GB SSD (depends on usage)
598
+ - **OS**: Linux (Ubuntu 20.04+), macOS, Windows Server
599
+ - **Docker**: v20.10+ or Kubernetes 1.20+
600
+
601
+ ### Backup & Disaster Recovery
602
+ - Daily automated backups included
603
+ - Backup guide provided
604
+ - Recovery procedures documented
605
+ - RTO/RPO targets: 1 hour
606
+ - Geo-redundant backup option (additional fee)
607
+
608
+ ---
609
+
610
+ ## FAQ
611
+
612
+ ### General Billing
613
+
614
+ **Q: Can I try Pro features before paying?**
615
+ A: Yes! Get 14-day free trial with full Pro access. No credit card required, cancel anytime.
616
+
617
+ **Q: What happens if I exceed my storage limit?**
618
+ A: You get a warning at 80% usage. At 100%, can't upload new files. Delete files or upgrade to increase limit.
619
+
620
+ **Q: Can I change plans anytime?**
621
+ A: Yes! Upgrade anytime for full features. Downgrade anytime at end of billing period.
622
+
623
+ **Q: Is there a setup fee?**
624
+ A: No. Only monthly or yearly subscription fee, nothing else.
625
+
626
+ ### Trial & Upgrades
627
+
628
+ **Q: Can I use the free trial multiple times?**
629
+ A: No. Trial is available once per account. If you cancel, you can resubscribe but new trial unavailable.
630
+
631
+ **Q: What happens after my trial ends?**
632
+ A: If you don't cancel, your credit card is charged on day 15. Set your payment method before day 14 to ensure uninterrupted service.
633
+
634
+ **Q: Can I get a refund?**
635
+ A: Pro has 14-day trial risk-free. After that, subscriptions are non-refundable. Cancel anytime to avoid next charge.
636
+
637
+ **Q: Can I pause my subscription instead of canceling?**
638
+ A: Not currently, but you can cancel and resubscribe later without penalty.
639
+
640
+ ### Payments & Invoicing
641
+
642
+ **Q: What payment methods do you accept?**
643
+ A: Visa, Mastercard, Amex, Discover, Apple Pay, Google Pay, and ACH/SEPA transfers (Enterprise).
644
+
645
+ **Q: Where can I download invoices?**
646
+ A: **Settings** → **Billing** → **Invoices**, or click **"Manage Subscription"** to access Stripe portal.
647
+
648
+ **Q: What if my payment fails?**
649
+ A: You get 7 days to update your payment method. Reminder emails sent on days 1, 3, 5, 7. After 7 days, subscription canceled.
650
+
651
+ **Q: Do you charge tax?**
652
+ A: Yes, if applicable by region. EU VAT, US sales tax, and others added at checkout. See invoice for details.
653
+
654
+ **Q: Can I get an invoice for accounting?**
655
+ A: Yes! Download PDF from portal or Settings page. Standard business invoice format, suitable for expense reports.
656
+
657
+ ### Features & Limits
658
+
659
+ **Q: What's the difference between Pro and Enterprise?**
660
+ A: Pro is for individuals/small teams. Enterprise for large teams, includes SSO, self-hosting, dedicated support, and unlimited everything.
661
+
662
+ **Q: How much storage is 50 GB?**
663
+ A: Roughly 500-1,000 medium-sized projects depending on complexity. Average project is 50-100 MB.
664
+
665
+ **Q: What if I need more storage than my plan?**
666
+ A: Contact support at support@cyclecad.com. We may increase your limit temporarily or suggest upgrade.
667
+
668
+ **Q: How many collaborators can I invite on Pro?**
669
+ A: Up to 10 collaborators. Enterprise has unlimited collaborators.
670
+
671
+ **Q: Can I share a subscription with my team?**
672
+ A: Pro is for one person. For team access, upgrade to Enterprise or create separate Pro accounts per person.
673
+
674
+ ### Cancellation & Downgrades
675
+
676
+ **Q: How do I cancel my subscription?**
677
+ A: **Settings** → **Billing** → **"Manage Subscription"** → **"Cancel Subscription"**. Confirm, and it's canceled. You keep access until end of billing period.
678
+
679
+ **Q: What happens to my projects after cancellation?**
680
+ A: Projects remain in your account. You can access them (read-only) on Free tier, but can't edit until you resubscribe.
681
+
682
+ **Q: Can I resubscribe after canceling?**
683
+ A: Yes! All your projects are preserved. Resubscribe anytime and pick up where you left off.
684
+
685
+ **Q: Can I downgrade from Pro to Free?**
686
+ A: Yes. Cancel Pro subscription and you'll be downgraded to Free at end of billing period.
687
+
688
+ **Q: What if I have more than 3 projects on Free tier?**
689
+ A: After downgrade, all projects preserved but you can't create new ones until you delete some.
690
+
691
+ ### Enterprise & Self-Hosting
692
+
693
+ **Q: How much does Enterprise cost?**
694
+ A: €299/month or €2,868/year (20% discount). Custom pricing available for large organizations.
695
+
696
+ **Q: What's included with self-hosting?**
697
+ A: Full source code, Docker deployment, updates, support, and custom branding.
698
+
699
+ **Q: Do I get a dedicated account manager?**
700
+ A: Yes, with Enterprise. Your account manager helps with onboarding, training, and technical issues.
701
+
702
+ **Q: Can I use SSO with my company's identity provider?**
703
+ A: Yes! Enterprise includes SSO integration with Microsoft, Google, Okta, and other providers.
704
+
705
+ **Q: What about data privacy with self-hosting?**
706
+ A: Complete control. Data never leaves your servers. Suitable for HIPAA, GDPR, and SOC 2 compliance.
707
+
708
+ ### Support & Troubleshooting
709
+
710
+ **Q: How do I contact support?**
711
+ A: Free/Pro: support@cyclecad.com (best-effort). Enterprise: dedicated support email (4-hour response).
712
+
713
+ **Q: What's the response time?**
714
+ A: Free: community Discord. Pro: 24-48 hours email. Enterprise: 4 hours.
715
+
716
+ **Q: Do you offer refunds?**
717
+ A: Pro has 14-day free trial. After subscribing, no refunds. You can cancel to stop future charges.
718
+
719
+ **Q: What if there's a billing mistake?**
720
+ A: Contact support@cyclecad.com with invoice number and details. We'll review and correct.
721
+
722
+ **Q: Can I change my billing email?**
723
+ A: Yes. Click **"Manage Subscription"** → **"Update billing information"** → change email.
724
+
725
+ ---
726
+
727
+ ## Contact Us
728
+
729
+ Need help with billing? We're here to help!
730
+
731
+ - **Email**: support@cyclecad.com
732
+ - **Discord**: [join.discord.gg/cyclecad](https://discord.gg/cyclecad)
733
+ - **Twitter**: [@cyclecad](https://twitter.com/cyclecad)
734
+ - **Website**: [cyclecad.com](https://cyclecad.com)
735
+
736
+ **Enterprise Support**: sales@cyclecad.com or dedicated account manager