# Jinsi ya kupakia mfumo kwenye cPanel (hatua kwa hatua)

Mfumo huu ni web app ya kisasa. cPanel HAIWEZI kuendesha code ya `src/`.
Kwa hiyo tumeandaa folda moja tayari (imeshajengwa) inayoitwa:

```
cpanel-build/
```

**Hiyo ndiyo folda pekee unayohitaji.** Kila kilichomo kinaenda kwenye `public_html`.

---

## HATUA 1 — Pata faili

1. Download ZIP ya project (GitHub → Code → Download ZIP, au Lovable → Download codebase).
2. Fungua (extract) ZIP kwenye kompyuta yako.
3. Ingia ndani ya folda `cpanel-build`.

Ndani yake utaona:

```
index.html        <- ukurasa mkuu
.htaccess         <- muhimu sana (huficha 404 unapo-refresh)
assets/           <- code na mitindo ya mfumo
favicon.ico
robots.txt
mailer/           <- kwa ajili ya email ya "Nimesahau nenosiri"
```

> `.htaccess` ni faili lililofichwa. Kwenye Windows washa **View → Hidden items**,
> kwenye Mac bonyeza **Cmd + Shift + .** ili ulione. LAZIMA lipande pia.

## HATUA 2 — Pakia kwenye cPanel

1. Ingia cPanel → **File Manager** → fungua `public_html`.
2. Futa faili za zamani zilizoshindikana (mfano `src`, `package.json`, `vite.config.ts` n.k.).
   Hizo si za kupakia — ndio maana web haikusoma.
3. Bonyeza **Settings** (kulia juu) → weka alama **Show Hidden Files (dotfiles)** → Save.
4. Bonyeza **Upload** kisha pakia **vilivyomo NDANI ya `cpanel-build`** (siyo folda yenyewe).
   - Njia rahisi: compress vilivyomo ndani ya `cpanel-build` kuwa `site.zip`,
     upload `site.zip` kwenye `public_html`, kisha bonyeza **Extract**, halafu futa `site.zip`.
5. Hakikisha `index.html` ipo moja kwa moja ndani ya `public_html`
   (SIYO `public_html/cpanel-build/index.html`).

## HATUA 3 — Jaribu

Fungua `https://wamakindamicrofinanceltd.com/`
- Ukurasa wa kuingia unatakiwa kuonekana.
- Username: `admin#` , Password: `kisesa@123`
- Nenda `/app`, kisha bonyeza **Refresh** — kama haitoi 404, `.htaccess` inafanya kazi.

Kama unaona 404 baada ya refresh: `.htaccess` haikupanda, au `mod_rewrite`
haijawashwa — mwambie support wa hosting aiwashe.

## HATUA 4 — Email ya "Nimesahau nenosiri" (hiari)

1. Ndani ya `public_html/mailer/` fungua `send-mail.php` (Edit) kisha jaza:
   - `$SMTP_HOST` = `mail.wamakindamicrofinanceltd.com`
   - `$SMTP_PORT` = `465`
   - `$SMTP_USER` = `info@wamakindamicrofinanceltd.com`
   - `$SMTP_PASS` = nenosiri la email hiyo
   - `$AUTH_TOKEN` = neno lako la siri (mf. `wamakinda-2026-siri`)
2. Fungua `public_html/mailer/token.txt` weka **neno lile lile** la `$AUTH_TOKEN`, kisha Save.
3. Ndani ya mfumo: **Mipangilio → Akaunti ya Admin** weka email yako, Save.
4. Sasa ukibonyeza "Nimesahau nenosiri" utapokea msimbo wa tarakimu 6 kwenye email.

## HATUA 5 — Unapobadilisha kitu

Kila ukibadilisha mfumo hapa Lovable, download ZIP mpya na rudia HATUA 2
(pakia vilivyomo ndani ya `cpanel-build` upya, ukibadilisha vya zamani).

---

### Vidokezo
- Data zote (wafanyakazi, mahudhurio, payroll, malipo) zinahifadhiwa kwenye kifaa
  cha mtumiaji — mfumo unafanya kazi hata bila intaneti.
- Usifute folda `assets/` — bila hiyo mfumo hauonekani.
- Kama ungependa kuweka mfumo kwenye sub-folder (mf. `public_html/hr`),
  niambie ili nikutengenezee toleo maalum, kwa sababu njia za `assets` zinaanza na `/`.