Documentation v1.0

Times FM System

User Manual — Mwongozo Kamili wa Matumizi

Toleo 1.0 (Mei 2026)
Aina Mtumiaji Mwisho
Jukwaa Web (Yii2 + Bootstrap 5 + JavaScript + Mysql)

TimesFM © 2026. Haki zote zimehifadhiwa.

Jedwali la Yaliyomo

Orodha ya mada zilizomo katika mwongozo huu.

  1. Utangulizi wa Mfumo3
  2. Kuanza Kutumia (Getting Started)4
  3. Dashibodi (Dashboard)6
  4. Usimamizi wa Vituo vya Mtandao (Live Channels)8
  5. Usimamizi wa Watumiaji (Users)11
  6. Wasifu na Kubadilisha Nenosiri14
  7. Kubadilisha Mandhari (Theme Toggle)16
  8. Usalama na Vidokezo17
  9. Kutatua Matatizo (Troubleshooting)18

1. Utangulizi wa Mfumo

1.1 Mfumo ni Nini?

Times FM System ni mfumo wa usimamizi wa vituo vya mtandao (live streaming channels) unaowaruhusu wasimamizi kudhibiti vituo vya redio/mtandao, kufuatilia hali ya utangazaji, na kusimamia watumiaji wanaotumia mfumo huo.

1.2 Sifa Kuu

1.3 Watumiaji na Majukumu

JukumuMaelezoHaki
AdministratorMsimamizi mkuu wa mfumoHaki zote (kusoma, kuunda, kuhariri, kufuta)
OwnerMmiliki wa mfumoHaki zote za usimamizi
UserMtumiaji wa kawaidaHawezi kufikia admin, anaweza kuwa wa siku zijazo

ⓘ Kumbuka

Matumizi ya mfumo yanahitaji kuwa na akaunti iliyosajiliwa na kuwa na jukumu la Administrator au Owner ili kufikia sehemu za usimamizi.

2. Kuanza Kutumia (Getting Started)

2.1 Kuingia kwenye Mfumo (Login)

Anza kwa kufungua kivinjari (browser) na kwenda kwenye URL ya mfumo.

1

Fungua kivinjari

