TEAM 7 (Techno Fusion) Deliver software with precision and passion PRELIMINARY SOFTWARE REQUIREMENTS SPECIFICATION Version 1.0
iLMS Interactive Learning Management System
PRELIMINARY SOFTWARE REQUIREMENT SPECIFICATION VERSION: 1.0
(REVISION DATE: 28/08/2009)
Documented by: Techno Fusion Committee Name
Appointment
Arnav Singh
Team Leader
Lwi Tiong Chai
Secretary
Tan Koon Liang
Content Manager
Abdul Haleem
SRS In-Charge
Liu Wei
SRS Vetter
Hu Yuanling
UML Diagram In‐Charge
Wen ke
UML Diagram Vetter
Biju Joseph Jacob
Developer In‐Charge
Approver Name
Title
Arnav Singh (shadow client)
Preliminary SRS and Project Gantt
Signature
i
Date 28/08/2009
Table of Contents Project Quick Overview ....................................................................................................................... 1 1. Product Description ..................................................................................................................... 1 1.1
Product Vision ..................................................................................................................... 1
1.2
Business Requirements ....................................................................................................... 1
1.3
Stakeholders and Users ....................................................................................................... 2
1.4
Project Scope ...................................................................................................................... 2
2. Use Case Model ............................................................................................................................ 3 2.1
Use Case Diagram ............................................................................................................... 3
2.2
Use Case Description .......................................................................................................... 3
3. Committee Roles and Responsibilities ............................................................................................ 9 4. Enhanced Waterfall Incremental Model ....................................................................................... 12 5. Glossary ...................................................................................................................................... 14 6. References.................................................................................................................................. 14 7. Revision History .......................................................................................................................... 14 Customized Project Gantt Chart .......................................................................................................... 1
TEAM 7 (Techno Fusion) Deliver software with precision and passion PRELIMINARY SOFTWARE REQUIREMENTS SPECIFICATION Version 1.0
Project Quick Overview The client is a tuition consortium which will adjudicate what system is best for individual tuition agencies collaboration. Instead of relying on the natural course of business to make decision for them, individual tuition agencies can leverage on the resources of our client so that they will be accessible to highly efficient streamlined created through economies of scale with common channels of communication and abundant opportunities at the organization level. With its mission “Every student deserves the best” and organizational objective such as developing elite students across the nation. Our client constantly improves the academically challenged primary school students to enable them to compete and excel in school. The Interactive Learning Management System iLMS is web solution to provide online tuition service to individual tuition agency, which is designed to improve the collaboration between tutor and the corresponding students.
1. Product Description 1.1 Product Vision
To provide innovative web solutions for tuition consortium in inducing 3E learning elements to their primary school‐level customers (tutee) ‐ Enriching, Enhancing and Exhilarating learning. 1.2 Business Requirements
The following are a list of the business requirements of inaugural iLMS implementation
•
iLMS must be adopted by at least 60% of the tuition agencies within one year of introduction.
•
iLMS must cut operational cost of running an individual tuition agency by 15% per year.
•
At least 10 % of the total cost incurred developing iLMS should be earned within one year of the development project launch.
1
1.3 Stakeholders and Users
The generic stakeholders of the iLMS are: Management, Developers and Users. The board of the directors of the tution consortium and the CEO of team8 are identified as the management. The eight‐member iLMS development team is identified as the developers, who will develop and market the product. The following are the users of the iLMS: Student, Tutor, Parent and Central Management. Their roles of the users are listed in Table 1. Type of User Student
Location Any location that has a PC with internet connection
Tutor
Any location that has a PC with internet connection Any location that has a PC with internet connection Tuition Consortium
Parent
Central Management
Nature of Use The students will use the iLMS to register course, participate in online courses, download course materials and provide feedback. The tutor will publish course schedule, upload course materials and conduct online courses. With iLMS parents will be able to make payment, view progress report of their child and also provide feedback. The staff of the tuition consortium will manage tuition agency,tutor and student informations
Table 1: Roles of user of the iLMS 1.4
Project Scope
The iLMS is designed for better interaction developed exclusively for simplifying agencies management procedures between students, tutors, parents and the tuition agencies. This management software gracefully handles all the requirements for the agencies. The system being web based can be accessed from anywhere in the world which enables the students, tutors, parents and the tuition agencies to be in touch with each other at all times and keeps the lines of communication open. The iLMS being an online interactive community portal provides state-of-the-art online interactive portal which will enhance the efficiency of agencies administration and improve resource optimization, thus raising the standards of tuition agencies nation-wide. This brings the community together on a common interactive platform thereby fostering camaraderie among them
2.
Use Case Model
2.1
Use Case Diagram
Figure 2: Use Case Diagram of iLMS 2.2
Use Case Description
Use Case ID: Use Case Name: Created By: Date Created:
01 Join As Member HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Student Description: To allow student to create membership so that he can enjoy all the services this system provides Trigger: ‐ Preconditions: ‐ Postconditions: 1. System will send an email with the user log in information to the student.
Normal Flow: 1. Student clicks create membership button on the main menu. 2. System displays a form to prompt the user to key in his personal information such as id, password, name, email, and school name. 3. Student fills the form by keying in the necessary information. 4. System verifies all the information provided by the student. 5. Systems add student information into the database. Use Case ID: Use Case Name: Created By: Date Created:
02 Register Course HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Description: Trigger: Preconditions:
Student To allow student to register for the courses that he is interested in. ‐ Student must log into the system with valid user name and password. Postconditions: System will display a confirmation page with the entire course registered. Normal Flow: 1. Student clicks register course button on the main menu. 2. System displays all the available courses with time slot and tutor name. 3. Student plan and chooses the course that they want to take. 4. Student click on the register button on the page. 5. System adds the register information to the database. Use Case ID: Use Case Name: Created By: Date Created:
04 Participate online course HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Student Description: To allow student to participate the online courses so that he can interact with the tutor. Trigger: ‐ Preconditions: 1. Student must log into the system with valid user name and password. 2. Both computers from student and tutor must fulfill system requirements for online tutoring. Postconditions: Normal Flow: 1. Student selects online class on the main menu.
2. System displays all the available classes for that particular student in that time slots. 3. Student clicks the course name. 4. System displays the all the course information with a start button. 5. Student clicks on the start button to start online class. Use Case ID: Use Case Name: Created By: Date Created:
05 Provide feedback HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Description: Trigger: Preconditions: Postconditions: Normal Flow:
Student/Parent To allow student and parent to give feedback to the whole system. ‐ ‐ ‐ 1. Student/Parent clicks feedback on the main menu. 2. System displays a form to prompt the user to key in the reviews, commands for the system. 3. Student/Parent fills the form by keying in the necessary information. 4. Student/Parent clicks on the submit button on that page. 5. System adds these feedbacks into the database.
Use Case ID: Use Case Name: Created By: Date Created:
06 Manage School and Student Information WEN KE Last Updated By: WEN KE 26/08/09 Date Last Updated: 27/08/09
Actors: Centre Management Description: To allow tuition agency to manage all the matters concern about school operations and student information. Trigger: Preconditions: 1. Staff must log into system with valid user name and password Postconditions: 1. School and student information has been updated Normal Flow: 1. Staff clicks school information button on the main menu 2. System displays school details. 3. Staff clicks edit button on that page. 4. System shows school information in edition mode with a textbox.
5. Staff changes content or uploads new messages and clicks save 6. System updates the database and displays a message to show that the update is successful. 7. Staff clicks registered student list on the main menu. 8. System displays all the student names. 9. Staff clicks sort by tutor name button 10. System shows all the students under each tutor with a dropdown list of tutor names. 11. Staff clicks on one tutor name. 12. System displays all the students under that tutor. 13. Staffs send email of the students’ lists to tutor for their reference. Use Case ID: Use Case Name: Created By: Date Created:
07 View Progress Report HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Description: Trigger: Preconditions: Postconditions: Normal Flow:
Parent View students’ progress report Parent log into the system with student name. 1. Parent clicks view progress report button on the main menu. 2. System displays reports by chronological order. 3. Parent click on the date he wants to view. 4. System searches for the database and displays the result.
Use Case ID: Use Case Name: Created By: Date Created:
08 Make payment HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Parent Description: To allow parent to make payment online so that the student can start the online tuition. Trigger: Student has already selected the course or the package he wants to join Preconditions: Student has already joined as a member of the system. Postconditions: An confirmation email of payment details will be sent to the student
Email. Normal Flow: 1. Parent log into the system by keying the student name. 2. System displays all the courses that the student has already selected with details of fees. 3. Parent can choose. 4. System verifies all the information provided by the student. Use Case ID: Use Case Name: Created By: Date Created:
09 Publish course schedule HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Tutor Description: To allow tutors to publish course schedule so that the student can view and choose a time slot. Trigger: Preconditions: Tutor login the system with valid user name and password. Postconditions: Normal Flow: 1. Tutor clicks publish course schedule. 2. System displays a blank page with the entire possible time slot and a dropdown list to show all the index number of the courses. 3. Tutor selects the index number. 4. System verify with the database to check no clash for that index. 5. System adds the index number into the timetable. 6. System displays index number onto the timetable. 7. Tutor double check the timeslot and click the confirm button. Use Case ID: Use Case Name: Created By: Date Created:
10 Upload course material HU YUANLING 26/08/09
Last Updated By: HU YUANLING Date Last Updated: 27/08/09
Actors: Description: Trigger: Preconditions: Postconditions: Normal Flow:
Tutor To allow to tutors to upload course materials ‐ Tutor log into the system with valid user name and password. ‐ 1. Tutor clicks upload course material. 2. System displays all the courses that particular tutor teaches. 3. Tutor clicks one course name.
4. System displays a page with the space for upload and textbox to key in the document name together with an upload button. 5. Tutor selects document from his computer. 6. Tutor clicks upload button 7. System adds the document into database. Use Case ID: Use Case Name: Created By: Date Created:
11 Conduct online course WENKE 26/08/09
Last Updated By: WEN KE Date Last Updated: 27/08/09
Actors: Description: Trigger: Preconditions:
Tutor To allow tutor to start online course. ‐ 1. Tutor must login system with valid user name and password. 2. Both computers from student and tutor must fulfill system requirements for online tutoring. Postconditions: Tutor and student attendance will be marked. Normal Flow: 1. Tutor presses conduct course button on the main menu 2. Tutor check whether student is ready to start the course 3. If student is ready, tutor press Start course button
3. Committee Roles and Responsibilities Name/Title
Role
Arnav Singh / Team leader
He is in-charge of the project and he reports to the higher management regarding the status of the project. He also delegates task to the team member.
Responsibilities
Coordinates meetings with the clients, project team (functional management) to discuss project impediments, needed resources or issues/delays in completing the task.
Coordinate the review, presentation and release of design layouts, drawings, analysis and other documentation.
Approve the documents and work done by team members.
Help keep the team focused and on track.
Provide the team with a vision of the project objectives.
Strive for team consensus and win‐win agreements.
Facilitate problem solving and collaboration.
Ensure discussions and decisions lead toward closure.
Familiarize the team with the customer needs, specifications, design targets, the development process, design standards, techniques and tools to support task performance.
Assure that the team addresses all relevant issues within the specifications and various standards.
Name/Title
Role
Lwi Tiong Chai / Secretary
Maintain the minutes and integrate all the essential documents.
Responsibilities
Assist and collaborate with the team leader.
Note down the details during discussions and meetings.
Keep a record of the minutes and task at hand.
Prepare the meeting.
Ensure team members turn up for the meeting.
Name/Title
Role
Tan Koon Liang / Content Manager
Maintain the developer blog and ensure that the content in the blog is updated regularly and up to date.
Responsibilities
Get information from team leader and update the blog.
Post announcement on the blog.
Upload content to the blog.
Name/Title
Role
Abdul Haleem / SRS In Charge
In-charge of the Software Requirement Specification (SRS).
Responsibilities
Research and analyse the information regarding the project.
Assist and collaborate with the team members.
Take note of the needs and desires of the stakeholders.
Name/Title
Role
Liu Wei / SRS Vetter
Vet and verify the Software Requirement Specification (SRS).
Responsibilities
Regularly review the SRS and make sure that the information is relevant.
Provide feedback to the SRS IC.
Name/Title
Role
Hu Yuanling / UML Diagram
In-charge of the Models, Diagrams and Descriptions.
InCharge Responsibilities
Produce and ensure the diagrams for the SRS such as UML activity, use case, class, object and package diagrams and their corresponding descriptions.
To produce the Software Design Document.
Name/Title
Role
Wen ke / UML Diagram Vetter
Vet the Models, Diagrams and Descriptions.
Responsibilities
Verify and validate preliminary and final design.
Provide feedback to Diagram IC.
Name/Title
Role
Biju Joseph Jacob / Developer IC
In-charge of the implementation of the design of the software.
Responsibilities
Provide technical expertise and spearhead the development of the software.
Consolidation and integration of all the source code.
Produce and regularly update the technical documentation.
4. Enhanced Waterfall Incremental Model (Customized model component for team productivity, quality and efficient process flow) Gantt chart Iterative Process
Blog
Documentation
Iterative Process
Prototype and software delivery
Customised Project Gantt– A customised project gantt chart is drafted to illustrate the project schedule for our team – Techno Fusion, delivering software with precision and passion. The Gantt chart consist of the work breakdown structure of the project based on the software model adopted, client meeting date so that we will be to check our progress and be in due course in completing our project. The management will progressively update the schedule to meet the demand of the client. Content Management @ Blog – Techno Fusion blog is setup as a platform for team members to synchronise information, updating each other of progress and milestones. Techno Fusion management has devised a strategy to effectively organise contents in the blog. 1) Deliverables Folder (contains deliverables documents for clients and team members) 2) Source Folder (contain all documents to produce deliverables) We will also using the platform as a communication tool to collaborate and make announcements i.e leader broadcasting milestones. The URL for the blog is as follows: http://interactivelearningmanagementsystem.blogspot.com/
Documentation – We believe the importance of documentation - describe the progress of software development and as we adopted SDLC and Gantt chart closely. It serve as a tool to also inform and guide team members on the project current status ensure that the progress is smooth throughout the software development phase.
5.
Glossary
Term Central Management Parent Student Tutor Tuition Consortium Tuition Agency
Definition Consists of staff at the consortium that manages the iLMS. Parent of the student that interacts with the iLMS. Student that uses the iLMS to fulfill their tuition needs. Tutors are an agency staff member that teaches the students. A consortium that manages a list or a group of tuition agencies. A agency that provides resources to tutor academically challenge students.
6.
References
Document No.
Document Title
Date
Author
1.
Introduction to Software Engineering Design Processes,Principles, and Patterns with UML2 UML Distilled Third Edition
20/08/2009
Christoper Fox
20/08/2009
Martin Fowler
2.
7.
Revision History
Version
Date
Name
Description
1.0
28
Preliminary SRS
Requirement analysis from client
TEAM 7 (Techno Fusion) Deliver software with precision and passion PRELIMINARY SOFTWARE REQUIREMENTS SPECIFICATION Version 1.0
Customized Project Gantt Chart
1