Revision as of 16:59, 24 July 2017

Overview

Background

A domain model in problem solving and soJware engineering is a conceptual model of all the topics related to a specific problem. It describes the various entities, their attributes, roles, and relationships, plus the constraints that govern the problem domain.

• Background reading material:
  • "Domain Models" lecture slides
  • Domain modeling for software engineering by N. Iscoe, G.B. Williams, and G. Arango
• Rationale for this activity: Use cases and later development artifacts are easier to develop once the domain model is clearly delimited.

Directions

• In the lecture "Domain Models" we learned about how to develop domain models for a system under development. In this activity, you will reengineer a domain model for the OpenMRS system.
• Make a list of candidate domain classes - identify nouns.
• Draw these classes in a UML class diagram.
• If possible, add brief descriptions for the classes.
• Identify any associations that are necessary.
• Decide if some domain classes are really just attributes.
• Where helpful, identify role names and multiplicity for associations.
• Add any additional static rules as UML notes that cannot be conveyed with UML symbols.
• Group diagrams/domain classes by category into packages.
• Diagrams have to be accompanied by explanatory text. It will not be possible to transport all the information you want in a diagram with only little “bubbles” and arrows, so please write a few paragraphs that help understand how to read and understand your diagram and the goals in there. In that description, also make clear which stakeholder is the issuer of that goal.
• Please also provide your description of the rationale for your process, at least two paragraphs of how you did it and what you found difficult or the most challenging aspect of it.

Deliverables

• A PDF of a UML domain model with explanatory text and a reflection on the work results.

Notes for Instructors

The remaining sections of this document are intended for the instructor. They are not part of the learning activity that would be given to students.

Assessment

• How will the activity be graded?
  • The deliverable will be graded as one part of the requirements specification.
• How will learning will be measured?
  • The quality of the application of the learned technique gives an indicator of how well the student has understood the technique and depending on the instructor, there can be a resubmission of the deliverable after initial feedback, so that the learning and the grade can be improved.
• How will feedback to the student be determined?
  • The student receives written feedback on their submission.
  • Submitted solutions can be discussed in class (probably anonymizing them, according to classroom code of conduct)

Assessment questions:

• Can I (picturing myself as a developer) easily understand what the domain is about?
• Do I see what the most important other systems are?
• Is the model described and illustrated to an adequate degree of detail?
• Is a description provided about the rationale and challenges?

The form of the assessment is expected to vary by assignment. One possible format is the table:

Comments

• What should the instructor know before using this activity?
  • This activity is simple and easy to handle for most students.
• What are some likely difficulties that an instructor may encounter using this activity?
  • None encountered.

Suggestions for Open Source Community

None so far.

Additional Information

This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License