1.

MSME User Journey

1.​ Access the Bot
○​ MSME opens the Telegram bot.
○​ MSME views a welcome message.
○​ The bot prompts the user to register.
2.​ Registration
○​ User inputs Name, Region,City, Sub-City, Woreda,
Kebele,Phone number and Email address.
○​ System verifies and stores user details.
○​ Successful registration confirmation is sent.
3.​ Course Introduction
○​ The bot provides an overview of available courses.
○​ User is asked to choose a course from the menu.
4.​ Course Selection
○​ User selects a course (e.g., Digital Literacy, Financial Literacy).
○​ Training begins, displaying content as text, video, or
interactive material.
5.​ Course Progress Tracking
○​ The system tracks each step completed by the user.
○​ If a course is left incomplete, the bot sends reminders.
6.​ Course Completion & Certification
○​ User completes all required steps in the course.
○​ A Certificate of Completion is generated.
○​ The bot delivers the certificate via Telegram and email.

2. Admin (KFT) Journey

1.​ Access the Web Portal
○​ Admin logs into the dashboard.
○​ The portal provides access to course and user management.
 2.​ Course Management
○​ Admin can create, update, or delete courses.
○​ Admin uploads training content such as PDFs, videos, and
quizzes.
3.​ User Management
○​ Admin can create and manage bot managers.
○​ Admin can add, remove, or update user details.
4.​ Analytics & Reports
○​ Dashboard displays key metrics:
■​ Number of MSMEs enrolled, Trained
■​ Course completion rates
■​ User engagement and activity

The dashboard should be filtered to show the number

of msmes by region, gender and vulnerability status.​

○​ Reports can be exported for further analysis.

Use Cases

MSME User Journey Use Cases

1. Use Case: Register for the Course

●​ Actors: MSME User

●​ Description: The user registers on the Telegram bot by providing their name,
email, and phone number. The system verifies the details and confirms successful
registration.
●​ Preconditions: The user has access to the Telegram bot.
●​ Flow of Events:
○​ The bot prompts the user to input their name, email, and phone number.
○​ The system verifies the information and stores it.
○​ A confirmation message is sent to the user upon successful registration.
 ●​ Postconditions: User is registered and can proceed to course selection.

2. Use Case: Select a Course

●​ Actors: MSME User

●​ Description: The user selects a course from the available options (e.g., Digital
Literacy or Financial Literacy) and starts the training.
●​ Preconditions: User has successfully registered and logged into the Telegram bot.
●​ Flow of Events:
○​ The bot provides an overview of the available courses.
○​ The user selects a course from the menu.
○​ The bot displays content in text, video, or interactive format.
●​ Postconditions: User is enrolled in the selected course.

3. Use Case: Track Course Progress

●​ Actors: MSME User

●​ Description: The system tracks the user's progress in the selected course and
sends reminders for incomplete sections.
●​ Preconditions: User has started a course.
●​ Flow of Events:
○​ The system monitors user activity in the course.
○​ If the user leaves a course incomplete, the bot sends reminders.
●​ Postconditions: User is reminded to complete the course.

4. Use Case: Complete the Course and Receive Certification

●​ Actors: MSME User

●​ Description: The user completes all required steps in the course, and the system
generates a certificate of completion.
●​ Preconditions: User has completed all course steps.
●​ Flow of Events:
○​ The system verifies that the user has completed all steps.
○​ A Certificate of Completion is generated.
○​ The bot sends the certificate via Telegram and email.
●​ Postconditions: User receives the certificate.

Admin (KFT) Journey Use Cases

1. Use Case: Access the Web Portal

●​ Actors: Admin (KFT)

●​ Description: The admin logs into the portal to manage courses, users, and
analytics.
 ●​ Preconditions: Admin has login credentials.
●​ Flow of Events:
○​ Admin enters credentials and logs into the dashboard.
○​ The portal displays options for course management, user management,
and analytics.
●​ Postconditions: Admin is logged in and can manage the system.

2. Use Case: Manage Courses

