zalando / zappr Goto Github PK

See http://docs.sequelizejs.com/en/latest/docs/migrations/

Registered a repository for zappr and had a look into 'webhooks'-settings the hook was marked red.

Maybe this is a issue, maybe not.

For certain API operations that are automatically performed by the web service in response to a webhook we need a valid OAUTH token.

The webhook events and resulting operations are always associated with a check. So it would make sense to save the current user's token in each check that gets turned on.

Has this something to do with being a collaborator?

Currently we're just using default postgres database out of comfort, but in anticipation of #44, where we require yet another schema, it would be beneficial to switch to a dedicated zappr database as long as it's easy.

Use koa-generic-session with koa-redis or some other Store implementation instead of the default MemoryStore for session storage.

When building the server npm run build-server there is an error (but the build completes nominally):

ERROR in ./server/service/EncryptionService.js
Module parse failed: /Users/mfellner/Code/Github/zalando/zappr/node_modules/babel-loader/index.js?{"presets":["node5","stage-3"]}!/Users/mfellner/Code/Github/zalando/zappr/server/service/EncryptionService.js Line 28: Unexpected token ;
You may need an appropriate loader to handle this file type.
|
| class EncryptionService {
|   static instance;
|
|   static create() {
 @ ./server/model/Check.js 25:25-64

The semicolon after instance gets automatically injected, even if it is removed (failing the eslint check).

Suggestion: refactor the singleton pattern (which is strange anyway) to simply leverage the Node module.

• Hooks don't work out of the box without a valid SSL certificate
• Redeploy the open source stack with a valid certificate

When a PR in my project is open for longer than n time units, Zappr should send a reminder email to a configured email address. If no action is taken by the receiver(s), Zappr should close the PR after m time units. An example for such action could be a button in the email "keep PR open".

because regex.test(string) does not return a number and is thus always not equal to -1.

• add comments and explanations
• add kio integration example
• review and test

Define the Value Proposition Canvas for Zappr.

Define the following aspects:

• customer jobs
• customer gains
• customer pains
• value proposition
• gain creators
• pain relievers

Google doc: https://docs.google.com/document/d/1-4PXtNApl6OnF5fzdOdLOAI7y2e3q1mB4WFXWR_mYz8

For instance

• Zapier
• IFTTT
• Review Ninja
• webtask.io
• compile list of potential competitors
• compare Zappr to the competitors

• Brainstorm a list of survey questions
• Select a shortlist of questions for the survey (6-10)
• Peer-review or survey

https://docs.google.com/document/d/1ZFAQMOfT7iB3xP_-zBid_qSQVRAa8HsF9GZqJUR7Eb8

• initially, load n (e.g. 20) repositories from Github
• when a special parameter is provided (e.g. 'all') load n + k = all repositories from Github

Create a Google survey about Github, Stash and general workflow habits.

Compile the following resources:

• mailing lists
• guilds
• individuals

Main obstacle: Tickets that do not live in same Github installation. Not the common case, but might happen.

Should be relatively easy and we identified this as a nice ticketing/scm integration feature.

• If enabled creates branch based on newly opened ticket
• Name pattern is configurable with sane defaults
• New checkbox in frontend

It should be possible to give Zappr only a minimal set of permissions initally and then upgrade.

Braindumping how it could work

• Store consented scopes in a new column in User (first* db migration!)
• Change config options to accomodate new premium/advanced/god mode.
• Set cookie to indicate that god mode is used.
• Dropdown in nav header to change mode.
• Bonus points: When a check is enabled, it should then show a) who the token belongs to and b) what scopes it has / which mode it was created for and c) if it's valid (see below).
• Figure out how to obtain consented scopes, should somehow work with the passport plugin: Does not currently work with the passport plugin. Workaround: Make HTTP request to Github API with token, read X-OAuth-Scopes response header.
• Figure out how we can change consented scopes: Just do another login with more scopes. This won't work for removing scopes though, the users will have to revoke access (effectively invalidating all previously issued tokens) and log in again.
• Figure out what happens to the old token when a user changes modes: Nothing, stays valid.

In worst case we would have to revoke all access tokens we got via Github web UI and delete them from our database.

Think of a way to restore functionality with minimal user effort (ie ideally not more than logging in).

