Skip to content

Manage: Creating a new organization

Pre-requisites

  1. Preferably have the logo of the new company handy

Create a new organization in Manage

Note: db_object_uuid in main.go is the same as the org uuid in the Clickup ticket.

  1. Copy the organization-block template "Demo Company" from Attracs/attracs-manage/blob/master/main.go and change it's information to fit your new organization.
    1. Change the UUID! When generating or copying from a ticket the new UUID for the company, search through the main.go file to make sure there are no duplicates!!
    2. Example Demo Company template 
      attracs.Organization{
        DB_OBJECT_UUID: attracs.NewDatabaseObjectUUID("b6fb31e8-35ce-4645-bb28-d8a43d8d1b4f"),
        Name:           "Demo Company",
        Website:        "https://attracs.com",
        EmailDomains:   attracs.StringList{"@attracs.com"},
        Picture:        "https://storage.googleapis.com/attracs/media/images/logos/attracs_200x200.png",
},
  2. Open the Manage organization file and continue to the next step:
    1. The location on the file of where you should add this organization block is described in the next step, depending if you're adding a Nightly-org or if your adding a Stable-org or promoting a Nightly-org to Stable.

Nightly-specific steps

  1. Add your organization block under this section, to the end of the list: 
    // orgs only in localhost dev and nightly: promote to above list when needed in stable
if Framework.HostInfo.IsLocalhost() || Framework.Params.Nightly {
        orgs = append(orgs,
    1. Make sure you are adding the new organization under organizations and not under applications! Application blocks start with manage.Application{, organization blocks start with attracs.Organization{.
  2. Create a PR and get it approved.
  3. Nightly only: wait for the Github CI to complete. Restart and run the populate-orgs command for the manage-nightly applications in Managevisor one by one. You can click the input line in the Managevisor shell to start writing
    1. After restarting, when you see this message in the shell, the application is working normally: 
      [mhttp]: Listening to 0.0.0.0:5006 for HTTP as manage-nightly.attracs.com (reverse proxy)

Stable-specific steps

TODO: Unsure how much this is different from nightly steps

Create a new organization continued

  1. Upload logo to Google Cloud storage as transparent png and set permissions to public
    1. Location is at "no org" âžť attracs services âžť cloud storage âžť attracs/media/images/logos
    2. Upload logo file
    3. edit permissions add public , allusers, reader
    4. then copy URL and add it to manage organisation
  2. Using Manage:
    1. Admin page:
      1. Add yourself as system admin to the organization
      2. Enable required applications for your organization:
        1. https://manage-nightly.attracs.com/admin#organizations âžť select organisation you want âžť applications and click slider to enable.
    2. CITY-SPECIFIC configuration: Non-admin organization page:
      1. Set organization member properties: tmsOperator explained:

        TMS Operator on palvelukeskuksille. Ulkoisille käyttäjille kuten autoilijoille ei sitä laiteta päälle. Kun minulla ei ole sitä niin en pääse mihinkään työkaluihin vielä sisään.

        1. name: tmsOperator, 2. Displayname: TMS Operator, 3. Description: -, 4. Visibility: Admin, 5. User editable: False, 6. type: Boolean, 7. Has Default value: True, 8. Default value: False
      1. Add yourself to organisation from https://manage-nightly.attracs.com/admin#organizations âžť org you created âžť ADD MEMBERS âžť your account email. 2. Add person who will be admin on the org
    1. Create new teams to access TMS -applications. (If the new admin person doesn't do this)

Note: Apparently some applications require that an org-specific JSON file is present in tms-booking/server/data/conf_org, otherwise the application pages refuse the load, showing only a gray page.

Subpages