# HRIH Investments — Membership Platform Build
## Freelance Developer Brief

**Project type:** Backend integration + deployment of an existing, fully-designed frontend
**Estimated scope:** 20–30 hours
**Budget guidance:** R8,000 – R18,000 (or $450–$1,000 USD equivalent), negotiable based on experience
**Timeline:** 2–3 weeks
**Start:** Immediate

---

## 1. What This Project Is

HRIH Investments is a South African management consulting firm. We have designed and built a **complete, pixel-perfect frontend** for a membership platform — including the public website, 3-tier membership pages, digital marketplace, member dashboard, and a full back-office CRM. All of this exists as working HTML/CSS/JS files.

**What we need:** A developer to connect this frontend to a real backend so it functions as a live, production platform — handling real user accounts, real payments, real emails, and real WhatsApp messages.

This is **not** a design job and **not** a "build from scratch" job. The UI is done. We need the wiring.

---

## 2. What's Already Built (Provided to You)

You will receive three files:

1. **`hrih-membership-platform.html`** — the desktop web app (public site, membership tiers, marketplace, member dashboard, back-office CRM with 15 functional panels)
2. **`hrih-mobile-app.html`** — a mobile-optimized PWA version with onboarding, auth screens, and bottom-tab navigation
3. **`hrih-backend-setup.html`** — a complete technical specification including:
   - Full PostgreSQL/Supabase database schema (ready to run, 12 tables)
   - Row Level Security policies (ready to run)
   - 4 working Edge Function templates (PayFast webhook, WhatsApp sender, email sender, Google Drive sync)
   - Environment variable list
   - Integration setup links for every third-party service

**This means most of the hard design and architecture decisions are already made.** Your job is implementation, not invention.

---

## 3. Scope of Work

### Phase 1 — Backend Foundation
- [ ] Create and configure Supabase project
- [ ] Run provided database schema + RLS policies
- [ ] Set up Supabase Auth (email/password + Google OAuth)
- [ ] Create Storage buckets for products, invoices, avatars, uploads
- [ ] Wire the frontend's static HTML to Supabase client (replace dummy data with real queries)

### Phase 2 — Payments
- [ ] Integrate PayFast for ZAR subscription billing (3 tiers: R499 / R1,499 / R3,999 monthly + annual)
- [ ] Build PayFast webhook handler (provided template — needs deployment + testing)
- [ ] Optional: Stripe integration for international clients
- [ ] Test full payment → membership activation flow end-to-end

### Phase 3 — Communications
- [ ] Connect SendGrid for transactional + bulk email sending from hilton@hrihinvestments.co.za
- [ ] Set up domain authentication (SPF/DKIM/DMARC) for deliverability
- [ ] Connect WhatsApp Business API via 360dialog or Twilio (we'll handle the application; you handle the integration)
- [ ] Build out invoice/quote PDF generation and email/WhatsApp delivery

### Phase 4 — Marketplace Features
- [ ] Build the product management CRUD (create/edit/archive products in back-office)
- [ ] Implement the web scraper feature (ScraperAPI integration — pull products from a URL into inventory)
- [ ] Implement Google Drive folder sync (list files from a shared folder, add as products)
- [ ] Implement file upload (ZIP, PDF, video, docs) to Supabase Storage with product publishing
- [ ] Build secure download/access gating by membership tier

### Phase 5 — CRM Functionality
- [ ] Member management (add/edit/invite members, tier assignment)
- [ ] Quotes → Invoice conversion workflow
- [ ] Leads pipeline (kanban-style stages)
- [ ] Dashboard metrics (MRR, member count, outstanding invoices) — calculated from real data
- [ ] Session booking system (calendar-based, syncs with Hilton's calendar — Calendly integration acceptable)

### Phase 6 — Deployment & Handover
- [ ] Deploy to Vercel or Netlify with custom domain (members.hrihinvestments.co.za)
- [ ] Set all environment variables/secrets securely
- [ ] Full QA pass: signup → payment → product access → email → WhatsApp
- [ ] Write brief handover documentation (how to add products, how to manage members)
- [ ] 14-day post-launch bug-fix support window included in quote

---

## 4. What We're NOT Asking For

To be clear about scope (please don't quote for these unless we discuss separately):
- We are **not** asking you to redesign any UI — it is final
- We are **not** asking for a native iOS/Android app — the PWA approach is sufficient for now
- We are **not** asking you to write marketing copy or content
- Social media auto-posting (Meta/LinkedIn/Instagram) integrations are **nice-to-have**, not required for launch — quote them as optional add-ons

---

## 5. Technical Stack (Already Decided)

| Layer | Technology |
|---|---|
| Frontend | Static HTML/CSS/JS (provided) |
| Hosting | Vercel or Netlify |
| Database/Auth/Storage | Supabase (PostgreSQL) |
| Payments (SA) | PayFast |
| Payments (Intl, optional) | Stripe |
| Email | SendGrid + Zoho Mail (domain) |
| WhatsApp | 360dialog or Twilio WhatsApp Business API |
| File sync | Google Drive API |
| Web scraping | ScraperAPI |

If you have strong technical reasons to recommend a different tool for any layer, we're open to hearing it — but please flag this clearly in your proposal rather than silently substituting.

---

## 6. What We Need From You In Your Proposal

1. Confirmation you've reviewed all three provided files
2. Your relevant experience: Supabase, PayFast/Stripe integration, WhatsApp Business API, any prior membership/SaaS platform builds
3. A breakdown of hours/cost per phase above
4. Your estimated timeline
5. Whether you can start immediately
6. Links to 2–3 relevant past projects (membership sites, CRMs, or payment integrations)

---

## 7. Budget & Payment Terms

- **Total budget range:** R8,000 – R18,000 (or USD equivalent) depending on experience level and whether Stripe/social integrations are included
- **Payment structure:** 30% upfront on contract signing, 40% on completion of Phase 1–3 (foundation, payments, communications), 30% on final delivery and handover
- Payment via EFT (South African developers) or agreed international method

---

## 8. About HRIH Investments

HRIH Investments (Pty) Ltd is a management consulting firm based in Swellendam, Western Cape, South Africa, founded by Hilton Hartnick. The firm has operated for 15+ years, serving 500+ clients across bookkeeping, accounting, company secretarial, trust administration, and strategic consulting. This platform represents an expansion into membership-based digital products and consulting delivery.

**Contact:** Hilton Hartnick
**Phone/WhatsApp:** +27 61 077 6410
**Website:** hrihinvestments.web.za
**Company Reg:** 2015/036586/07

---

## 9. How to Apply

Please respond with your proposal covering the points in Section 6. If shortlisted, we'll share the three reference files (membership platform, mobile app, backend spec) and schedule a 20-minute call to walk through scope before final contracting.

We're looking to start within the next 1–2 weeks.