Create and compare user journeys about their development workflows.

• create examples of workflows
• identify contacts
• hold interviews
• summarise results

Workflow & Interviews: https://docs.google.com/document/d/16jHNJrsM1X0mMkTbizgRZbsxkr7MZrvJMyWTLQ8pS3M/edit

Most active teams on Stash and possible contacts:

• AST: Zalando Stock — jrempe
• BRAND: Brand Solutions
• BZR: Bazaar
• CEP: Logistics — yvandecnocke
• DIPA: DI Payment Analytics
• DISFC: DI SCF ???
• JUS: Just Buy — Gökhan, oekarahan
• ORDER: Order ^^ — lniemeier
• PPDBACKEND: Zaster — mschumacher, ohuelscher
• PPDEXPERIENCE: lbrueder, dodebrecht
• SHTRACK: rschaarschmi
• SHOP-ENGAGEMENT: rgritti
• SHOP-EDITORIAL: MyFeed — azarutsky
• TRUX: cpeikert, rwitzel

We should be able to:

• add and remove checks for a repository
• add, delete and update a webhook for a repo
• execute web hooks from github

Use the protected branches API to automatically protect the master branch when approvals are enabled for a repository.

Test "should render the selected repository" sometimes fails:

• https://travis-ci.org/zalando/zappr/builds/113256011
• https://travis-ci.org/zalando/zappr/builds/113243589

• deployment 1
• deployment 2

Maybe with KMS so we don't have to take care of the encryption key.

• A token is saved inside each check (#25)
• Tokens are handled by the NullEncryptionService for development
• Tokens hare handled by the KmsEncryptionService in production

• modify passport module to support github enterprise
• provide the necessary configuration options
• use the original jaredhanson/passport-github with Github Enterprise support

Github just announced support for reactions.

I did not see any API support yet, but that could be a great interface for approvals.

Figure out a way for people to define state transitions for issues via labels. The main obstacle here is the feedback loop: One adds a label, representing an invalid transition, and then what? Just remove it again? If so, how to inform user about invalid transition? Email?

It's just a sign-in button now without any hint what's behind. Before go-live we should put some love into that.

Create a complete documentation for the contributors and developers of Zappr.

Tasks

• instructions on testing in README.md

For different branches on enabled repos, send a daily (configurable) commit summary from other people to encourage code review prior to PR.

Main question is how to organise it as its possibly lots of information.

Some people I've talked to say that approving releases and/or deployments is very important to them. How could we address this?

What we need to understand

• how do teams prepare a release?
• how do teams deploy a release?
• which steps should be automated and which need to be manual?

Notes

• probably related to #105
• could use Github deployment API

• Create review approvals in Kio automatically after they were given in Zappr.

When updating repositories from Github the whole list is replaced with a giant spinner. We can make this more subtle, I guess. Also I think "load all" does not really transport what it does / is slightly confusing, so we should stick to the wording that Travis uses: sync. And thinking about it, is there a specific reason why one cannot work with the UI during a sync?

• Subtle spinner that doesn't render the whole UI useless
• Align wording with Travis, ie change "load all" to "sync"

Improve logging to provide the most useful information in order to trace all transactions:

• signing on and off
• enabling and disabling a hook
• receiving githooks
• reacting to githooks

Also see https://www.npmjs.com/package/debug

I tried to enable zappr on delivero/gitworkflowsamples, which then resulted in an internal server error. See attached screenshot.

Currently a repository can belong only to a single user. This is incompatible with teams and organisations.

I thought we fixed this. :(

Reproducable by:

1. Start at / and filter list by zappr
2. Choose zalando/zappr

Search field is now empty.

• Ability to put templates (mustache?) in a .zappr folder in the project
• New issues are checked against templates and labeled accordingly
• Option to autoclose issues that do not match any template
• Figure out what to do with info that can be extracted from templates, like version numbers, most common words in stack trace…

Add a secret to a check and in the hook validate the hash of the payload.

• value proposition canvas printouts

• Approval.execute actually does stuff
• A test for it

When using the auto completion to create the :+1:, Github appends a single space to the emoji. This extra white space prevents the Zappr regex from matching.

Create a complete documentation for the users of Zappr.

Tasks

• project summary in README.md