●​ Actors: Admin (KFT)

●​ Description: The admin can create, update, or delete courses. They also upload
training content (PDFs, videos, quizzes).
●​ Preconditions: Admin is logged into the portal.
●​ Flow of Events:
○​ Admin selects course management from the dashboard.
○​ Admin chooses to create a new course, update an existing course, or
delete a course.
○​ Admin uploads relevant training content for the course.
●​ Postconditions: Course is updated, created, or deleted, and content is uploaded.

3. Use Case: Manage Users

●​ Actors: Admin (KFT)

●​ Description: The admin can create bot managers and manage user details (add,
remove, or update).
●​ Preconditions: Admin is logged into the portal.
●​ Flow of Events:
○​ Admin selects user management from the dashboard.
○​ Admin can add new users or remove/update existing ones.
○​ Admin can create bot managers with specific permissions.
●​ Postconditions: Users and bot managers are updated accordingly.

4. Use Case: View Analytics and Reports

●​ Actors: Admin (KFT)

●​ Description: Admin views key metrics on course enrollment, completion rates,
and user activity. They can export reports for analysis.
●​ Preconditions: Admin is logged into the portal.
●​ Flow of Events:
○​ Admin selects the analytics section from the dashboard.
○​ The system displays metrics such as MSME enrollments, course
completion rates, and user engagement.
○​ Admin can export the reports in various formats for further analysis.
●​ Postconditions: Admin has accessed analytics and exported reports.
User Stories

1. Access the Bot

User Story:​
As an MSME user, I want to open the Telegram bot and receive a welcome message so that I
understand how to get started.

Acceptance Criteria:

●​ The user can open the bot by searching for it on Telegram.

●​ The bot displays a welcome message upon opening.
●​ If the user is new, the bot prompts them to register.
●​ If the user is registered, they are redirected to the course list.
●​ The bot provides a brief one-line instruction on how to use it.
●​ The bot includes a "How to Use the Bot" button that, when clicked, displays detailed
instructions.

2. Registration
User Story:​
As an MSME user, I want to register by providing my details so that I can access the training
courses.

Acceptance Criteria:

●​ The bot prompts new users to enter the required details (Name, Region, City, Sub-City,
Woreda, Kebele, Phone number, Email).
●​ The system validates the input data (e.g., valid phone number, email format).
●​ The system stores user details securely.
●​ The bot sends a confirmation message upon successful registration.
●​ If registration fails, the bot provides an error message and prompts re-entry.

3. Course Introduction
User Story:​
As an MSME user, I want to view an overview of available courses so that I can choose the
most relevant one.

Acceptance Criteria:
 ●​ The bot displays a list of available courses.
●​ Each course has a brief description of its content.
●​ The user is prompted to select a course.

4. Course Selection
User Story:​
As an MSME user, I want to select a course so that I can start my training.

Acceptance Criteria:

●​ The bot presents a menu of courses (e.g., Digital Literacy, Financial Literacy).
●​ The user can select one course from the list.
●​ Upon selection, the bot confirms the choice and begins the training session.

5. Training Process
User Story:​
As an MSME user, I want to go through course materials so that I can complete my training.

Acceptance Criteria:

●​ The system presents course content in the chosen format (text, video, interactive).
●​ The user can navigate through the content step by step.
●​ The system tracks progress in real-time.

6. Course Progress Tracking

User Story:​
As an MSME user, I want my progress to be tracked so that I can resume training from where I
left off.

Acceptance Criteria:

●​ The system records the user's last completed step.

●​ If the user exits before completing, they can resume from the last step.
●​ The bot sends reminders if the course is left incomplete after a set time (e.g., 24 hours).
7. Course Completion & Certification
User Story:​
As an MSME user, I want to receive a certificate after completing a course so that I have proof
of my training.

Acceptance Criteria:

●​ The system verifies that all course steps are completed.

●​ A Certificate of Completion is generated automatically.
●​ The certificate is delivered to the user via Telegram.
●​ The certificate is also sent via email.