Cotopia — Calculator Product Guide

Primary goals

• Instant pricing & margin checks
• Scenario comparisons and CSV export
• Easy embed for developer docs and ecommerce pages
• Partner-ready: distributed via Product Agreement and Distributor Program

Modes

• Basic: Cost + Price → Gross, Margin
• Advanced: Cost, Price, Fixed, Variable, Scenario1, Scenario2 → Gross, Net, Margin (per scenario)

Capabilities

• CSV export of inputs + results
• Responsive Chart.js bar chart (Gross vs Net across scenarios)
• Embeddable snippet/iframe or SDK component
• Accessible: labelled inputs and aria-live result area

Example — Course

Inputs: Cost $10, Price $49, Fixed $2, Variable $3

Results — Gross = $39; Net = $34; Margin ≈ 69.39%

Scenario comparison

Scenario1 (price $39) → Net ≈ $24 (61.5%); Scenario2 (price $59) → Net ≈ $44 (74.6%)

Hosted SaaS

Default: minimal ops for partners, Company manages hosting and updates.

Embeddable widget / iframe

Drop-in iframe or JS widget for docs, product pages or landing pages. Themeable via CSS variables or init options.

SDK (npm)

Optional React/Vue/vanilla packages for deeper integration and init callbacks.

White‑label / OEM (Tier 4)

Custom hosting, rebranding, or source options under negotiated Product Agreement.

Charting

Chart.js v4+, responsive bar chart showing Gross vs Net across main + scenarios. Always destroy old chart instance before creating a new one to prevent memory leaks.

CSV export

Client-side Blob download. Include timestamp and SKU in exported CSV. Escape quotes and values correctly.

Validation

Use parseFloat + Number.isFinite; require price > 0. Prefer inline validation messages over blocking alerts for UX.

Accessibility

Use labels for inputs and aria-live result region. Provide table fallback for charts for screen readers.

Init API

initCalculator(containerId, {
  mode:'advanced',
  defaults:{cost:10,price:49,fixed:2,variable:3,s1:39,s2:59},
  theme:{primary:'#4CAF50'},
  onCalculate: (result)=>{/* analytics */},
  onExportCSV: (blob)=>{/* upload or intercept */}
});

Events

• onCalculate(resultObject)
• onExportCSV(blobOrUrl)
• onInit(callback)

Server endpoints (optional)

/api/license/check, /api/track/calc — use short-lived tokens for embed licensing.

• Use HTTPS for all embeds and API calls.
• Rotate embed tokens; validate server-side.
• If capturing user emails or PII, ensure lawful basis and a DPA where necessary.
• Avoid logging PII in usage telemetry; anonymize where possible.

Core rights (while paid & compliant)

• Market and resell the Calculator in the agreed Territory
• Embed widget or link to hosted SaaS
• Receive Included Tech Support for Distributor personnel only

Obligations

• Timely payment of Admin & Continued License fees
• Maintain competent sales & support staff trained on Company documentation
• Do not include "Cotopia" in your DBA
• Report sales and metrics; comply with audits

Developer messaging

“Tiny embeddable profit calculator — drop into docs, marketplaces, and product pages. Theming + init API. No backend required.”

Founder messaging

“Price with confidence — run scenarios, export CSV, prepare client proposals. Add to your checkout and docs to reduce buyer friction.”

Channels & assets

• Developer docs, GitHub, npm, demo embeds
• Indie hacker communities, creator newsletters
• SEO-driven content: “how to price your digital product” guides

Levels

• Level 0: Self-serve docs & recorded training
• Level 1: Distributor triage & resolve
• Level 2: Company partner support (portal ticket)
• Level 3: Company engineering (confirmed product bugs)

SLA acknowledgement targets (partner-facing)

• Severity 1 — 1 hour (ack target)
• Severity 2 — 4 business hours
• Severity 3 — 1 business day
• Severity 4 — 3 business days

• Number of Product Agreements executed
• Admin Fees collected vs remitted
• Continued License payments current vs overdue
• Active users (DAU/WAU/MAU), CSV exports, embed interactions
• Time to first response for escalations

• License conditional on timely payment of Admin & Continued License fees
• Export controls: do not sell to embargoed regions
• IP remains with Company; Tier 4 negotiated for white-label/source rights
• Confidentiality survives termination (5 years; trade secrets longer)
• Distributor responsible for VAT/GST/sales taxes

Product Agreement quick fields

Field	Example
Effective Date	2025-10-01
Product / SKU	Cotopia Digital Calculator — COT-DC-100
Tier	Tier 1 / Tier 2 / Tier 3 / Tier 4
Support model	Distributor-as-Middleman (default)
Initial payment	Admin fee + $79 (initial)

Can I embed the calculator?

Yes — iframe or widget. White-label hosting requires Tier 4 and explicit Product Agreement.

Is there an API for bulk calculations?

Not in the base product. Contact Company for API-enabled SOW or partner feature request.

Do I need to be a Distributor to resell?

Yes — reselling and trademark use are governed by the Product Agreement and Master Agreement.

Iframe embed

<iframe src="https://app.cotopia.shop/calculator/embed?sku=COT-DC-100"
  width="100%" height="480" style="border:0"></iframe>

Vanilla widget init

<div id="cotopia-calculator"></div>
<script src="https://cdn.cotopia.shop/widget/calculator.v1.min.js"></script>
<script>
  CotopiaCalculator.init('#cotopia-calculator', {
    sku:'COT-DC-100',
    mode:'advanced',
    defaults:{cost:10,price:49,fixed:2,variable:3,s1:39,s2:59},
    theme:{primary:'#4CAF50'},
    onCalculate: r => console.log(r)
  });
</script>