Fungua Chrome, Firefox, Edge, au Opera na uende kwenye anwani ya mfumo (mfano: https://timesfm.tz).

2

Bofya "Login"

Kwenye ukurasa wa mwanzo, tafuta kitufe cha Login kwenye upande wa juu kulia wa ukurasa na ubofye.

3

Ingiza Vitambulisho vyako

Jaza Username na Password ulizopewa na msimamizi au ulizojisajili. Kisha bofya Login.

4

Kuingia kwa Mafanikio

Ukishafanikiwa kuingia, utaelekezwa moja kwa moja kwenye Dashibodi ya Usimamizi (Admin Dashboard).

⚠ Tahadhari

Hakikisha unatoka kwenye mfumo (Logout) ukimaliza kazi, hasa kama unatumia kompyuta ya umma au ya pamoja.

2.2 Kutoka kwenye Mfumo (Logout)

Bofya jina lako la mtumiaji kwenye upande wa juu kulia wa ukurasa, kisha chagua Logout. Utatolewa kwenye mfumo na kurudishwa kwenye ukurasa wa mwanzo.

3. Dashibodi (Dashboard)

3.1 Muonekano wa Dashibodi

Dashibodi ndio ukurasa wa kwanza unaouona baada ya kuingia kwenye mfumo. Una sehemu kuu tatu:

● Hali ya Mfumo (System Status)

Kadi ya kwanza inaonesha kama mfumo uko LIVE (kijani) au OFFLINE (nyekundu) kulingana na kama kuna chaneli inayotangaza kwa sasa.

● Jumla ya Vituo (Total Channels)

Kadi ya pili inaonesha idadi ya vituo vyote vilivyosajiliwa kwenye mfumo.

● Vitendo vya Haraka (Quick Actions)

Kadi ya tatu ina viungo vya haraka vya kwenda kwenye sehemu muhimu za usimamizi:

3.2 Chati ya Shughuli (Channel Activity Log)

Chini ya dashibodi kuna jedwali linaloonyesha vituo vyote pamoja na taarifa zake:

ColumnMaelezo
Channel NameJina la kituo cha mtandao
Source URLKiungo cha mtiririko (stream URL)
StatusHali ya kituo: Live au Offline
Date CreatedTarehe ilivyoundwa
ActionsVitendo: View, Edit, na kubadilisha hali (Go Live/Go Offline)

3.3 Kubadilisha Hali ya Kituo (Toggle Live/Offline)

Kila safu ya jedwali ina kitufe cha kubadilisha hali ya kituo:

Kabla ya kubadilisha hali, utaulizwa kuhakikisha (confirmation dialog). Unapoweka kituo kuwa LIVE, vituo vingine vyote vitazimwa moja kwa moja.

4. Usimamizi wa Vituo vya Mtandao (Live Channels)

4.1 Orodha ya Vituo (Channel Index)

Kwenye ukurasa huu unaweza kuona vituo vyote vilivyosajiliwa kwenye mfumo. Unaweza kupanga, kuchuja, na kutafuta kwa kutumia sehemu za filter zilizo juu ya jedwali.

FeatureMaelezo
Serial NumberNamba ya mfuatano
Channel NameJina la kituo
URL SourceKiungo cha stream (Zeno FM format inahitajika)
StatusFilter kwa LIVE au OFFLINE
Date CreatedTarehe iliyoundwa
Created ByMtumiaji aliyeunda
ActionsView, Update, Delete

4.2 Kuunda Kituo Kipya (Create Channel)

1

Bofya "+ Create New Channel"

Kitufe kiko juu ya jedwali kwenye ukurasa wa Live Channels.

2

Jaza Fomu

Name: Jina la kituo (mf. "Times FM Sports")
Status: Chagua LIVE au OFFLINE
URL Source: Kiungo kamili cha stream (mf. https://stream.zeno.fm/wer43aorzyvpaymuvklb)

3

Bofya "Save Channel"

Ukishajaza, bofya kitufe cha kuhifadhi. Utaelekezwa kwenye ukurasa wa maelezo ya kituo kipya.

⚠ Uthibitishaji wa URL

Mfumo unathibitisha kama URL inafuata muundo wa Zeno FM. Hakikisha unatumia URL sahihi. Mfano: https://stream.zeno.fm/abcdef12345

4.3 Kutazama Maelezo ya Kituo (View Channel)

Bofya kitufe cha View kwenye jedwali la vituo ili kuona maelezo kamili ya kituo. Ukurasa huu una sehemu kuu mbili:

Kutumia Kicheza Mtiririko

4.4 Kuhariri Kituo (Update Channel)

Bofya Edit kwenye jedwali au Update kwenye ukurasa wa maelezo. Unaweza kubadilisha jina la kituo, hali (LIVE/OFFLINE), na URL ya mtiririko.

4.5 Kufuta Kituo (Delete Channel)

Bofya Delete kwenye ukurasa wa maelezo ya kituo. Utatakiwa kuthibitisha tendo lako kabla ya kufuta.

ⓘ Kumbuka

Kufuta kituo hakuwezi kutenguliwa. Hakikisha unauhakika kabla ya kufuta.

5. Usimamizi wa Watumiaji (Users)

5.1 Orodha ya Watumiaji

Ukurasa huu unaonyesha watumiaji wote waliosajiliwa kwenye mfumo. Kila mtumiaji anaonesha:

SafuMaelezo
IDNamba ya utambulisho
Full NameJina kamili la mtumiaji
UsernameJina la kuingia
EmailBarua pepe
RoleJukumu: Administrator, Owner, au User
StatusHali: Active, Inactive, au Deleted (bofya kubadilisha)
CreatedTarehe ya usajili
ActionsEdit na Delete (Delete haionekani kwa Administrator)

5.2 Kuunda Mtumiaji Mpya (Create User)

1

Bofya "+ New User"

Kitufe kiko juu ya jedwali la watumiaji.

2

Jaza Fomu

Username: Jina la kuingia (litumike kwa login)
Full Name: Jina kamili
Email: Barua pepe halali
Password: Nenosiri (angalau herufi 8)
Role: Chagua jukumu (Administrator, Owner, au User)
Status: Active, Inactive, au Deleted

3

Bofya "Create User"

Mtumiaji atatengenezwa na kuonekana kwenye jedwali.

5.3 Kuhariri Mtumiaji (Edit User)

Bofya Edit kwenye jedwali. Unaweza kubadilisha:

Kumbuka: Nenosiri halibadiliki hapa. Mtumiaji anabadilisha nenosiri lake mwenyewe kutoka kwenye wasifu wake.

5.4 Kubadilisha Hali ya Mtumiaji

Bofya kwenye badge ya hali ya mtumiaji kwenye jedwali:

Muhimu: Hali ya Administrator haiwezi kubadilishwa kwa usalama.

5.5 Kufuta Mtumiaji (Delete User)

Bofya Delete kwenye jedwali na uthibitishe tendo lako. Administrator hawezi kufutwa kwa usalama wa mfumo.

6. Wasifu na Kubadilisha Nenosiri

6.1 Kutazama na Kubadilisha Wasifu

Bofya Profile kwenye menyu ya juu au My Profile kwenye dashibodi.

Sehemu za Wasifu:

SehemuInaweza Kubadilishwa?Maelezo
UsernameHapanaJina la kuingia halibadilishwi
Full NameNdiyoBadilisha jina lako kamili
EmailNdiyoBadilisha barua pepe yako
RoleHapanaJukumu lako halibadilishwi kutoka wasifu
StatusHapanaHaiwezi kubadilishwa kutoka wasifu
1

Badilisha taarifa

Andika jina jipya au barua pepe mpya kwenye fomu.

2

Bofya "Update Profile"

Taarifa zitahifadhiwa na utaona ujumbe wa mafanikio.

6.2 Kubadilisha Nenosiri

Kwenye ukurasa wa wasifu, bofya Change Password ili kwenda kwenye ukurasa wa kubadilisha nenosiri.

1

Ingiza nenosiri la sasa

Current Password — nenosiri unalotumia sasa.

2

Ingiza nenosiri jipya

New Password — nenosiri jipya (angalau herufi 8).

3

Thibitisha nenosiri jipya

Confirm New Password — andika tena nenosiri jipya kwa uthibitisho.

4

Bofya "Change Password"

Ukishafanikiwa, utatolewa kwenye mfumo na kuombwa kuingia tena kwa nenosiri jipya.

⚠ Kanuni za Nenosiri

Nenosiri lazima liwe na angalau herufi 8. Hakikisha ni thabiti kwa kuchanganya herufi kubwa, ndogo, namba na alama.

7. Kubadilisha Mandhari (Theme Toggle)

7.1 Mandhari ya Mwanga na Giza

Mfumo una uwezo wa kubadilisha mandhari kati ya Light Mode (mwanga) na Dark Mode (giza). Hii inasaidia kupunguza uchovu wa macho hasa unapotumia mfumo kwa muda mrefu au usiku.

1

Tafuta kitufe cha mandhari

Kwenye upande wa juu kulia wa ukurasa, karibu na kitufe cha Logout, utaona kitufe cha 🌙 (mwezi) au (jua).

2

Bofya kubadilisha

Ikiwa unaona 🌙 (mwezi), mandhari iko kwenye Light mode. Bofya kubadilisha hadi Dark mode.
Ikiwa unaona (jua), mandhari iko kwenye Dark mode. Bofya kubadilisha hadi Light mode.

3

Inakumbukwa kiotomatiki

Mfumo unakumbuka chaguo lako hata ukifunga kivinjari. Ukirudi tena, mandhari utakayokuwa umechagua itabaki.

ⓘ Vidokezo

8. Usalama na Vidokezo

8.1 Kanuni za Usalama

KanuniMaelezo
Nenosiri thabitiTumia nenosiri lenye herufi kubwa, ndogo, namba, na alama (angalau 8)
Usishiriki akauntiKila mtumiaji awe na akaunti yake binafsi
Toka kwenye mfumoToka (Logout) ukimaliza kazi, hasa kwenye kompyuta za pamoja
Badilisha nenosiri mara kwa maraBadilisha nenosiri kila baada ya muda kwa usalama zaidi
Usitoe nenosiri kwa mtu yeyoteMsimamizi hataomba nenosiri lako kamwe

8.2 Usalama wa akaunti ya Administrator

⚠ Kanun za Administrator

8.3 Kumbukumbu za Shughuli (Audit Logs)

Kila tendo unalofanya kwenye mfumo linarekodiwa kwenye kumbukumbu za shughuli (Activity Logs). Hii inasaidia:

9. Kutatua Matatizo (Troubleshooting)

9.1 Siwezi Kuingia (Login)

TatizoSuluhisho
Nimesahau nenosiri langu Bofya "Forgot Password" kwenye ukurasa wa kuingia na ufuate maagizo yatakayotumwa kwa barua pepe yako
"Incorrect username or password" Angalia umeandika username na password kwa usahihi. Caps Lock inaweza kuwa imewashwa
Akaunti imezimwa (Inactive) Wasiliana na msimamizi wako ili kuwasha akaunti yako

9.2 Tatizo la Mandhari (Theme)

TatizoSuluhisho
Kitufe cha theme hakifanyi kazi Jaribu kufunga na kufungua tena kivinjari. Ikiwa tatizo linaendelea, futa kumbukumbu (cache) ya kivinjari
Rangi hazibadiliki vizuri Hakikisha unatumia toleo jipya la kivinjari (Chrome, Firefox, Edge 90+)

9.3 Tatizo la Vituo vya Mtandao

TatizoSuluhisho
Stream haichezi Angalia kama URL ni sahihi. Jaribu kufungua URL kwenye kichupo kipya kwa majaribio
"Format ya URL sio sahihi" Hakikisha URL inaanza na https://stream.zeno.fm/ ikifuatiwa na herufi za utambulisho
Kituo hakionekani kwenye dashibodi Jaribu kuburudisha ukurasa (refresh) au subiri sekunde 15 kwa ajili ya kuburudisha kiotomatiki

9.4 Hitilafu nyinginezo

⚠ Ikiwa unakumbana na hitilafu nyingine

ⓘ Kuhusu Mwongozo Huu

Mwongozo huu umetengenezwa kwa ajili ya watumiaji wa mfumo wa Times FM. Toleo la sasa ni v1.0 (Mei 2026). Mwongozo utaendelea kuboreshwa kadri mfumo unavyoboreshwa.

Kwa mapendekezo au kuripoti makosa, wasiliana na timu ya msaada wa kiufundi.