Faculty of Engineering and Information Technology School of Computer Science
Due date Demonstration Weight Groupwork Submission Submit to
Summary
31927 – Application Development with .NET 32998 - .NET Application Development
SPRING 2024 ASSIGNMENT 1 – SPECIFICATION
Monday 23 September 2024, 11:00am
Required in the lab/tutorial session
35%
Individual
Complete project folder zip Canvas
In this assignment, you are required to model the dotnet Hospital Management System by developing a console application using C#.
The application should have appropriate data structures to distinguish between a Doctor, Administrator and Patient as well as store the necessary links between them (such as an appointment, between a Doctor and a Patient). You are given complete control in how you create these data structures, but guidance has been given overpage.
Objects should be stored in the system and also written to .txt files such that the system can read them in and regenerate existing objects on load. This is mandatory.
Students will need to submit the complete project folder in zip format, which will have the complete C# code, solution file, data file, etc. required to run/test the program. Any special instructions required to run the code has to be provided in a text file. Submitting a lone “.exe” is not acceptable.
Assignment Objectives:
The purpose of this assignment is to demonstrate competence in the following skills:
-
Ensure firm understanding of the .NET framework, C# basics and C# syntax
-
Understand how the .NET framework implements OO concepts and the implications this has for
new language design
-
Array and string manipulation
-
Creating custom classes and methods in C#
-
File reading, writing and manipulation in C#
-
Creating interactive console applications
-
Creating good OO design.
Program and data structures:
-
How you structure the classes in your program is your choice. One thing you are not allowed to do is make your program fully contained inside Program.cs, or any single class.
-
In the dotnet Hospital Management System, a user can log in as either a Patient, a Doctor, or an administrator. These are different roles, which would store different information, and would have a different menu. Your code structure should reflect this.
Assignment -1 Spring 2024 1
-
Additionally, your code will need to generate Appointments. An appointment would need a reference to a single Doctor and a single Patient; your code structure should reflect this. You do not need to manage Dates/times for appointments (or anywhere, for that matter) in your code. This may result in appointments being difficult to distinguish and sort; you will not be marked down for this.
-
Every patient, doctor and admin, has a unique ID. This ID should be an integer of reasonable length (5-8 digits). This can be randomly generated, or incremental, but it should be generated by the system on object creation, not chosen/inputted by the user.
Further recommendations:
-
Objects will need to be printed out one by one, it’s recommended that each data structure has a toString() function which compresses the notable data of the class into a succinct line.
-
Each role should be its own class and it should have its own MainMenu method, don’t try and create separate versions of the menu in Program.cs.
-
Don’t get confused by Administrators. Doctors and Patients can’t at any stage have “admin privileges”; the administrator is a completely separate entity.
-
You may find it useful to abstract common functionality into its own class, such as a FileManager class with static read and write methods or a Utils class which contains the methods to generate ID’s and filter lists.
Assignment -1 Spring 2024 2
Marking Guide
Below is the marking guide for this assessment. It is designed to allow you to get a Pass grade with minimal effort while still demonstrating that you understand the core principles of .NET development, to get a Distinction with reasonable effort, and to get a High Distinction with solid effort, and 100% with considerable effort. It is recommended that you pay attention to the grade distribution and work towards your own skill level.
In the demos in the lab, your code needs to be compiled in Visual Studio Community edition 2022 and then the tutor will test for normal functionality as described in the descriptions above. If your code does not compile you will receive zero marks (no exceptions).
Task
Console Code and Design
Login Menu
Patient Menu
Doctor Menu
Admin Menu
Logout/Exit
Bonus Marks
Items Max Point
-
- Appropriate Headings for menus
-
- Basic console design
-
- Helpful comments
-
- Appropriate indenting and whitespacing 2
-
- Consistent and appropriate C# naming convention used
Appropriate use of exception handling 2 Low coupling, high cohesion, general code quality 2 Functionality including cross checking credentials with .txt file 1.5 Password input masked in console 1.5 List Patient Details 1 List My Doctor Details 1 List All Appointments 1 Book Appointment, functionality including creating
2
Total
14
3
5
5
7
1
35
5
2
OOP principles used:
|
6 |
Appointment object and writing to txt file
List Doctor Details 1
List Patients 1
List Appointments 1
Check Particular Patient 1
List Appointments With Patient 1
List All Doctors 1
Check Doctor Details 1
List All Patients 1
Check Patient Details 1
Add Doctor 1.5
Add Patient 1.5
Logout functionality and Exit functionality for all 3 menus 1
Maximum Full Marks
- Use of one example of anonymous method
- Use of one example of generic 3
- Use of one example delegates
Email functionality (e.g. confirmation of patient registration, or 1
confirmation of booking)
Additional user role (e.g. receptionist) 1
Specific expected tasks and examples
In this assignment, you are required to develop a console-based, menu driven hospital management system using C#. Necessary data should be stored in “.txt” files. There are 3 core roles in the system.
1. Patient
2. Doctor
3. Administrator
Each of these roles have their own version of the menu with it’s own subset of menu options.
Login Menu
The user should be presented with this menu on program startup and cannot proceed further without
entering valid login details.
Input fields:
-
- ID: Display the typed characters as is
-
- Password: Display “*” instead of the actual
characters
ID and password should be checked against valid
credentials inside your files. How you do this depends
on how you’ve structured your classes; but any
patient/doctor or admin should have a unique ID and a
password. These values should be, in some way,
stored in a .txt file, which your code should cross check at this screen. If entered values are not valid, display appropriate error message and allow the user to retry.Patient Menu
The patient menu should have all of the following menu options (see right).
All menu options MUST share this functionality (see example below):
-
Console is emptied to display new data
-
Appropriate heading displayed before data
printed
-
Error handling for bad user input
-
Menu should never return itself, the user
should be able to press a single key to return.
List Patient Details Functionality: Lists all the fields of the currently logged in patient to the console. Input: Key press to return to menu. |
||
Assignment -1 Spring 2024 5
List My Doctor Details
Functionality: Lists all the fields of the doctor that is registered with the currently logged in patient, to the console. It is recommended that the Doctor data structure has a toString function which compresses the necessary details of the patient into a short line.
Input: Key press to return to menu.
List All Appointments
Functionality: Lists the details of all past appointments involving the currently logged in patient.
Input: Key press to return to menu.
Book Appointment
Functionality: Prompts the user for all the necessary information to generate a new appointment. This must be done with the doctor registered to the user. If the user has not registered to a doctor, they should be prompted to choose from a list of all doctors and register.
Input:
-
Integer to select doctor (if
applicable)
-
All necessary information to
generate your Doctor data
structure
-
Key press to return to menu.
Assignment -1 Spring 2024 6
Functionality: Returns to the login menu
Logout
Functionality: Exits the application
Exit
Doctor Menu
The doctor menu should have all of the
following menu options (see right)
All menu options MUST share this
functionality:
-
Console is emptied to display new data
-
Appropriate heading displayed before data printed
-
Error handling for bad user input
-
Menu should never return itself, the
user should be able to press a single key to return.
List Doctor Details
Functionality: Lists the fields of the currently logged in doctor to the console.
Input: Key press to return to menu.
List Patients
Functionality: Lists a shorthand outline of every patient that is registered with the currently logged in doctor to the console, line by line. It is recommended that the Patient data structure has a toString function which compresses the necessary details of the patient into a short line.
Input: Key press to return
to menu.
Assignment -1
Spring 2024 7
List Appointments
Functionality: Lists every appointment involving the currently logged in doctor, regardless of which patient is involved, to the console, line by line. It is recommended that that the Appointment data structure has a toString function which compresses the necessary details of the appointment into a short line.
Input: Key press to return to menu.
Check Particular Patient
Functionality: Prompts the user for an ID and prints the details of the patient whose ID it belongs to, to the console line by line. If there is no patient with that ID, your code should handle the error and print an appropriate error message. It is your choice whether the user is prompted to re-enter the ID or if the program returns to the Patient menu.
Input: Key press to return to menu.
List Appointments With Patient
Functionality: Prompts the user for an ID and finds the patient with that ID. Your code should then print every appointment between that patient and the currently logged in doctor. (You should not need to filter this list, as the patient should have been forced to be registered to only 1 doctor). If there is no patient with that ID, your code should handle the error and print an appropriate error message. It is your choice whether the user is prompted to re-enter the ID or if the program returns to the Patient menu.
Input: Key press to return to menu.
Assignment -1 Spring 2024 8
Functionality: Returns to the login menu
Logout
Functionality: Exits the application
Exit
Administrator menu
The administrator menu should have all of
the following menu options (see right)
All menu options MUST share this
functionality:
-
Console is emptied to display new data
-
Appropriate heading displayed before data printed
-
Error handling for bad user input
-
Menu should never return itself, the
user should be able to press a single key to return.
List All Doctors
Functionality: Lists a shorthand version of every doctor contained in the system to the console, line by line. It is recommended that the Doctor data structure has a toString function which compresses the necessary details of the doctor into a short line.
Input: Key press to return to menu.
Assignment -1
Spring 2024 9
Check Doctor Details
Functionality: Prompts the user for an ID and prints the details of the doctor whose ID it belongs to, to the console line by line. If there is no doctor with that ID, your code should handle the error and print an appropriate error message. It is your choice whether the user is prompted to re-enter the ID or if the program returns to the Administrator menu.
Input: Key press to return to menu.
List All Patients
Functionality: Lists the shorthand version of every patient in the system to the console, line by line. It is recommended that the Patient data structure has a toString function which compresses the necessary details of the patient into a short line.
Input: Key press to return to menu.
Check Patient Details
Functionality: Prompts the user for an ID and prints the details of the doctor whose ID it belongs to, to the console line by line. If there is no doctor with that ID, your code should handle the error and print an appropriate error message. It is your choice whether the user is prompted to re-enter the ID or if the program returns to the Administrator menu.
Input: Key press to return to menu.
Assignment -1 Spring 2024 10
Add Doctor
Functionality: Prompts the user for all the necessary data needed to generate a new Doctor and add it to the system.
Input: Key press to return to menu.
Add Patient
Functionality: Prompts the user for all the necessary data needed to generate a new Patient and add it to the system.
Input: Key press to return to menu.
Functionality: Returns to the login menu
Logout
Functionality: Exits the application
Exit
Assignment -1 Spring 2024 11
Additional Information:
Assignment Submission
You must upload a zip file of the C# solution to Canvas. This must be done by the Due Date. You may submit as many times as you like until the due date. The final submission you make is the one that will be marked. If you have not uploaded your zip file within 7 days of the Due Date, or it cannot be compiled and run in the lab, then your assignment will receive a zero mark
-
NOTE 1: It is your responsibility to make sure you have thoroughly tested your program to make sure it is working correctly.
-
NOTE 2: Your final submission to Canvas is the one that is marked. It does not matter if earlier submissions were working; they will be ignored. Download your submission from Canvas and test it thoroughly.