dosomething / aurora

:crescent_moon: The DoSomething.org admin interface.

Aurora

This is Aurora, our member admin tool. It's the graphical front-end to Northstar, our user & identity API.

Getting Started

Clone this repository, and add it to your Homestead.

# Install dependencies:
$ composer install && npm install

# Configure application & run migrations:
$ php artisan aurora:setup

# And finally, build the frontend assets:
$ npm run build

You may run unit tests locally using PHPUnit:

$ phpunit

Contributing

We follow Laravel's code style and automatically format PHP code with Prettier PHP. Be sure to configure EditorConfig to ensure you have proper indentation settings.

Consider writing a test case when adding or changing a feature. Most steps you would take when manually testing your code can be automated, which makes it easier for yourself & others to review your code and ensures we don't accidentally break something later on!

Security Vulnerabilities

We take security very seriously. Any vulnerabilities in Aurora should be reported to [email protected], and will be promptly addressed. Thank you for taking the time to responsibly disclose any issues you find.

License

©2016 DoSomething.org. Aurora is free software, and may be redistributed under the terms specified in the LICENSE file. The name and logo for DoSomething.org are trademarks of Do Something, Inc and may not be used without permission.

aurora's Issues

Users listing page

Use waypoints to style the pagination
And the table grid thing (not yet built in neue) for the user listing
Inline form styles for the search functionality

Update the menu

• don't show keys to non-admins
• add users to the menu
• add login/logout

Delete api keys

Create a delete api key functionality in the admin ui

Flagging User avatars

Need to ability to flag a user avatar, as it's public in Lets Do This: https://github.com/DoSomething/product/blob/master/LetsDoThis/Screens/Hub/Public%20Hub*.png

Nicer error page for non-admins

When someone tries to login to aurora and they are not an admin, they get an unstyled "unauthorized error"
this could be better

Reportback information

Call the drupal api to pull in more information about the reportback

• reportback photo
• reportback quantity
• campaign title

Duplicate users from search

When more than one user is returned for a user/show search from northstar, aurora displays the "hmm we couldn't find that user" message

The request in northstar returns multiple things, but aurora doesn't display anything

Refs #28

Format total number of users

On /users the total number of users above the graph format the number

User merge

This could be a beast. But the ability to surface duplicate users and merge them together

Role & role user table

Roles table

• For now we probably only need admin role

Role users

• maps the role to the user

mongo _id	role
23423424	1

Zenddesk Integration - *Priority 4*

Pull user tickets/interactions from zendesk

Search - *Priority 5*

Perhaps using the work dave has done with react on Cats Gone Good

Login page styles

this should be both a modal or it's own page and use the form components
http://neue.dosomething.org/#forms-button
http://neue.dosomething.org/#forms-form-item

Keys pages

• add new key page should be in form styles
• keys listing page should display app_id and app_key as one unit (maybe gallery-duo type)
  @DFurnes what do you think

User profile page

• take a look at the profile page in drupal to show user profile information
• print campaign info box without variable types
• style the mobile numbers to a standard format
• make admin button should be red and not on the top as a primary action

Get local connection with mongo working.

Aurora should be able to talk to local Northstar using homestead.
This proves to be tricky because the IP is not available within Homestead.
@blisteringherb I could use some help on this.

Unable to make users admins

If a user has logged into aurora, but they were not previously an admin, the 'Danger Zone' section to make the person an admin does not display.

package.json file

need a main package.json file to add dependencies, otherwise the app won't download neue and other things it needs

User show fails if no campaigns

I'm getting an error on the first "test" user in prod

cURL error 6: Could not resolve host: campaigns
thinking maybe it's failing because the user doesn't have any campaigns, or the campaigns they are signed up for don't exist on drupal

Error on `/admins` page

Tried to load the admins page in prod and got
Client error response [url] user not found

Allow ports with guzzle connection in dev

Ports are not needed in production, but are in dev, allow for that, and don't force a port in prod

Protect CRUD user routes

User routes should only be viewable by an admin, or if you are that user.
Add a before filter to check for either condition.

User segmentation searches

It might be cool to add a way to search users who came from a specific source

"Show me all users from AGG"
"Show me all users from Mobile app"

Then from there be able to narrow down, show me all users who came from India

sample sources

• agg
• cgg
• drupal

member count

might be nice to see how many members are in northstar

Main nav styles

• get rid of top search box
• move menu items to the left (add sub title)
• neue header styles (purple nav/white text)
• move app name below nav

Style the `login` page

the modal login is styled, but when you go to /login it's an unstyled page

User attributes aren't displaying properly

Couple of things I noticed when migrating real user data in

• Address field displays a comma, even if there isn't an address
• Drupal_id doesn't return at all, but from northstar, the users have a value there
• Last name: displays even if the user doesn't have a last name

Index pagination

Use the pager array on the response to pagination the users.

Local admin user not seeded with correct perms

The local admin user [email protected] is not seeded with the correct permissions.

Set up QA/production environments

@blisteringherb we will need QA/prod environments for this, it's a regular Laravel app, no queue or anything special

• php
• mysql

User detail page

this might be a new addition to neue, since there isn't a lot form patterns in neue yet.

@DFurnes can provide more detail here

User index page

• change buttons to -secondary
• add search magnifying glass to box (form type: search)

Throw an error when users login with no access

When a user logs in and is not an admin, don't throw http error, give them a no access error!

Display all northstar admins

filter users to show me 'only admins' so you can add/remove people from the admin list

Tier roles in aurora

Interns/Staff/Admin
not sure who should have what access right now but some things we should probably limit

• read only users
• can't see conversation logs
• can't see/create api keys

Add campaign data for signups

Call the drupal api to get the campaign title and header photo for the campaign to display on the user detail page.

This will be themed with the gallery duo with figures style

Save/update users

Call northstar put on user.edit save method to save changes to the user database.

Mobile Commons integration - *Priority 3*

Helpful?

Neue - *Priority 1*

Theme this with neue styles

neue.dosomething.org

Save useful mobile commons data

Might be worth saving some info from mobile commons, either in northstar (in some type of collection) or in aurora directly.
This will help reduce api calls, as well as provide a way to own data.

Useful things might be

• backlog of messages
• custom fields

Create new admins

Seed one admin user and allow admins to add people in as an admin

Open questions:

• should this info be saved in Northstar?
• Does this map to drupal roles at all?

Create keys & app ids

Instead of manually creating app id & api keys, they should be generated.
What better place than in the front-end partner of northstar
Refs Dosomething/northstar#48

JS Alert on /users

When you load /users on produciton an alert pops up with 1

`

Get app id and api key from env vars

currently they are hard coded in app/config/services.php

User edit page

Form items for user fields

Log users in || user table

Create a simple users table that allows admins to log in

_id	remember_token
1231231	Hashed token

Update views to match the new data array

the new responses in northstar with the [data] array breaks most views/requests in this app

things to fix

• user index
• login
• user.show/edit
• keys.show/edit

Refs # DoSomething/northstar/pull/125

Add tasks to build

Need to add npm install, and maybe gulp to build tasks, so things are installed on deploy.

Make form fields appear inactive

On the user edit page, fields mongo_id and drupal_id should be inactive form fields
Neue might not have a style for this (cc @DFurnes)

Neue nav bar

Add DS branded navigation bar