Home Realty System
Use-Case Specification: Search For A Home 

Version <1.0>




Table of Contents
1.	Search For A Home	3
1.1	Brief Description	3
2.	Flow of Events	3
2.1	Basic Flow	3
2.2	Alternative Flows	4
2.2.1	No homes in search criteria	4
3.	Special Requirements	4
4.	Pre-Conditions	4
5.	Post-Conditions	4
6.	Extension Points	4


Use-Case Specification: Search For A Home 

1.	Search For A Home
1.1	Brief Description
This use case allows the Prospective Buyer to search for a home that is 
currently for sale. Listed homes can be those that are listed with BC Realtors 
and other homes that are part of the Multiple Listing Service (MLS). Information 
on the home is made available to the Prospective Buyer, and the Prospective 
Buyer can contact the listed Realtor for additional information on any of the 
homes.

2.	Flow of Events
2.1	Basic Flow 
This use case begins when the Prospective Buyer (customer) selects the "Find A 
Home" option on the main web page.
1.	The customer selects the state where they want to search. The system 
creates a list of all cities in the state that BC Realtors has property listed 
in.  
2.	The customer then has three options to further specify their property 
search: search by city, search by zip code, search by MLS number. The customer 
enters search criteria into one of the three search fields and asks the system 
to retrieve a list of homes.
3.	The system searches the database for properties that fit the criteria 
supplied by the customer. The system provides the number of homes that were 
returned in the search. The customer can now perform a more detailed search on 
this subset of homes. Search criteria include: price range, number of bedrooms, 
square footage, home type, exterior features, lot size, and interior features.  
If the customer has already created a Personal Planner profile, then the system 
will automatically fill in the search criteria specified in the Personal 
Planner. The customer can then further refine the search criteria.
4.	The system retrieves a final list of homes that fulfill the detailed 
search criteria. The system will display a full description of the home (price, 
square footage, number of rooms, age, lot size, and so on), a picture of the 
home, neighborhood information, city information, and school district 
information.
5.	The customer selects the home that they would like more information on. 
The system saves a reference to this home in the customer's personal planner and 
provides a payment estimate.
6.	The system opens a window to allow the customer to send an e-mail message 
to the listing real-estate agent.  The window will prompt the user for their 
name and e-mail address. The customer creates a text message and sends the e-
mail to the agent.
7.	The system creates a follow-up e-mail and has it sent to the customer. The 
e-mail will thank the customer for using the BC Realty System and inform them 
that real-estate agent "X" should be in contact with them in the next twenty-
four hours.
8.	The system returns the customer to the list of homes.    




2.2	Alternative Flows
2.2.1	No homes in search criteria
If, in the Basic Flow, there are no homes that fit the search criteria provided 
by the Prospective Buyer, the system will display a dialog that informs the 
customer that no listings met their criteria. At this point, the user has the 
option to modify their current selection criteria or start a new search.
2.2.1.1	Customer does not have a Personal Profile created
If, in the Basic Flow, the customer has not created a personal profile, the 
system will prompt the user to create one. If the customer decides on creating a 
personal profile, then the Maintain Personal Planner use case will be executed. 
If the customer opts to not create a personal profile the use case will end.

3.	Special Requirements
None.
4.	Pre-Conditions
None.
5.	Post-Conditions
If the use case is successful, the Prospective Buyer will have a new listing 
added to their Personal Planner. Otherwise, the system state is unchanged.
6.	Extension Points
None.



