For Societies' Executive Committees

Prerequisite

You may need a personal or society's account for

• Microsoft Azure (please note that the school account (1155xxxxxx@link.cuhk.edu.hk) is not applicable)
• Heroku
• Github

Setup procedure

1. Fork this repository
2. On Heroku, create a new app with a custom name, choose the region United States
3. 1. At the new app's dashboard
   2. Go to Overview tab
   3. Click Configure Add-ons
   4. Input Heroku Postgres at the add-on section
   5. Choose the plan Hobby Dev - Free and then submit
4. 1. Go to Deploy tab
   2. Choose Github as the deployment method
   3. Link your Github account with Heroku
   4. choose the forked repo
   5. Deploy the branch master (or main) manually
   6. Wait until the deployment finished (it may take serval minutes)
5. Goto https://your-app-name.herokuapp.com (remember to replace with your app name) to test the deployment
6. If successful, you will be at the Initialise Client keys page
7. 1. Open Azure on another window, make sure the language is English
   2. Search App registrations
   3. Click New registration
   4. Setup the display name for your application
   5. Choose Accounts in any organizational directory (Any Azure AD directory - Multitenant) for Supported account types
   6. At Redirect URI insert https://your-app-name.herokuapp.com/api/login (remember to replace with your app name)
   7. Click Register
   8. Copy Application (client) ID and paste it onto the Client ID field on the Initialise Client keys page
   9. On the Azure's page, find and go to Certificates & secrets on the left panel
   10. Go to section Client secrets and click New client secrets
   11. Input a custom description and choose the exire time as Never
   12. Click Add
   13. Copy the Value and paste it onto the Client Secret field on the Initialise Client keys page
   14. Click the Initialise button on the Initialise Client keys page
8. Login with your CUHK link account
9. Accept the permission request if applicable
10. Set yourself as an executive by inputing your nickname and position
11. Import members and setup other admins
12. Done

For Developers

Setup procedure

1. Install postgresql, node.js and yarn
2. Put a .env file in root following the variables in .env.example
3. Run yarn install to install all dependencies
4. Run yarn newdb set up the database
5. Run yarn release to generate sync the database and generate jwt secret
6. Run yarn dev to start the server

Useful docs

• Soc-admin
• Database: Sequelize / Umzug
• Backend: Graphql / Apollo Server
• Frontend: Apollo Client / Next / React / react-bulma-components / Bulma
• Miscellaneous: Axios / Typescript / Jest