Where capital ignites — full-stack investor-entrepreneur capital network for Botswana
# 🔥 Capital Pyre
**Where capital ignites.**
*The investor-entrepreneur capital network built for Botswana's next generation of business.*
---
## What is Capital Pyre?
Capital Pyre is a full-stack web platform that connects **entrepreneurs**, **SMEs**, and **investors** — bridging the gap between Botswana's ~20,000 SMEs and the institutional capital seeking to fund them.
| Layer | What it does |
|---|---|
| **Matchmaking** | Smart algorithm scores investor-entrepreneur compatibility across 5 dimensions |
| **Capital Readiness Score (CRS)** | 0–100 rating that tells investors exactly how fundable a business is |
| **Deal Room** | Secure document exchange, NDA management, and step-by-step deal stage tracking |
| **Bond Pools** | Pools of vetted SMEs structured into BSE-listed bond instruments |
| **Real-time Messaging** | Socket.IO chat between matched parties, live notifications |
---
## Architecture
```
capitalpyre/
├── backend/ Node.js + Express REST API (MySQL, JWT, Socket.IO)
├── frontend/ React 18 + Vite + Tailwind CSS
├── scoring/ Python 3.12 + FastAPI — Capital Readiness Score engine
├── db/ MySQL schema (17 tables) + seed data
├── nginx/ Reverse proxy (rate limiting, SSL, WebSocket)
└── docker-compose.yml All 6 services orchestrated
```
The backend is adapted from the **IAMS** (Industrial Attachment Management System) — a production-quality Node.js/Express/MySQL codebase. Its auth middleware, matching algorithm, logbook system, notifications, and file upload patterns were directly inherited and extended.
---
## Tech Stack
| Service | Technology |
|---|---|
| Frontend | React 18, Vite, Tailwind CSS, Redux Toolkit, TanStack Query, Socket.IO Client |
| Backend | Node.js 20, Express.js, mysql2, jsonwebtoken, bcryptjs, multer, nodemailer, Socket.IO |
| Scoring | Python 3.12, FastAPI, Uvicorn, Pydantic |
| Database | MySQL 8.0 — 17 tables, InnoDB, performance-indexed |
| Cache / RT | Red …