public Tenant ProvisionTenant(
string tenantName,
string tenantDescription,
FullName administorName,
EmailAddress emailAddress,
PostalAddress postalAddress,
Telephone primaryTelephone,
Telephone secondaryTelephone)
{
try
{
// must be active to register admin
var tenant = new Tenant(tenantName, tenantDescription, true);
this.tenantRepository.Add(tenant);
RegisterAdministratorFor(tenant, administorName, emailAddress, postalAddress, primaryTelephone, secondaryTelephone);
DomainEventPublisher.Instance.Publish(new TenantProvisioned(tenant.TenantId));
return tenant;
}
catch (Exception e)
{
throw new InvalidOperationException(
"Cannot provision tenant because: "
+ e.Message);
}
}
void RegisterAdministratorFor(Tenant tenant, FullName administorName, EmailAddress emailAddress, PostalAddress postalAddress, Telephone primaryTelephone, Telephone secondaryTelephone)
{
var invitation = tenant.OfferRegistrationInvitation("init").OpenEnded();
var strongPassword = new PasswordService().GenerateStrongPassword();
var admin =
tenant.RegisterUser(
invitation.InvitationId,
"admin",
strongPassword,
Enablement.IndefiniteEnablement(),
new Person(
tenant.TenantId,
administorName,
new ContactInformation(
emailAddress,
postalAddress,
primaryTelephone,
secondaryTelephone)));
tenant.WithdrawInvitation(invitation.InvitationId);
this.userRepository.Add(admin);
var adminRole = tenant.ProvisionRole("Administrator", "Default " + tenant.Name + " administrator.");
adminRole.AssignUser(admin);
this.roleRepository.Add(adminRole);
DomainEventPublisher.Instance.Publish(new TenantAdministratorRegistered(tenant.TenantId, tenant.Name, administorName, emailAddress, admin.Username, strongPassword));
}
public ContactInformation ChangeEmailAddress(EmailAddress emailAddress)
{
return new ContactInformation(
emailAddress,
this.PostalAddress,
this.PrimaryTelephone,
this.SecondaryTelephone);
}
public ContactInformation(
EmailAddress emailAddress,
PostalAddress postalAddress,
Telephone primaryTelephone,
Telephone secondaryTelephone)
{
this.EmailAddress = emailAddress;
this.PostalAddress = postalAddress;
this.PrimaryTelephone = primaryTelephone;
this.SecondaryTelephone = secondaryTelephone;
}
public UserRegistered(
TenantId tenantId,
String username,
FullName name,
EmailAddress emailAddress)
{
this.EmailAddress = emailAddress;
this.EventVersion = 1;
this.Name = name;
this.OccurredOn = DateTime.Now;
this.TenantId = tenantId.Id;
this.Username = username;
}
public TenantAdministratorRegistered(
TenantId tenantId,
string name,
FullName administorName,
EmailAddress emailAddress,
string username,
string temporaryPassword)
{
this.AdministorName = administorName;
this.EventVersion = 1;
this.Name = name;
this.OccurredOn = DateTime.Now;
this.TemporaryPassword = temporaryPassword;
this.TenantId = tenantId.Id;
}
public EmailAddress(EmailAddress emailAddress)
: this(emailAddress.Address)
{
}
private void RegisterAdministratorFor(
Tenant tenant,
FullName administorName,
EmailAddress emailAddress,
PostalAddress postalAddress,
Telephone primaryTelephone,
Telephone secondaryTelephone)
{
RegistrationInvitation invitation = tenant.OfferRegistrationInvitation("init").OpenEnded();
string strongPassword = new PasswordService().GenerateStrongPassword();
// Publishes domain event UserRegistered.
User admin = tenant.RegisterUser(
invitation.InvitationId,
"admin",
strongPassword,
Enablement.IndefiniteEnablement(),
new Person(
tenant.TenantId,
administorName,
new ContactInformation(
emailAddress,
postalAddress,
primaryTelephone,
secondaryTelephone)));
tenant.WithdrawInvitation(invitation.InvitationId);
// Since this is a new entity, add it to
// the collection-oriented repository.
// Subsequent changes to the entity
// are implicitly persisted.
this.userRepository.Add(admin);
// Publishes domain event RoleProvisioned.
Role adminRole = tenant.ProvisionRole(
"Administrator",
string.Format("Default {0} administrator.", tenant.Name));
// Publishes domain event UserAssignedToRole,
// but not GroupUserAdded because the group
// reference held by the role is an "internal" group.
adminRole.AssignUser(admin);
// Since this is a new entity, add it to
// the collection-oriented repository.
// Subsequent changes to the entity
// are implicitly persisted.
this.roleRepository.Add(adminRole);
DomainEventPublisher
.Instance
.Publish(new TenantAdministratorRegistered(
tenant.TenantId,
tenant.Name,
administorName,
emailAddress,
admin.Username,
strongPassword));
}
/// <summary>
/// Creates a new <see cref="Tenant"/>, stores it in
/// its <see cref="ITenantRepository"/> instance, and
/// publishes a <see cref="TenantProvisioned"/> event,
/// along with requisite domain events for the creation
/// of a <see cref="User"/> and <see cref="Role"/>
/// for default administration of the new tenant.
/// Refer to remarks for details.
/// </summary>
/// <param name="tenantName">
/// The <see cref="Tenant.Name"/> of the new tenant.
/// </param>
/// <param name="tenantDescription">
/// The <see cref="Tenant.Description"/> of the new tenant.
/// </param>
/// <param name="administorName">
/// The <see cref="Person.Name"/> of the
/// default administrator for the new tenant.
/// </param>
/// <param name="emailAddress">
/// The <see cref="Person.EmailAddress"/> of the
/// default administrator for the new tenant.
/// </param>
/// <param name="postalAddress">
/// The <see cref="ContactInformation.PostalAddress"/>
/// of the default administrator for the new tenant.
/// </param>
/// <param name="primaryTelephone">
/// The <see cref="ContactInformation.PrimaryTelephone"/>
/// of the default administrator for the new tenant.
/// </param>
/// <param name="secondaryTelephone">
/// The <see cref="ContactInformation.SecondaryTelephone"/>
/// of the default administrator for the new tenant.
/// </param>
/// <returns>
/// The newly registered <see cref="Tenant"/>,
/// which has already been added to the internal
/// <see cref="ITenantRepository"/> instance.
/// </returns>
/// <remarks>
/// <para>
/// The events published, in order, are:
/// </para>
/// <list type="bullet">
/// <item><description><see cref="UserRegistered"/></description></item>
/// <item><description><see cref="RoleProvisioned"/></description></item>
/// <item><description><see cref="UserAssignedToRole"/></description></item>
/// <item><description><see cref="TenantAdministratorRegistered"/></description></item>
/// <item><description><see cref="TenantProvisioned"/></description></item>
/// </list>
/// </remarks>
public Tenant ProvisionTenant(
string tenantName,
string tenantDescription,
FullName administorName,
EmailAddress emailAddress,
PostalAddress postalAddress,
Telephone primaryTelephone,
Telephone secondaryTelephone)
{
try
{
// must be active to register admin
Tenant tenant = new Tenant(this.tenantRepository.GetNextIdentity(), tenantName, tenantDescription, true);
// Since this is a new entity, add it to
// the collection-oriented repository.
// Subsequent changes to the entity
// are implicitly persisted.
this.tenantRepository.Add(tenant);
// Creates user and role entities and stores them
// in their respective repositories, and publishes
// domain events UserRegistered, RoleProvisioned,
// UserAssignedToRole, and TenantAdministratorRegistered.
this.RegisterAdministratorFor(
tenant,
administorName,
emailAddress,
postalAddress,
primaryTelephone,
secondaryTelephone);
DomainEventPublisher
.Instance
.Publish(new TenantProvisioned(
tenant.TenantId));
return tenant;
}
catch (Exception e)
{
throw new InvalidOperationException(
string.Concat("Cannot provision tenant because: ", e.Message), e);
}
}
public EmailAddress(EmailAddress emailAddress)
: this(emailAddress.Address)
{
}