capstone project 2 cmu se 451 cmu is 451 architecture design course marketplace reviews platform

Source of stimulus User Artifact stimulated Platform Response measure Account will be automatically logged out if user stay inactive in 24 hours.. Scenario: When a user registers, their

Course Marketplace & Reviews Platform

Submitted by

Ngo Quoc Thinh Bui Son Thai Nguyen Quoc Dung

Approved by Proposal Review Panel Representative:

Capstone Project 2- Mentor:

PROJECT INFORMATION

Project Mentor

Tran Kim Sanh, MSc Email: sanhtk@gmail.com Tel: 0987.409.464

Team members

Ngo Quoc Thinh qthinh2801@gmail.com 0945.280.101 Bui Son Thai sonthai1310.works@gmail.com 037.6314.578 Nguyen Quoc Dung qdung.nguyen810@gmail.com 0903.476.313

REVISION HISTORY

1 INTRODUCTION

This project aims to establish a comprehensive platform that consolidates a wide range of course information Its primary objective is to empower learners with the ability

to easily discover courses aligned with their interests Furthermore, the platform serves as

a trustworthy source of course feedback, enabling learners to make informed decisions and select the most suitable courses Additionally, this initiative provides a space for course providers, predominantly local teachers and coaches, to showcase their services and quality, thereby increasing their student enrollment

This specification covers following:

– Brief specification of the project, high level requirement

– Detail quality attribution

– System context, sequence diagrams

– Architecture presented by various view types: Component and Connect, Module view and Allocation view

Business problems:

The current challenge in the education landscape is the fragmentation of course information, making it difficult for learners to navigate and select courses tailored to their needs Moreover, learners often face uncertainties regarding the quality and suitability of

a course This project endeavors to bridge this gap by centralizing course data and offering

a reliable feedback mechanism

Business needs:

– Fragmentation of course information makes it challenging for learners to navigate and select suitable courses

– Learners often face uncertainties regarding the quality and suitability of courses – Course providers lack a centralized platform to showcase their offerings, hindering their ability to reach potential students effectively

2 ARCHITECTURE DRIVER

2.1 Business constraints

– Sources: 3 people

– Project was started on: 31/0 /2028 3

– Project will be ended on: 12 12/ /2023

– Project will be finished in 101 days (1195 hours)

– Programming Language: HTML, CSS, Typescript

– Framework / Libraries: React, Redux, React Charts,

– Web Browser: Chrome, Firefox, Microsoft Edge

– Network Accessing: World Wide Web (WWW), HTTP methods (POST, GET) via RESTful API with Axios

2.3 Functional requirement

References to Product Backlog specification of C2SE.10-ProductBacklog – CMRP

Source of stimulus User

Artifact stimulated Platform

Response measure Account will be automatically logged out if user stay

Artifact stimulated Platform

Response measure Encrypted password through 3 layers of security

2.4.2.2 Performance

Scenario: A user leaves a review for a course on a platform

Stimulus Submit a Vietnamese review

Source of stimulus User

Artifact stimulated System that interoperates with target system

Response The system analyzes the sentiment of the review and updates

the overall sentiment statistics for the course and course provider

Response measure The sentiment score instantly changes after the user submits

their review

Scenario: User send a request payment for courses The system verifiesthese courses, makes a transaction and sends a result in less than 5 seconds

Stimulus Send a request payment

Source of stimulus User

Environment At runtime

Artifact stimulated System user interface, platform

Response Verify payment information, make transaction and response a

result

Response measure Verify payment information, make transaction and response a

result less than seconds5

2.4.2.3 Usability

Scenario: A user is browsing through a list of online courses They want to see review

by the filter category and rating

Stimulus Filter on the review page

Source of stimulus User

Artifact stimulated System user interface

Response The user is able to filter the courses by category and rating Response measure The filter of the review always response the relevant results

Scenario: The user wants to check the schedule to see if it is suitable for them

Stimulus View the schedule of the course

Source of stimulus User

Artifact stimulated System user interface

Response See the schedule of the course

Response measure Instant view the schedule

Scenario: The user wants to enter their personal information quickly and easily for verification They can do this by either manually typing their ID number in the provided text box, or by scanning the QR code on their ID card using the "Scan QR code" button

Artifact stimulated System user interface, platform

Response measure Input the personal information in seconds

2.4.2.4 Correctness

Scenario: User choose the course they want to pay and checkout them The system calculates the total amount and pays the correct quantity and selected course

Stimulus Choose the course and check them out

Artifact stimulated System user interface, platform

Response Calculates the total amount and pay

Response measure Correct quantity and selected course

Scenario: When the user (learner) successfully makes payment for the course, the system will add the amount the Learner just paid to the Course Provider’s total income

on the system

Source of stimulus User

Artifact stimulated Platform

Response Add the amount the Learner just paid to the Course

Provider’s total income on the system

Response measure The total income increases by the amount the learner paid

Scenario: The user annot add two identical courses to cart at the same timec or a course that has been purchased and is being studied cannot be added to the cart again

Source of stimulus User

Artifact stimulated Platform

Response Preventing data duplication in shopping carts Response measure Cannot add two identical courses to cart at the same

time or a course that has been purchased and is being studied

2.4.2.4 Modifiability

Scenario: A product manager wants to develop additional features in the next version The system allows for an expansion within 4 person months of effort without affecting existing functions

Stimulus Develop additional features

Source of stimulus A product manager

Artifact stimulated Environment

Response Allows for an expansion

Response measure 4 person months of effort without affecting existing

functions

– Learner: Learners can search for courses, enroll in them, and review them

monitor class enrollment

– Admin: Admins can manage user accounts, resolve disputes, enforce policies, and conduct

system maintenance tasks They can also review and approve new course provider registrations

