Start new tenancy wizard

[jpreecedev]

Need to be able to create a new tenancy.

The tenancies manager would capture the following information, in a sequence of steps;

1. The property the tenancy applies to
2. Type of tenancy (Agricultural, Assured, AST, Common Law, Licence, Regulated)
3. Start date
4. End date (perhaps from a list, 3 months, 6 months etc)
5. Rent payment amount
6. Rent payment frequency (Per week, 2 weekly, 4 weekly, monthly, 3 monthly, 6 monthly, annually)
7. The tenants payment reference
8. Capture the tenants details (All tenants)
9. Capture the dates when rent payments are due

[jpreecedev]

This is best suited to a wizard

[jpreecedev]

The wizard should look like this;

• Announcement - Initial overview step, that advises what information will be collected
• Property - Which property is being tenanted? What does the tenancy agreement look like?
• Tenants - Capture name of each tenant, contact information etc
• Payment - How much is the rent and how often will it be collected?

[jpreecedev]

The data is a bit all over the page at the minute. When the StartTenancy view is instantiated, a request should be made to the server to fetch the view data. View data should consist of all the default values for a select lists etc. View data should also consist of a tenancy object that will be used later to persist the tenancy created by this wizard.

Once the view data is retrieved, it should be passed to the Store, and not managed by the StartTenancy view. Each field should trigger a store update so that state is managed centrally.

[jpreecedev]

Once all the data has been collected and validated, the tenancy should be created.

The creation process would look like this;

• StartTenancyViewModel should be returned to the server. This will consist of the Tenancy entity, a list of Tenant entities, each Tenant should have at least one address TenantAddress.
• On the server, each entity should be saved (the tenancy, tenant and tenant address) and then a link should be added to TenancyTenant to create a relationship between Tenancy and Tenant

[jpreecedev]

Regarding each tenant, we need to also capture the following information;

• Occupation
• Company name
• Work telephone
• Work address
• Previous addresses (last 3 years)
• Identification (driving license, passport etc) .. possibly allow a scanned copy to be uploaded
• Smoker?
• Has pets?
• Any other information
• Referees
• Emergency contacts
• Next of kin

[jpreecedev]

Outstanding issue is related to server side validation. We have validation attributes on the TenantViewModel and Tenant classes. The problem with this is that if the "occupier" is a child then a lot of the fields don't apply.

[jpreecedev]

Might be able to steal code for custom validation attributes from here. https://foolproof.codeplex.com/SourceControl/latest#Foolproof/RequiredIf.cs

[jpreecedev]

Ignore the last comment don't think that is going to work

[jpreecedev]

Potentially good solution; https://stackoverflow.com/questions/3400542/how-do-i-use-ivalidatableobject#answer-42519662

[jpreecedev]

https://gist.github.com/jpreecedev/62d90e210e572b5643b0f729553264a3