mrdata36/faidaplusApp

This App create for Small and Medium intrepreneurs in Tanzania # FaidaPlus - Business Management System FaidaPlus ni mfumo madhubuti wa usimamizi wa biashara ndogo na za kati (SMEs) nchini Afrika Mashariki, ulioundwa kwa kutumia **React 19 (Vite)** na **Node.js (Express) na SQLite**. --- ## 📌 Jinsi ya Kuiendesha Kwenye Kompyuta Yako (Local Setup Guide) Maudhui na muundo wa mfumo huu umepangwa kwa urahisi sana. Mteja (Frontend) yupo kwenye mzizi wa mradi (root folder), na huduma ya nyuma (Backend Server) ipo ndani ya folda la `/server`. Huna haja ya kwenda kwenye folda tofauti tofauti kufanya `npm install` na kuanzisha servers mbili tofauti! Unaweza kufanya kila kitu kutoka kwenye mzizi wa mradi kwa urahisi sana. ### Hatua ya 1: Pakua au Clone Mradi Hakikisha umepakua ZIP ya mradi huu kutoka AI Studio au umefanya clone kutoka GitHub kwenda kwenye kompyuta yako: ```bash git clone cd faidaplus ``` ### Hatua ya 2: Weka Mafaili ya Mazingira (.env) 1. Kwenye **mzizi wa mradi (root directory)**, nakili faili la `.env.example` na ulizipe jina jipya la `.env`: ```bash cp .env.example .env ``` 2. Kwenye folda la **`/server`**, nakili faili la `.env.example` na ulipe jina la `.env`: ```bash cp server/.env.example server/.env ``` *(Unaweza kufungua mafaili haya ya `.env` na kubadilisha siri kama `JWT_SECRET` au `PORT` kama utapenda).* ### Hatua ya 3: Weka Maktaba Zote (Install Dependencies) Kutoka kwenye **mzizi wa mradi (root directory)**, endesha amri ifuatayo ili kuweka maktaba zote za Frontend na Backend kwa pamoja. > 💡 **Kumbuka kuhusu ERESOLVE:** Kwa sababu mradi huu unatumia **React 19**, baadhi ya maktaba kama `lucide-react` au `recharts` zinaweza kutoa onyo la "conflicting peer dependency" (ERESOLVE). Tumeshaweka faili la `.npmrc` ili kutatua hili kiotomatiki, lakini ukipata hitilafu bado, tafadhali tumia amri hii: ```bash npm install --legacy-peer-deps ``` ### Hatua ya 4: Washa Mfumo (Run Development Server) Ili kuwasha mteja (React/Vite) na server (Express/SQLite) kwa wakati mmoja, endesha amri hii kwenye **mzizi wa mr …