1. Open the app
- Open mkulimaseedlings.store in Chrome.
- Install it: Chrome menu ⋮ → Add to Home screen (or Install app). It then opens like any other app.
- Tap your area: Loise, Sales — Managers or Sowing Team. Loise and Sales type their password. The Sowing Team opens with one tap, no password.
- Language: tap English | Kiswahili at the top.
Never share the Loise or Sales password with the sowing team or casual workers. On a shared phone, sign out when you finish.
2. Before the first day Loise
- Catalogue: 60 seedling varieties are already loaded. Check each price and correct it; add any missing variety, delete what you don't sell.
- Inventory: count what is in the nursery today and enter the quantities. This is the starting stock.
- Employees: add every staff member (name, phone, role, salary). Attendance and payroll use this list.
- Customers: add regular customers now, or let them be added as they buy.
- Bookings: enter any orders customers have already paid deposits for, with the deposit amount and pick-up date.
- Customers who still owe money from before: record one sale for each with the amount owed and payment = Credit, so the balance shows in the app.
3. Every day
Sales Record a sale
- Sales → Add Sales.
- Choose the customer (or type a new name and phone), add each item and quantity. The price comes from the catalogue; you may change it.
- Choose how they paid: Cash, M-Pesa, Bank, or Credit (pays later). Enter the amount paid.
- Save — stock goes down and a receipt is ready to print or share.
M-Pesa: tap Request M-Pesa payment, check the number and amount, Send request. The customer enters their PIN and the M-Pesa code fills in by itself. If they paid to the till themselves, type the code from their SMS (e.g. SJK4ABC123) into M-Pesa code.
A customer pays a debt: Sales → Order Book → find the sale → tap the 💵 pay button.
Sales Bookings
Customer orders now and picks up later: Bookings → enter variety, quantity, deposit and pick-up date → Save. When the seedlings are ready tap Ready; when the customer collects tap Picked up.
Sales Attendance — every morning
Attendance → for each worker tap Present, Leave or Absent.
Sowing Team Record sowing
- Open the app → Sowing Team (no password).
- Enter the date, variety, quantity, unit and the expected ready date. Save.
- When the seedlings are ready, tap Ready → Stock on that line and enter how many seedlings came out. They are added to the stock for sale.
Stock in and out
Inventory → + In for stock received, − Out for losses or damage. Sales take stock out by themselves — don't do it twice.
4. End of the day Sales Loise
- Reports → Daily summary (Z report).
- Count the cash. It must match the cash total. Check the M-Pesa total against the till/Paybill statement.
- If something doesn't match, find the sale today, not next week.
5. Every month Loise
- Settings → Backup (Excel + JSON). Two files download: an Excel file to read, and Mkulima_Full_<date>.json to restore from.
- Keep both safe: email them to mkulimaseedlings@gmail.com or save them to Google Drive.
- Pay salaries and staff loans from Employees → Staff loans & salary; record expenses in Accounting as they happen.
6. Internet
- The app works without internet. Work goes on; it is sent when the network is back.
- The top bar shows Synced 10:42 (all sent), Offline — 3 changes waiting, or Sync problem. Tap it to try again.
- Open the app with internet at least once a day on every phone, so others see your work.
- Don't clear Chrome's data or uninstall the app while changes are waiting.
7. When something goes wrong
- Wrong entry: open it, edit or delete it. Every change is recorded with who made it.
- Forgot the password: Loise changes it in Settings.
- Phone lost: change the Loise and Sales passwords at once from another phone.
1. Fungua programu
- Fungua mkulimaseedlings.store kwenye Chrome.
- Isakinishe: menyu ya Chrome ⋮ → Add to Home screen (au Install app). Kisha inafunguka kama programu nyingine.
- Gusa sehemu yako: Loise, Sales — Managers au Sowing Team. Loise na Sales wanaandika nenosiri. Timu ya Kupanda inafungua kwa mguso mmoja, bila nenosiri.
- Lugha: gusa English | Kiswahili juu.
Usimpe mtu wa timu ya kupanda au kibarua nenosiri la Loise au Sales. Kwenye simu ya pamoja, toka (sign out) ukimaliza.
2. Kabla ya siku ya kwanza Loise
- Orodha ya Miche: aina 60 za miche zimeshawekwa. Kagua kila bei na uirekebishe; ongeza aina inayokosekana, futa usizouza.
- Stoka: hesabu kilichopo kitaluni leo na uingize idadi. Hii ndiyo stoka ya kuanzia.
- Wafanyakazi: ongeza kila mfanyakazi (jina, simu, kazi, mshahara). Mahudhurio na mishahara hutumia orodha hii.
- Wateja: ongeza wateja wa kawaida sasa, au waongezwe wanaponunua.
- Bookings: ingiza oda ambazo wateja wameshalipia amana, pamoja na kiasi cha amana na tarehe ya kuchukua.
- Wateja wanaodaiwa kutoka zamani: andika mauzo moja kwa kila mmoja yenye kiasi anachodaiwa na malipo = Deni, ili deni lionekane kwenye programu.
3. Kila siku
Sales Kuandika mauzo
- Mauzo → Ongeza Mauzo.
- Chagua mteja (au andika jina jipya na simu), ongeza kila bidhaa na idadi. Bei inatoka kwenye orodha; unaweza kuibadilisha.
- Chagua njia ya malipo: Pesa taslimu, M-Pesa, Benki, au Deni (atalipa baadaye). Ingiza kiasi kilicholipwa.
- Hifadhi — stoka inapungua na risiti iko tayari kuchapishwa au kutumwa.
M-Pesa: gusa Request M-Pesa payment, kagua namba na kiasi, Send request. Mteja anaingiza PIN na namba ya M-Pesa inajaa yenyewe. Kama amelipa mwenyewe kwenye till, andika namba kutoka kwenye SMS yake (mfano SJK4ABC123) kwenye M-Pesa code.
Mteja analipa deni: Mauzo → Kitabu cha Oda → tafuta mauzo → gusa kitufe cha 💵 kulipa.
Sales Bookings
Mteja anaagiza sasa na kuchukua baadaye: Bookings → ingiza aina, idadi, amana na tarehe ya kuchukua → Hifadhi. Miche ikiwa tayari gusa Iko tayari; mteja akichukua gusa Imechukuliwa.
Sales Mahudhurio — kila asubuhi
Mahudhurio → kwa kila mfanyakazi gusa Yupo, Likizo au Hayupo.
Sowing Team Kuandika upandaji
- Fungua programu → Sowing Team (bila nenosiri).
- Ingiza tarehe, aina, idadi, kipimo na tarehe inayotarajiwa kuwa tayari. Hifadhi.
- Miche ikiwa tayari, gusa Ready → Stock kwenye mstari huo na uingize idadi iliyo tayari. Inaongezwa kwenye stoka ya kuuza.
Stoka kuingia na kutoka
Stoka → + In kwa stoka iliyopokelewa, − Out kwa iliyopotea au kuharibika. Mauzo yanatoa stoka yenyewe — usiitoe mara mbili.
4. Mwisho wa siku Sales Loise
- Ripoti → Muhtasari wa Siku (Z).
- Hesabu pesa taslimu. Lazima ilingane na jumla ya cash. Linganisha jumla ya M-Pesa na taarifa ya till/Paybill.
- Kama kitu hakilingani, tafuta mauzo hayo leo, si wiki ijayo.
5. Kila mwezi Loise
- Mipangilio → Backup (Excel + JSON). Faili mbili zinapakuliwa: Excel ya kusoma, na Mkulima_Full_<tarehe>.json ya kurejesha.
- Zihifadhi salama: zitume kwa mkulimaseedlings@gmail.com au uziweke Google Drive.
- Lipa mishahara na mikopo ya wafanyakazi kupitia Wafanyakazi → Staff loans & salary; andika matumizi kwenye Uhasibu yanapotokea.
6. Intaneti
- Programu inafanya kazi bila intaneti. Kazi inaendelea; inatumwa mtandao ukirudi.
- Juu inaonyesha Synced 10:42 (yote yametumwa), Offline — 3 changes waiting, au Sync problem. Gusa ili ujaribu tena.
- Fungua programu ukiwa na intaneti angalau mara moja kwa siku kwenye kila simu, ili wengine waone kazi yako.
- Usifute data ya Chrome wala kuondoa programu wakati kuna mabadiliko yanayosubiri.
7. Kitu kikienda vibaya
- Umekosea kuingiza: ifungue, irekebishe au uifute. Kila badiliko linaandikwa na nani amelifanya.
- Umesahau nenosiri: Loise analibadilisha kwenye Mipangilio.
- Simu imepotea: badilisha nenosiri la Loise na Sales mara moja kutoka simu nyingine.