sean-perkins / eventforce

Salesforce Event Management app built with NodeJS and Angular (4+); deployed on Heroku.

A Salesforce integration built on-top of NodeJS and Angular (4+). The integration allows Salesforce administrators to create events, sessions and attendees through their Salesforce instance. Users (non-salesforce) can view available events and event details through the Angular app. They may register to an event, which will tie back into the Salesforce environment.

Technologies

• Angular (4+)
• NodeJS
• Protractor/Jasmine (Testing)
• TypeScript
• RxJS (@ngrx in Angular)
• JSForce (connect NodeJS to SalesForce API)

Getting Started

1. Run npm run setup from the root directory.
2. Run npm start.server to initialize the server locally at http://localhost:3000.
3. Build the front-end with npm run build.client.
4. Optional: If developing you can use the proxy with npm run start.client and opening up http://localhost:4200.

Example Images

SalesForce Schema

Event

The representation of events that users can register to.

Field Label	API Name	Data Type	Description
Event Name	Name	Text(80)	The Event's displayed name.
Description	Description__c	Rich Text Area(32768)	The description of the event.
Start	Start__c	Date/Time	The Event's start time.
End	End__c	Date/Time	The Event's end time.
Status	Status__c	Picklist	The Event's availability status.
Registration Limit	Registration_Limit__c	Number(18, 0)	The maximum number of allowed attendees.
Remaining Seats	Remaining_Seats__c	Formula (Number))	The number of available open seats for registration. Click for formula.
Reserved Seats	Reserved_Seats__c	Roll-Up Summary (COUNT EventAttendee)	The number of EventAttendee joins to this event.

---

Session

The representation of sessions under an event that users can register to.

Field Label	API Name	Data Type	Description
Session Name	Name	Text(80)	The Session's displayed name.
Start	Start__c	Date/Time	The Sessions's start time.
End	End__c	Date/Time	The Sessions's end time.
Status	Status__c	Picklist	The Sessions's availability status.
Registration Limit	Registration_Limit__c	Number(18, 0)	The maximum number of allowed attendees.
Reserved Seats	Reserved_Seats__c	Roll-Up Summary (COUNT SessionAttendee)	The number of SessionAttendee joins to this event.
Remaining Seats	Remaining_Seats__c	Formula (Number))	The number of available open seats for registration. Click for formula.
Event	Event__c	Master-Detail(Event)	The relationship join to the parent Event.

---

Attendee

The representation of a user attending a session and/or event.

Field Label	API Name	Data Type	Description
First Name	First_Name__c	Text(180)	The attendee's first name.
Last Name	Last_Name__c	Text(255)	The attendee's last name.
Company	Company__c	Text(255)	Optional: The attendee's company name.
Phone	Phone__c	Phone	Optional: The attendees contact number.
Email	Email__c	Email	The attendees email address.
Event	Event__c	Master-Detail(Event)	The relationship join to the attending events.

---

SessionAttendee

The representation of the association between attendees and sessions (one-to-many).

Field Label	API Name	Data Type	Description
Attendee	Attendee__c	Master-Detail(Attendee)	The relationship join to the attendee.
Session	Session__c	Master-Detail(Session)	The relationship join to the session.

---

EventAttendee

The representation of the association between attendees and events (one-to-many).

Field Label	API Name	Data Type	Description
Attendee	Attendee__c	Master-Detail(Attendee)	The relationship join to the attendee.
Event	Event__c	Master-Detail(Session)	The relationship join to the event.

Testing

Front-end

1. Navigate to the client directory cd app/client.
2. Run the Angular-CLI testing suite: ng test.

Contributors

Sean Perkins

eventforce's Issues

As a user, I get a success/failure message after registration

• Success
  • "You have successfully registered to Eventforce. Please login to access events."
• Error
  • 500
    • "There was an issue registering your account. Please contact support at [email protected]"
  • 400
    • code
      • email_taken - "An user already exists with this email. Please login or recover your password."
      • invalid_password - "Your password did not meet our requirements. Please try again."
      • invalid_email - "Please enter a valid email address."

As a Salesforce user, I can create attendees under an event

Connect to Salesforce in NodeJS

Determine how to connect to salesforce through NodeJS. Test implementation of login and simple query requests for event objects.

As a user I can register to an event

• Register button on event detail page
• After clicking the registration button I need to:
  • Select which sessions I want to register for under the event
  • Enter my basic information as an Attendee
    • First Name
    • Last Name
    • Email
    • Phone
    • Company

---

• Display a success message after the user is registered to the sessions(s) and Event.

As a user, I get an automatic email from salesforce after successful registration with the event and session details in the email

As a Salesforce user, I can add an attendee to multiple sessions

Determine how to persist the salesforce connection in Node

Salesforce is fairly sensitive to API call limits. The least amount of queries the best (true to any app, but more importantly to Salesforce). Currently having to repeating the login request with each query.. which means x2 the API calls per a singular API end point.

Deploy to AWS or Heroku

Deploy the Node.JS server and Angular bundle to either AWS or Heroku. Provide public URL on README.

As a user, I can see an event detail page

• Show basic details
• Show Description (Rich Text Field)

As a user, I can see sessions on the event detail page

• Sessions also have the same basic information as an event

As a Salesforce user, I can create an event

As a Salesforce user, I can create sessions under an event

As a user, I can see a list of Events in chronological order

Basic event details to show:

• Title (Text)
• Start (Date/Time)
• End (Date/Time)
• Status (Draft, Open, Sold Out, Closed)
• Registration Limit (Number)
• Remaining Seats (Number)

As a user, I can only register to Open events and sessions

• But can see Sold Out and Closed ones on the event listing page

Submodule in Eventforce Angular App

Initialize a submodule dependency on the server repository, to pull in the angular app from it's child repository.