# Project Cat — Handmade Bag Business (Digital)

Digital workspace for a custom bag / tote / pouch business.  
**Source of truth:** the wife’s PDF documentation. Everything else is derived from that.

---

## What this project is

| Piece | Role |
|--------|------|
| **8 base patterns** | Designs / constructions (Lowland Bum Bag, Square Boxed Pouch, Not So Bumbastic, Sandhill, Plover Pouch, Bumbastic, 241 Tote, Costa Tote) |
| **2 fabric versions** | Same pattern, different main fabric — not extra patterns |
| **Price book** | Material & hardware unit costs |
| **BOM** | Bill of materials per pattern (and size where needed) |
| **Tools** | Printable inventory + interactive cost / market calculator |

### Version model (important)

| Version | Main fabric | Sell price |
|---------|-------------|------------|
| **V1** | Canvas | Standard |
| **V2** | Waxed canvas | **Higher** (premium) |

- Accent fabric is priced at the **same unit rate** as main fabric.  
- Main fabric and exterior fabric are treated as the **same role**.  
- Every finished piece: **2 × $1 labels** + **$5 additional supplies**.  
- Market channel: **$45 table fee / weekend**.

---

## Quick start

### Entry point
**Double-click `index.html`** — studio home page with links to every tool and document.

### Customer vitrine (table + phone)
**`vitrine.html`** → deploy as **https://cat.mcwut.com**  
- Digital business card for the booth  
- QR code → `cat.mcwut.com`  
- Email **cat@mcwut.com**  
- Collection + custom orders blurb (FR/EN)  

Leave it open on a tablet; customers scan the QR to keep the same page on their phone.

### Market weekend (use this first)
1. **`Market_Weekend.html`** — stock, prices, orders, playbook  
2. **`Price_Tags.html`** — tags with what’s included  
3. **`PRICING_GUIDE.md`** — Val-David premium ranges  
4. Enter quantities → print tags → print order slips  

### Also available
1. **Master PDF** — `2780257459493577.pdf`  
2. **Verbatim pages** — `pages/`  
3. **MASTER_PROJECT.md** — rules & BOMs  
4. **Cost_Calculator.html** — material cost floors  
5. **Inventaire_Patrons_Imprimable.html** — pretty catalog  
6. **Liste_a_verifier.md** — open questions  

---

## File map

```
c:\vince\projectCat\
│
├── index.html                         ← ENTRY POINT (open this first)
├── vitrine.html                       ← customer storefront / virtual card (→ cat.mcwut.com)
├── Market_Weekend.html                ← stock, orders, playbook
├── Price_Tags.html                    ← printable tags + what’s included
├── PRICING_GUIDE.md                   ← V1/V2 sell ranges by template
├── README.md                          ← you are here
├── 2780257459493577.pdf               ← MASTER source (scanned PDF)
├── MASTER_PROJECT.md                  ← canonical written master + plan
├── pages\                             ← verbatim text of each PDF page
│   ├── README.md … page-01..09.md
│   └── ALL_PAGES_VERBATIM.md
│
├── Cost_Calculator.html               ← material cost floors
├── Inventaire_Patrons_Imprimable.html ← colorful printable catalog
│
├── data\
│   ├── materials.json                 ← price book (JSON)
│   ├── patterns.json                  ← 8 patterns metadata
│   └── bom\
│       └── all-boms.json              ← materials lists per pattern
│
├── Liste_a_verifier.md                ← open questions only
├── Sewing_Patterns_Inventory_Source.md← LEGACY (superseded draft)
│
├── 1.jpg … 6.jpg                      ← early notebook photos (reference)
```

---

## How the pieces fit together

```
┌─────────────────────────────┐
│  2780257459493577.pdf       │  Wife’s documentation (master)
└──────────────┬──────────────┘
               │ reviewed & digitized
               ▼
┌─────────────────────────────┐
│  MASTER_PROJECT.md          │  Human-readable rules + BOMs
│  data/*.json                │  Machine-readable patterns/prices/BOM
└──────────────┬──────────────┘
               │
       ┌───────┴────────┐
       ▼                ▼
 Cost_Calculator    Inventaire_…html
 (decisions)        (pretty print)
```

| If you want to… | Use… |
|-----------------|------|
| Know the official rule or BOM | PDF or `MASTER_PROJECT.md` |
| Build an app / script | `data/patterns.json`, `materials.json`, `bom/all-boms.json` |
| Price one bag or a market weekend | `Cost_Calculator.html` |
| Print a catalog for the studio | `Inventaire_Patrons_Imprimable.html` |
| Resolve leftover ambiguities | `Liste_a_verifier.md` |

