# Stratos Tech — Test Portal

> Multi-exam licensing prep platform.
> Live at: **https://exams.stratostech.ai** (Cloudflare Pages + Cloudflare Access)

A self-hosted, single-operator SaaS-grade test prep portal. Built as the production successor to ad-hoc HIC practice exams, scaled to cover every license and certification in the empire pillar pursuit list.

## Active Exam Modules

| Exam | Status | Versions Built | Source Material Status |
|------|--------|---------------|------------------------|
| **HIC** — Virginia Home Improvement Contractor | LIVE | v2 / v3 / v3.1 / v4 / v5 / smoke drill | 2021 IRC + OSHA 1926 + VA DPOR (local) |
| **CIC** — Virginia Commercial Improvement Contractor | LIVE | v1 (15Q) | 2021 IBC + ANSI A117.1 + ACI 318 (queued) |
| **Series 3** — National Commodities Futures Exam | LIVE | v1 (15Q) | NFA Series 3 study guide (queued) |
| **Series 30** — NFA Branch Manager Exam | LIVE | v1 (15Q) | NFA Series 30 study guide (queued) |
| **Real Estate** — Virginia Real Estate Salesperson | LIVE | v1 (15Q) | VA REB Candidate Handbook (queued) |

## Architecture

- **Frontend:** Static HTML / vanilla JS / CSS (zero framework)
- **Auth:** Cloudflare Access (production) + first-run password fallback (local)
- **Storage:** localStorage (per-exam state) + sessionStorage (auth) + IndexedDB (auto-save folder handle)
- **Hosting:** Cloudflare Pages (Git-based auto-deploy)
- **Custom Domain:** `exams.stratostech.ai`

## Repo Structure

```
stratostech-test-portal/
├── index.html                 # Login + dashboard hub
├── source-materials.html      # PDF manual / reference browser
├── PRD.md                     # Product requirements
├── README.md                  # ← you are here
├── DEPLOY.md                  # Cloudflare Pages deploy guide
├── BRAIN.md                   # Live project state
├── HANDOFF.md                 # Cross-session handoff
├── ROADMAP.md                 # Phase plan
├── history.md                 # Build journal
├── CLAUDE.md                  # Operating instructions for Claude
├── memory/                    # Typed memory files (user, project, feedback, reference)
├── assets/
│   ├── styles.css             # Design system
│   └── logo.svg               # Stratos Tech mark
├── js/
│   ├── auth.js                # Cloudflare Access + password gate
│   ├── results-parser.js      # Parses .md result files
│   └── dashboard.js           # Stats + history + trajectory chart
├── exams/
│   ├── hic/                   # Virginia HIC tests
│   ├── cic/                   # VA CIC tests
│   ├── series3/               # NFA Series 3 tests
│   ├── series30/              # NFA Series 30 tests
│   └── real_estate/           # VA Real Estate tests
├── results/
│   ├── hic/, cic/, series3/, series30/, real_estate/
│   └── _index.json (per folder, lists result MDs)
├── source_material/           # LOCAL ONLY — gitignored — PDF manuals
│   ├── hic/, cic/, series3/, series30/, real_estate/
│   └── INDEX.md per folder (committed; metadata only)
├── _headers                   # Cloudflare Pages headers
├── _redirects                 # Cloudflare Pages redirects
├── 404.html                   # Custom 404
├── .gitignore                 # Excludes copyrighted source material
└── .gitattributes             # Line-ending discipline
```

## Local Development

```bash
# From repo root
python3 -m http.server 8080
# Open http://localhost:8080/
# First run: choose your portal password (4+ chars) → land on dashboard
```

## Deploy

See **DEPLOY.md** — Cloudflare Pages Git integration, custom domain, Cloudflare Access setup.

## License

Proprietary — © Michael A. Howard / Stratos Tech.
The exam content is original prep material derived from publicly published exam content outlines (PSI, NFA, VREB).
Source PDFs in `source_material/` are NOT distributed and remain property of their respective publishers (ICC, PSI, NFA, VREB).