Initial commit — Performance West telecom compliance platform
Includes: API (Express/TypeScript), Astro site, Python workers, document generators, FCC compliance tools, Canada CRTC formation, Ansible infrastructure, and deployment scripts. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
justin
commit
f8cd37ac8c
1823 changed files with 145167 additions and 0 deletions
242
site/src/components/intake/steps/Block6CertStep.astro
Normal file
242
site/src/components/intake/steps/Block6CertStep.astro
Normal file
|
|
@ -0,0 +1,242 @@
|
|||
---
|
||||
// Block6CertStep — Lines 603-605, 612 + de minimis election.
|
||||
// Exemption certifications (USF/TRS/NANPA/LNP/ITSP), 501(c)/government,
|
||||
// nondisclosure request, filing type, and the de minimis vs. regular
|
||||
// election (with explainer).
|
||||
import { NONDISCLOSURE_CERT_TEXT, FILING_TYPE_LABELS } from "../../../lib/fcc_constants";
|
||||
import DeMinimisChoiceExplainer from "../DeMinimisChoiceExplainer.astro";
|
||||
---
|
||||
|
||||
<div class="pw-step">
|
||||
<h2>Certifications (Block 6)</h2>
|
||||
|
||||
<section class="pw-block" id="pw-demin-section">
|
||||
<h3>De minimis filing election</h3>
|
||||
<p class="pw-help">
|
||||
Based on your revenue + safe-harbor interstate % and the current
|
||||
year's de minimis factor, your estimated annual USF contribution is
|
||||
<strong id="pw-demin-estimate">—</strong>. The exemption threshold
|
||||
is $10,000 (Appendix A).
|
||||
</p>
|
||||
<div id="pw-demin-status-banner" class="pw-demin-banner" hidden></div>
|
||||
|
||||
<DeMinimisChoiceExplainer />
|
||||
|
||||
<label class="pw-field">How do you want to file?</label>
|
||||
<select id="pw-demin-election" class="pw-input">
|
||||
<option value="auto">Let the Appendix A calculation decide (standard)</option>
|
||||
<option value="deminimis">File as de minimis — no USF contribution</option>
|
||||
<option value="regular">File as regular contributor — pay USF directly (waive exemption)</option>
|
||||
</select>
|
||||
|
||||
<div id="pw-waive-reason-wrap" hidden>
|
||||
<label class="pw-field">Reason for filing regular (optional — shown to reviewers)</label>
|
||||
<textarea id="pw-waive-reason" class="pw-input" rows="2"
|
||||
placeholder="e.g., 'Wholesale SIP vendor charges us USF surcharge on trunking — filing regular so we can show Filer ID + reseller cert.'"></textarea>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="pw-block">
|
||||
<h3>Line 603 — Claim exemption from contribution mechanisms</h3>
|
||||
<p class="pw-help">
|
||||
Check any mechanism you're exempt from. Exemptions require a written
|
||||
explanation and evidence your legal team can produce on audit.
|
||||
</p>
|
||||
<div class="pw-cert-grid">
|
||||
<label><input type="checkbox" id="pw-ex-usf" /> USF (Universal Service Fund)</label>
|
||||
<label><input type="checkbox" id="pw-ex-trs" /> TRS (Telecom Relay Service)</label>
|
||||
<label><input type="checkbox" id="pw-ex-nanpa" /> NANPA (numbering)</label>
|
||||
<label><input type="checkbox" id="pw-ex-lnp" /> LNP (number portability)</label>
|
||||
<label><input type="checkbox" id="pw-ex-itsp" /> ITSP (regulatory fees)</label>
|
||||
</div>
|
||||
<div id="pw-ex-expl-wrap" hidden>
|
||||
<label class="pw-field">Explanation (required for any exemption)</label>
|
||||
<textarea id="pw-ex-expl" class="pw-input" rows="3"></textarea>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="pw-block">
|
||||
<h3>Line 604 — Organization type</h3>
|
||||
<label><input type="checkbox" id="pw-gov" /> State or local government entity</label><br>
|
||||
<label><input type="checkbox" id="pw-501c" /> 501(c) tax-exempt organization</label>
|
||||
</section>
|
||||
|
||||
<section class="pw-block">
|
||||
<h3>Line 605 — Confidential treatment of revenue data</h3>
|
||||
<label>
|
||||
<input type="checkbox" id="pw-nondisclosure" />
|
||||
Request nondisclosure of revenue information
|
||||
</label>
|
||||
<p id="pw-nondisclosure-text" class="pw-cert-text" hidden></p>
|
||||
</section>
|
||||
|
||||
<section class="pw-block">
|
||||
<h3>Line 612 — Type of filing</h3>
|
||||
<select id="pw-filing-type" class="pw-input">
|
||||
<option value="original_april_1">Original Filing (April 1)</option>
|
||||
<option value="registration_new_filer">Registration — New Filer</option>
|
||||
<option value="revised_registration">Revised Filing (Registration Info)</option>
|
||||
<option value="revised_revenue">Revised Filing (Revenue Info)</option>
|
||||
</select>
|
||||
</section>
|
||||
|
||||
<div id="pw-b6-err" class="pw-err" hidden></div>
|
||||
</div>
|
||||
|
||||
<style>
|
||||
.pw-step h2 { margin: 0 0 0.5rem; color: #1a2744; }
|
||||
.pw-step h3 { margin: 0 0 0.4rem; color: #1a2744; font-size: 1rem; }
|
||||
.pw-block { padding: 1rem; border: 1px solid #e2e8f0; border-radius: 8px; margin-bottom: 0.75rem; }
|
||||
.pw-help { color: #64748b; font-size: 0.85rem; margin-bottom: 0.75rem; }
|
||||
.pw-field { display: block; font-weight: 600; color: #1f2937; margin: 0.6rem 0 0.2rem; font-size: 0.88rem; }
|
||||
.pw-input { width: 100%; padding: 0.5rem 0.7rem; border: 1px solid #cbd5e1; border-radius: 6px; font-size: 0.93rem; font-family: inherit; }
|
||||
.pw-demin-banner {
|
||||
padding: 0.5rem 0.75rem; border-radius: 6px;
|
||||
margin-top: 0.5rem; font-size: 0.88rem;
|
||||
}
|
||||
.pw-demin-banner.pw-exempt { background: #d1fae5; color: #065f46; border-left: 3px solid #059669; }
|
||||
.pw-demin-banner.pw-no-exempt{ background: #fee2e2; color: #991b1b; border-left: 3px solid #dc2626; }
|
||||
.pw-demin-banner.pw-near { background: #fef3c7; color: #92400e; border-left: 3px solid #d97706; }
|
||||
.pw-cert-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(200px, 1fr)); gap: 0.4rem; margin-bottom: 0.5rem; }
|
||||
.pw-cert-grid label { font-size: 0.9rem; }
|
||||
.pw-cert-text {
|
||||
font-size: 0.82rem; color: #475569;
|
||||
background: #f8fafc; padding: 0.5rem 0.75rem; border-radius: 6px;
|
||||
margin-top: 0.5rem;
|
||||
}
|
||||
.pw-err { color: #b91c1c; margin-top: 0.75rem; font-size: 0.9rem; }
|
||||
</style>
|
||||
|
||||
<script>
|
||||
import { NONDISCLOSURE_CERT_TEXT } from "../../../lib/fcc_constants";
|
||||
|
||||
const exUsf = document.getElementById("pw-ex-usf") as HTMLInputElement;
|
||||
const exTrs = document.getElementById("pw-ex-trs") as HTMLInputElement;
|
||||
const exNanpa = document.getElementById("pw-ex-nanpa") as HTMLInputElement;
|
||||
const exLnp = document.getElementById("pw-ex-lnp") as HTMLInputElement;
|
||||
const exItsp = document.getElementById("pw-ex-itsp") as HTMLInputElement;
|
||||
const exExplWrap = document.getElementById("pw-ex-expl-wrap") as HTMLElement;
|
||||
const exExpl = document.getElementById("pw-ex-expl") as HTMLTextAreaElement;
|
||||
const gov = document.getElementById("pw-gov") as HTMLInputElement;
|
||||
const nfp = document.getElementById("pw-501c") as HTMLInputElement;
|
||||
const nd = document.getElementById("pw-nondisclosure") as HTMLInputElement;
|
||||
const ndText = document.getElementById("pw-nondisclosure-text") as HTMLElement;
|
||||
const filingType = document.getElementById("pw-filing-type") as HTMLSelectElement;
|
||||
const err = document.getElementById("pw-b6-err") as HTMLDivElement;
|
||||
const deminElection = document.getElementById("pw-demin-election") as HTMLSelectElement;
|
||||
const deminEstimate = document.getElementById("pw-demin-estimate") as HTMLElement;
|
||||
const deminBanner = document.getElementById("pw-demin-status-banner") as HTMLElement;
|
||||
const waiveReason = document.getElementById("pw-waive-reason") as HTMLTextAreaElement;
|
||||
const waiveReasonWrap = document.getElementById("pw-waive-reason-wrap") as HTMLElement;
|
||||
|
||||
ndText.textContent = NONDISCLOSURE_CERT_TEXT;
|
||||
|
||||
async function refreshDeMinimisEstimate() {
|
||||
const s = (window as any).PWIntake.get();
|
||||
const year = Number(s.intake_data?.form_year) || new Date().getUTCFullYear() - 1;
|
||||
const totalRev = Number(s.intake_data?.total_revenue_cents) || 0;
|
||||
const interPct = Number(s.intake_data?.interstate_pct) || 0;
|
||||
const intlPct = Number(s.intake_data?.international_pct) || 0;
|
||||
if (!totalRev) {
|
||||
deminEstimate.textContent = "— (enter revenue on the Revenue step first)";
|
||||
deminBanner.hidden = true;
|
||||
return;
|
||||
}
|
||||
// Quick estimate: contribution base × year factor. We fetch the
|
||||
// factor via the late-filing-estimate endpoint (convenient wrapper).
|
||||
try {
|
||||
const r = await fetch(
|
||||
`/api/v1/fcc/late-filing-estimate?year=${year}&total_revenue_cents=${totalRev}&interstate_pct=${interPct + intlPct}`,
|
||||
);
|
||||
if (!r.ok) throw new Error(`${r.status}`);
|
||||
const data = await r.json();
|
||||
const est = data.estimated_usf_cents;
|
||||
const isExempt = est < 1000000; // $10,000 threshold
|
||||
const nearThreshold = est < 1500000 && est >= 750000;
|
||||
deminEstimate.textContent = `$${(est / 100).toLocaleString("en-US", { minimumFractionDigits: 2 })}`;
|
||||
deminBanner.hidden = false;
|
||||
if (isExempt) {
|
||||
deminBanner.className = "pw-demin-banner pw-exempt";
|
||||
deminBanner.textContent = `✓ You qualify as de minimis. Your estimated $${(est/100).toFixed(2)} annual contribution is below the $10,000 threshold.`;
|
||||
} else if (nearThreshold) {
|
||||
deminBanner.className = "pw-demin-banner pw-near";
|
||||
deminBanner.textContent = `⚠ You're near the de minimis threshold. Small changes in interstate % could push you over — we recommend reviewing your traffic study carefully.`;
|
||||
} else {
|
||||
deminBanner.className = "pw-demin-banner pw-no-exempt";
|
||||
deminBanner.textContent = `You do NOT qualify as de minimis. Estimated $${(est/100).toFixed(2)} exceeds the $10,000 threshold.`;
|
||||
}
|
||||
} catch {
|
||||
deminEstimate.textContent = "— (could not reach server)";
|
||||
}
|
||||
}
|
||||
|
||||
deminElection.addEventListener("change", () => {
|
||||
waiveReasonWrap.hidden = deminElection.value !== "regular";
|
||||
});
|
||||
|
||||
function anyExempt() {
|
||||
return exUsf.checked || exTrs.checked || exNanpa.checked || exLnp.checked || exItsp.checked;
|
||||
}
|
||||
function updateExplVisibility() {
|
||||
exExplWrap.hidden = !anyExempt();
|
||||
}
|
||||
[exUsf, exTrs, exNanpa, exLnp, exItsp].forEach((cb) => cb.addEventListener("change", updateExplVisibility));
|
||||
nd.addEventListener("change", () => { ndText.hidden = !nd.checked; });
|
||||
|
||||
window.addEventListener("pw:step-shown", (evt: any) => {
|
||||
if (evt.detail.step !== "block6_cert") return;
|
||||
const s = (window as any).PWIntake.get();
|
||||
const d = s.intake_data || {};
|
||||
exUsf.checked = !!d.exempt_usf;
|
||||
exTrs.checked = !!d.exempt_trs;
|
||||
exNanpa.checked = !!d.exempt_nanpa;
|
||||
exLnp.checked = !!d.exempt_lnp;
|
||||
exItsp.checked = !!d.exempt_itsp;
|
||||
exExpl.value = d.exemption_explanation || "";
|
||||
gov.checked = !!d.is_state_local_gov;
|
||||
nfp.checked = !!d.is_tax_exempt_501c;
|
||||
nd.checked = !!d.nondisclosure_requested;
|
||||
filingType.value = d.filing_type || "original_april_1";
|
||||
deminElection.value = d.deminimis_election || "auto";
|
||||
waiveReasonWrap.hidden = deminElection.value !== "regular";
|
||||
waiveReason.value = d.waive_deminimis_reason || "";
|
||||
updateExplVisibility();
|
||||
ndText.hidden = !nd.checked;
|
||||
refreshDeMinimisEstimate();
|
||||
});
|
||||
|
||||
window.addEventListener("pw:step-next", (evt: any) => {
|
||||
const PW = (window as any).PWIntake;
|
||||
if (PW.steps[PW.get().step_index] !== "block6_cert") return;
|
||||
if (anyExempt() && !exExpl.value.trim()) {
|
||||
err.hidden = false; err.textContent = "Exemption claims require a written explanation."; evt.preventDefault(); return;
|
||||
}
|
||||
err.hidden = true;
|
||||
const election = deminElection.value;
|
||||
PW.patchIntakeData({
|
||||
exempt_usf: exUsf.checked,
|
||||
exempt_trs: exTrs.checked,
|
||||
exempt_nanpa: exNanpa.checked,
|
||||
exempt_lnp: exLnp.checked,
|
||||
exempt_itsp: exItsp.checked,
|
||||
exemption_explanation: exExpl.value.trim() || null,
|
||||
is_state_local_gov: gov.checked,
|
||||
is_tax_exempt_501c: nfp.checked,
|
||||
nondisclosure_requested: nd.checked,
|
||||
filing_type: filingType.value,
|
||||
deminimis_election: election,
|
||||
// If the filer explicitly elected "regular", mark is_deminimis false
|
||||
// and set the waive flag. If "deminimis", mark is_deminimis true.
|
||||
// "auto" leaves is_deminimis to be set by the server-side calc.
|
||||
is_deminimis: election === "regular" ? false : (election === "deminimis" ? true : undefined),
|
||||
waive_deminimis_reason: election === "regular" ? (waiveReason.value.trim() || null) : null,
|
||||
});
|
||||
// Expose waive flag on the top-level state so order creation reads it.
|
||||
const st = PW.get();
|
||||
PW.set({
|
||||
...st,
|
||||
waive_deminimis_exemption: election === "regular",
|
||||
waive_deminimis_reason: election === "regular" ? (waiveReason.value.trim() || null) : null,
|
||||
});
|
||||
});
|
||||
</script>
|
||||
Loading…
Add table
Add a link
Reference in a new issue