– APIs: The platform uses three APIs:

● PhoBERT Sentiment API: This API analyzes the sentiment of user reviews, providing a quick and clear indication of whether the reviewer recommends the course or not

● Cloudinary API: This API stores images, which helps save space for the data server

● Paypal API: This API provides secure payment transactions solution

3.2 Component and connector

We mainly used a C&C view to argue and reason about architectural properties, quality attribute requirements, and functional requirements that the system must add here This view type partitions the system into components that have some runtime presence such as processes, objects, data stores, and connectors or that represent pathways

of communication such as data flows and access to shared storage

Figure 2: C&C of CMRP

=

The web client sends and receives data from the server through the web service API User operations will send requests to the server through the API, the server will process the data with the corresponding models and access the database to retrieve data, then respond to the

information to the web client through the API to display it to the user

Web service Web Service is a component that manages and performs activities related

to retrieval and storage of data such as get the learner list, user authorization

The service provides image storage solution

Account service Service API in the backend to register a new account and login to the

system

Enrollment service Backend API service to record the succ sful payment transaction for es

course and present the enrolment numb on Course Prover ider’s dasboard Rating service Backend API service to separately record the rating of the us erReview service Service interacts with the database and provides APIs for managing the

system

API PhoBERT

sentiment service

Analyzes the sentiment of the Vietnamese user reviews

API PayPal er s vice Provides secure payment transactions

Feedback (report)

service

Backend API service to send the report message directly to the email of the administrator

Database Database is a component which contains information of users, courses,

reviews, schedules, All data the system needs

3.3 Sequence diagram

Sequence diagram is used to display the sequence of activities Sequence diagrams show the workflow from a start point to the finish point detailing the many decision paths that exist in the progression of events contained in the activity

3.3.1 Login

Description:

In order to sign up or pulish a couse on the CMRP platform, users have to login at first by using username and password Our system receives requests, authenticates and returns login status

If login successfully, users can use all functions of the system in their permission Otherwise, their access will be denied

3.3.2 Sign up

Description:

To login to the system, user have to register first

User are allowed to register a new account, to do that they create a new account with

3.3.3 Publish course

Description:

To publish a new course, user have to login first

User have to switching to the Course Provider view first, then they could create a new course Firstly, they should provide required information The course thumbnail is going to be stored in Cloudinary, others type of information is stored in database After theprocess complete sucessfully, they will recive an announcement

3.3.4 Upload certificate

Description:

To help course providers increase their profile, the system allows them to upload their academic certificates The certificates will be uploaded as image files, which will be stored in Cloudinary After the process completes successfully, they will receive an

announcement

3.3.5 Leave review

Description:

Our platform aims to provide a trusted source for our users to confidently sign up for courses Therefore, the review must be from the user who has completed the course All reviews will be sent to the PhoBERT API to analyze the nuances of the review (Vietnamese only) The results will be showed as a graph on our website, it will be presented in 3 levels of sentiment like positive, negative, and neutral This emotional fingerprint will paint a clearer picture of the actual learning experience, beyond just star ratings or basic summaries

3.4 Module view

Element Responsibilities

Web View The website package contains management modules for

admin and us erAPI Cloudinary The service allow store image, is located on the system itself,

and allows external access to get image content

API PayPal The payment gateway provides a payment solution for the

secure online transaction

API PhoBERT

sentiment

Analyzes the sentiment of user reviews, providing a quick and clear indication of whether the reviewer recommends the course or not

Models Object data modules connect to collections in the database

for transmission to the system interface

Description: The system includes web view, services, and models After users interact with UI

Data will be requested to the corresponding service, then will direct to model Data be responded will be displayed on UI Course published on the platform is stored in the Course model Images upload on the are stored in the system's directory and accessed via URL

3.5 Allocation view

The allocation view models the run-time architecture of a system It shows the configuration

of the hardware elements when the system is deployed

Prose

Laptop or PC Device running browser and helping User and Admin to use the

functions of the website to manage

PhoBERT Sentiment Analyzes the sentiment of user reviews, providing a quick and

clear indication of whether the reviewer recommends the course

2 ATAM

4.1 Present the ATAM

+ Overall evaluation of system architecture documents, system designs on 3 views: static view, dynamic view, and physical view based on ATAM 9 Steps method + Expect to achieve an accurate and objective evaluation of the architectural document From there, the project team assesses the ability to complete the project and achieve the Architecture Drivers

4.2 Present the business Drivers

+ The content on the document presented about the following:

o Who are the business drivers

o Business problems and goals for the system are presented by the Project decision makers

o System’s features

o System’s requirements

o Project constraints

o Project scope

4.3 Present the Architecture

+ Current Architecture state: The design is systematically overviewed on all 3 views: allocation view, module view and component and connector view + Expected Architecture state: The architecture is easy to understand, easy to read, full of content, clear and responsive to the constraints and Quality Attributes of the system

+ Impact of following project constraints in the architecture:

o Time / Deadline: Project will be finished in 101 days (1195 hours)

o Cost / Available resources: 3 people with cost $2868

o Complexity of the problem: high

o Quality expectations: Meet the constraints and 5 Quality Attributes described above include: Security, Performance, Usability, Correctness and Modifiability

4.4 Identify the Architecture approaches

+ Architecture pattern: Service-oriented architecture(SOA)

+ In SOA, services use protocols that describe how they pass and parse messages using description metadata This metadata describes both the functional characteristics of the service and quality- -of service characteristics Service-oriented architecture aims to allow users to combine large chunks of functionality

to form applications which are built purely from existing services and combining them in an ad hoc manner A service presents a simple interface to the requester that abstracts away the underlying complexity acting as a black box Further users can also access these independent services without any knowledge of their internal implementation

+ The architectural blueprints are broken down into sections and interact with the services