Smilo-dev2022/Nzima-Admin-AI

# Nzima-Admin-AI Nzima-Admin-AI is a multi-platform admin and business management solution for African SMEs, powered by AI, with support for web, mobile, and backend integrations. --- ## Architecture ```mermaid graph TD A[Web - React.js] --> B[Backend - Node.js/Express] C[Mobile - React Native] --> B B --> D[Database - Firebase] B --> E[AI - OpenAI] B --> F[Payment - PayFast] ``` --- ## Project Structure ``` Nzima-admin-AI/ │ README.md # Main project documentation │ ├── backend/ # Node.js/Express backend (API, AI, payments) ├── web/ # React.js web frontend ├── mobile/ # React Native mobile app ├── shared/ # Shared logic (e.g., Firebase config, AI services) ├── firebase/ # Firebase service account/config │ └── my-web-app/ # (Optional) Simple HTML/CSS/JS starter app ├── README.md ├── src/ └── ... ``` --- ## Getting Started 1. **Clone the repository:** ```sh git clone cd Nzima-admin-AI ``` 2. **Setup environment variables:** - Create a `.env` file in `/backend` with your secrets (MongoDB/Firebase/OpenAI/PayFast keys). 3. **Install dependencies:** - Backend: ```sh cd backend npm install ``` - Web: ```sh cd ../web npm install ``` - Mobile: ```sh cd ../mobile npm install ``` 4. **Run the backend server:** ```sh cd backend npm start ``` 5. **Run the web frontend:** ```sh cd ../web npm start ``` 6. **Run the mobile app:** ```sh cd ../mobile npx react-native run-android # or run-ios ``` --- ## Features - **AI Document Generation** (OpenAI GPT-4) - **Business Health Dashboard** - **Payments & Wallet** (PayFast, Vouchers, Airtime) - **Compliance Engine** (CIPC, SARS, etc.) - **Multi-platform** (Web, Mobile) - **African Localization** (ZAR, tax, languages) --- ## Implementation Notes - **AI Integration:** Uses OpenAI GPT-4 for document generation, with caching and rate limiting. - **Mu …