---

## The 8 base patterns

| # | Pattern | Designer / notes |
|---|---------|------------------|
| 1 | **Lowland Bum Bag** | Lowland, altered (Adult + 2 extra 8″ zips) |
| 2 | **Square Boxed Pouch** | French matériel sheet; #5 zip only |
| 3 | **Not So Bumbastic Bag** | Smaller sibling of Bumbastic |
| 4 | **Sandhill Sling Bag** | Noodlehead · 3 m binding (hand note) |
| 5 | **Plover Pouch** | Noodlehead · sizes S / M / L *(earlier misread as “Small Flower”)* |
| 6 | **Bumbastic Bag** | Larger hipster · 3 zippers |
| 7 | **241 Tote** | Noodlehead · magnetic snap optional |
| 8 | **Costa Tote Bag** | 1 m main + 1 m lining · 48″ webbing · 8″ zip |

Versions (canvas / wax) **do not** add to the count of 8.

---

## Cost calculator — how it works

### Single bag cost
1. Choose **pattern**, **size** (if any), **V1 or V2**.  
2. Toggle **options** when relevant (e.g. 241 accent fabric, Sandhill snap vs zip).  
3. Read:
   - **Line items** — fabric, lining, binding, zippers, hardware, labels, +$5  
   - **Unit cost**  
   - **Suggested sell** = cost × markup (default **2.5**), or type a fixed sell price  
   - **Gross profit** and **margin %**

### Compare all patterns
- Same defaults for all 8.  
- Plover comparison uses **Medium**.  
- Change markup and click **Refresh**.

### Market weekend
1. Enter **qty V1** and/or **qty V2** per pattern.  
2. Table fee defaults to **$45**.  
3. **Calculate weekend** shows:
   - Units packed  
   - Total inventory cost  
   - Revenue if everything sells at suggested markup  
   - Fee per unit  
   - Net profit if sell-out  

**Note:** Suggested sell is a helper, not a locked retail list. Set real sell prices in `Liste_a_verifier.md` when ready.

### Pricing estimates inside the calculator
Taken from the master price book where possible:

| Input | How it’s used |
|--------|----------------|
| Canvas | $15 / ½ m → **$30 / m** |
| Waxed canvas | $20 / ½ m → **$40 / m** |
| Quilting cotton lining | **$18 / m** |
| Cotton binding | $1.25 / ½ m → **$2.50 / m** |
| Cotton webbing | **$2.50 / m** |
| Zipper bulk | $25 / 10 yd → piece cost by length |
| Hardware | **$1.50** each |
| Labels + supplies | **$2 + $5** every bag |

Fat quarters, fleece, and some interfacing cuts are **estimates**. Adjust if real purchases differ.

---

## Structured data (`data/`)

For future apps, spreadsheets, or scripts:

| File | Contents |
|------|----------|
| `patterns.json` | Pattern ids, names, designers, sizes, PDF sheet # |
| `materials.json` | Fabrics, bulk goods, hardware, overhead, channel fee |
| `bom/all-boms.json` | Quantities per pattern (and Plover sizes) |

The HTML calculator **embeds** equivalent logic so it runs without a server. If you change JSON for a real app, update the calculator (or load JSON via a local server) to stay in sync.

---

## What is *not* the master

| File | Status |
|------|--------|
| `1.jpg`–`6.jpg` | Early notebook photos — useful history, incomplete |
| `Sewing_Patterns_Inventory_Source.md` | **Legacy** draft from photos; superseded by the PDF |

If anything conflicts: **PDF → MASTER_PROJECT.md → tools**.

---

## Suggested workflow

1. **Confirm** open items in `Liste_a_verifier.md` (especially sell prices and label rules).  
2. **Cost** samples in `Cost_Calculator.html` (V1 vs V2).  
3. **Plan** a market weekend with quantities and the $45 fee.  
4. **Print** inventory cards for the sewing table.  
5. Later: hook `data/*.json` into a spreadsheet or small inventory app if needed.

---

## Print tips

- Open the HTML file in **Chrome, Edge, or Brave**.  
- `Ctrl + P` → turn **on** “Background graphics” / “Background colors”.  
- Paper: Letter or A4.

---

## Source & branding notes

- **All pieces are unique and professional.**  
- Branding: commercial label (if used) + custom “my label”.  
- Master scanned document dated around **July 18–19, 2026**.  
- Digital files live under `c:\vince\projectCat\`.

---

*For full BOM detail, conflicts resolved by the PDF, and the digitalization checklist, see [MASTER_PROJECT.md](MASTER_PROJECT.md).*