An internal reference project to help a T-Mobile employee better service customers. Phase 1 (this repo) is a structured data log of T-Mobile plans, pricing, discounts, stackability rules, promotions, and the tools/APIs/resources available. Phase 2 is a plan calculator that recommends the best plan + discount stack for a customer.
⚠️ Disclaimer: Pricing and promotions change frequently. Every figure here is sourced and date-stamped, but must be re-verified against official T-Mobile systems before quoting a customer. This repo aggregates publicly available information only. Do not store customer PII or CPNI here.
calculator/ The SOC Calculator web app (add-a-line cost + promo-survival checker) — open calculator/index.html
data/ Structured, machine-readable data (JSON) — the source of truth for the calculator
docs/ Human-readable reference notes by topic (markdown)
research/ Raw sourced research reports gathered during Phase 1
Open calculator/index.html in a browser. Two functions, both CPNI-free (they work on plan/promo codes
and rules, never customer data):
- Add-a-Line Cost — what an added voice/watch/tablet/hotspot line costs.
- Promo Survival — whether a free-line credit stays free if a line is cancelled.
It's driven by an editable SOC Library you populate from soc.quest / internal
tools. See calculator/README.md.
| Area | File |
|---|---|
| Consumer postpaid plans | docs/01-consumer-postpaid-plans.md |
| Discounts & stackability | docs/02-discounts-and-stackability.md |
| Promotions & device deals | docs/03-promotions-and-device-deals.md |
| Prepaid, Metro, Home Internet | docs/04-prepaid-metro-home-internet.md |
| Business plans | docs/05-business-plans.md |
| Tools, APIs & resources | docs/06-tools-apis-resources.md |
| Calculator viability assessment | docs/07-calculator-viability.md |
| Machine-readable plan data | data/plans.json |
Phase 1 — data gathering. See docs/07-calculator-viability.md for the feasibility
assessment and recommended next steps.