# GC Platform

> *A Cozy Home for Improvement* — the unified AI toolkit of the **GC Toastmasters Club**.

A static, file://-friendly web platform that bundles six handcrafted tools for the Greater China Toastmasters chapter. Open `index.html` in any modern browser — no server, no build step, no dependencies to install.

---

## ✦ Project Overview

**GC Platform** brings together every micro-tool the club uses around a single editorial homepage. Three tools are live today, three are forthcoming. Everything is pure HTML / CSS / vanilla JavaScript, optimized for offline use and one-click hosting.

| # | Tool | Function | Entry Point | Status |
|---|------|----------|-------------|--------|
| 01 | **会议纪要生成器** / Meeting Minutes Generator | Generates beautiful HTML meeting recaps from structured JSON. | `meeting-generator/index.html` | 🟢 Live |
| 02 | **数据看板** / Data Dashboard | Visual analytics over 18 meetings (attendance, roles, awards, growth). | `dashboard/index.html` | 🟢 Live |
| 03 | **海报生成器** / Poster Generator | One-click PNG export of branded meeting posters with 3 templates. | `poster-generator/index.html` | 🟢 Live |
| 04 | **AI 跟读工具** / AI Reading Assistant | Spaced-repetition + browser speech recognition. | — | 🟡 Coming Soon |
| 05 | **GC 知识库** / GC Knowledge Base | Semantic Q&A bot over 18 issues of meeting minutes. | — | 🟡 Coming Soon |
| 06 | **读书工具** / Reading Tools | Audio/video utilities for the GC Book Club. | — | 🟡 Coming Soon |

---

## ✦ Quick Start

The fastest path: **double-click `index.html`** in File Explorer. It loads in any browser via the `file://` protocol with zero configuration.

```bash
# Or, if you prefer a CLI:
cd gc-platform
start index.html      # Windows
open  index.html      # macOS
xdg-open index.html   # Linux
```

That's it. No `npm install`, no Python server, no Node.

---

## ✦ Deployment Options

Choose whichever fits your environment. Detailed steps for each are in [`DEPLOY.md`](./DEPLOY.md).

1. **Local** — open `index.html` directly. Works offline, perfect for sharing as a zip.
2. **Nginx** — copy `deploy/nginx.conf` and run `deploy/deploy.sh` on Linux/Mac.
3. **GitHub Pages** — push the folder to a repo, enable Pages on the `main` branch.
4. **Static hosts** — Vercel, Netlify, Cloudflare Pages: drag-and-drop deploy.

---

## ✦ Directory Structure

```
gc-platform/
├── index.html                  # Unified navigation homepage
├── meeting-generator/          # Tool 01 — Meeting Minutes Generator
│   └── index.html
├── dashboard/                  # Tool 02 — Data Dashboard
│   └── index.html
├── poster-generator/           # Tool 03 — Poster Generator
│   └── index.html
├── assets/
│   ├── css/
│   │   └── shared.css          # GC brand design system (vars, cards, grids)
│   ├── js/
│   │   └── shared-utils.js     # Cross-tool helpers (toast, debounce, copy …)
│   └── images/
│       └── icons/              # 6 inline SVG icons (one per tool)
├── deploy/
│   ├── nginx.conf              # Nginx site configuration
│   ├── deploy.sh               # Linux/Mac deploy script
│   └── deploy.bat              # Windows packaging script
├── docs/
│   ├── README.md               # ← you are here
│   ├── DEPLOY.md               # Deployment guide
│   └── CHANGELOG.md            # Version history
├── extract-data.js             # Phase-1 HTML → JSON extractor
└── build-js-data.js            # Wraps JSON as window.MEETINGS_DATA
```

---

## ✦ Tech Stack Notes

- **HTML5 / CSS3 / Vanilla JS** — no frameworks, no transpilers.
- **Typography** — Fraunces (display serif) + Inter Tight (sans) + JetBrains Mono.
- **Charts** — ECharts (loaded from CDN inside the dashboard).
- **Image export** — html2canvas (loaded inside the poster generator).
- **Design tokens** — defined in `assets/css/shared.css` under `:root`.
- **Browser support** — modern Chromium / Firefox / Safari / Edge (last 2 versions).
- **Offline first** — every page renders fully without network access.

### Design tokens

```css
--gc-red:        #8B0000   /* primary crimson */
--gc-red-light:  #c41e3a
--gc-gold:       #e8c97a   /* warm accent  */
--gc-ivory:      #faf6ef   /* paper */
--gc-text:       #333333
--gc-radius:     16px
--gc-shadow:     0 4px 15px rgba(0,0,0,0.1)
```

---

## ✦ Credits

- **Author** — GC AI Guy · *Warren YUE*
- **Club** — GC Toastmasters Club (Greater China Chapter)
- **License** — Internal use within the GC community.
- **Built** — May 2026 · v1.0.0

> *"We did not build a platform. We built a cozy room — with warm lamps, a long oak table, and seventeen chairs that remember every voice that ever spoke into the night."*