The complete operating system for Nigeria's construction and building materials ecosystem β AI-powered SaaS platform
# BuildPro Nigeria ποΈ
> The complete operating system for Nigeria's construction and building materials ecosystem.
## π Features
### 16 Core Modules
1. **Authentication** β Register, Login, OTP, MFA, RBAC
2. **Company Management** β Profile, Branches, Staff, Permissions, Audit Logs
3. **Inventory ERP** β Products, Categories, Warehouses, Low Stock Alerts, Barcode/QR
4. **Procurement** β RFQ, Supplier Quotes, Approval Workflow, Purchase Orders
5. **Marketplace** β Supplier Stores, Verified Listings, Ratings, Live Availability
6. **Live Price Index** β Daily prices for 11+ materials, Historical Charts, Alerts
7. **AI Assistant** β BOQ Reader, Cost Estimator, Supplier Recommendations
8. **CRM** β Customer Database, Sales Pipeline, Invoices, Quotes
9. **Finance** β P&L, Balance Sheet, Cashbook, Tax Reports
10. **Payments** β Online Payments, Wallet, Escrow, Subscription Billing
11. **Logistics** β Truck Booking, GPS Tracking, Driver Management, Delivery Cost Calc
12. **Supplier Trust Score** β Verification, Ratings, Delivery Success Rate
13. **Analytics** β Sales, Inventory, Revenue Dashboards, Demand Forecasting
14. **Documents** β Invoices, POs, Delivery Notes, PDF Export
15. **Communication** β Internal Messaging, Notifications, Email, SMS, WhatsApp
16. **Admin Panel** β User Management, Verification, Moderation, Reports
## π Tech Stack
- **Frontend**: Next.js 14, React 18, TypeScript, Tailwind CSS
- **Backend**: Next.js API Routes (Node.js)
- **Database**: MongoDB + Mongoose
- **Auth**: NextAuth.js (JWT)
- **AI**: Anthropic Claude API
- **Charts**: Recharts
- **PWA**: next-pwa (offline support, installable)
- **Payments**: Paystack (configurable)
## π Prerequisites
- Node.js 18+
- MongoDB (local or MongoDB Atlas)
- npm or yarn
## β‘ Quick Start
### 1. Install Dependencies
```bash
npm install
```
### 2. Environment Setup
```bash
cp .env.example .env.local
```
Edit `.env.local` with your values:
```env
MONGODB_URI=mongodb://localhost:27017/buildpro_nigeria
N β¦