human-connection/api

The API for a better world.

Human-Connection

Human Connection is a nonprofit social, action and knowledge network that connects information to action and promotes positive local and global change in all areas of life.

• Social: Interact with other people not just by commenting their posts, but by providing Pro & Contra arguments, give a Versus or ask them by integrated Chat or Let's Talk
• Knowledge: Read articles about interesting topics and find related posts in the More Info tab or by Filtering based on Categories and Tagging or by using the Fulltext Search.
• Action: Don't just read about how to make the world a better place, but come into Action by following provided suggestions on the Action tab provided by other people or Organisations.

Technology Stack

• VueJS
• NuxtJS
• GraphQL
• NodeJS
• Neo4J

Live demo

Try out our deployed development environment.

Logins:

email	password	role
[email protected]	1234	user
[email protected]	1234	moderator
[email protected]	1234	admin

Documentation

Learn how to set up a local development environment in our Docs 🔎

Translations

You can help translating the interface by joining us on lokalise.co. Thank you lokalise for providing us with a premium account 🙌.

Developer Chat

Join our friendly open-source community on Discord 😻 Just introduce yourself at #introduce-yourself and mention @@Mentor to get you onboard Check out the contribution guideline, too!

Open-Source Bounties

You can get a small financial compensation for your contribution 💰 See details in our Contribution Guidelines.

Attributions

Locale Icons made by Freepik from www.flaticon.com is licensed by CC 3.0 BY.

Browser compatibility testing with BrowserStack.

License

See the LICENSE file for license rights and limitations (MIT).

api's Issues

feature/usersettings

add usersettings for account wide global settings

add notification on organization review

as an organization owner I want to get notified when my organization got reviewed.

add better permissions

We should take a look at feathers-permissions to provide more fine graned permissions

Discussion - Decentralization

Hello (Again) Human Connection,

Congratulations to the alpha! I discussed some ideas around decentralization here: Human-Connection/lagacy-documentation#2 (comment)

Is there a technical roadmap for human connection?

What role do you see for decentralization in the future of HC? Have you looked at projects in the Ethereum space?
Like https://akasha.world/ or userfeeds.io ?

Thanks!

Add initial user for docker image

We need a initial admin user for in the docker image.
Threfore we should add docker parameters. When running the docker container we have the ability to attach the parameters --user="[email protected]" --pass="my password"

Maybe we should not pass the password but only the user and use the passwort reset feature!?

Cannot save usersettings for provider `rest`

Describe the bug
I can change my language in my browser and the change is persisted. However, when I change my language with a HTTP POST request (with a valid jwt token) I get there is no current user to associate.

To Reproduce
Steps to reproduce the behavior:

1. Authenticate over JWT
2. Post following data to endpoint '/usersettings' with valid Bearer token in headers:

    {
      "uiLanguage": "de"
    }

3. Usersettings is not modified

Expected behavior
Usersettings uiLanguage should be changed to de.

add email notifications and settings

currently we do not inform the user by email when they have new notifications. We should somehow collect them periodicaly and send summeries to the user.

This behavior should be configurable.

Deleting a contribution does not release the slug for further use.

softdelete hook triggers but it keeps the slug for the contribution "reserved" - hence a contribution with the same slug cannot be created ever again.

Possible solution: randomize slug on softdelete or add a number to slug on create if exists.

`yarn run mocha` -> cannot read property '0' of undefined

This line raises an error in some library used for sanitation. What's the purpose of this line?

save relative image urls but ouput absolute ones

Describe the bug

The domain (plus port if non standard) should be NOT saved to the database as otherwise we have the same situation like wordpress where you have to migrate data to work between local, staging and production or just different domains.
http://localhost:3030/uploads/avatar_69799620-9ff5-11e8-918a-ed36ffba61fe.jpeg

To Reproduce
go to http://localhost:3030/users and see absolute paths.

Expected behavior
Save the url as a relative path and attach the domain by using an after hook
/uploads/avatar_69799620-9ff5-11e8-918a-ed36ffba61fe.jpeg

but output as:
http://localhost:3030/uploads/avatar_69799620-9ff5-11e8-918a-ed36ffba61fe.jpeg

[BUG] NODE_ENV=test does not change configuration

According to the docs, changing NODE_ENV=test should load config/test.json. But it's loading only config/local.json.

Steps to reproduce:

// config/test.json
{
  "seeder": {
    "runOnInit": false,
    "dropDatabase": false
  },
}

// config/local.json
{
  "seeder": {
    "runOnInit": true,
    "dropDatabase": false
  },
}

Open chromium, visit chrome://inspect, open dedicated DevTools for Node, then run
NODE_ENV=test node --inspect server/index.js
from your terminal.

Result of app.get('seeder').runOnInit is true.

I found out, we're using an outdated version of featherjs. Will we migrate to v3 any time soon? Out of curiosity, I updated @feathersjs/feathers and @feathersjs/configuration and the new dependencies have the desired behaviour, ie. overwrite the default config with NODE_ENV.json config.

Notifications trigger on Contribution Comment update.

When a user updates a comment with a mention inside it will trigger the notification again.

Inconsisent test configuration of .travis.yml and package.json

For debugging and consistency it would be great if Travis could run the same commands which a developer would run on a local machine.

Right now, the .travis.yml has a custom run script: https://github.com/Human-Connection/API/blob/develop/.travis.yml#L28, compared to package.json: https://github.com/Human-Connection/API/blob/develop/package.json#L51

Add feathers-sync for scaling the api

setup feathers-sync so we can finally scale the api to more then one server

Re-Enable Testing on Travis-CI for API

Make Passwort-Reset possible for non verified users.

Currently it seems that a user that did nor verify its email, can't use the password reset feature. But without loggin in, she/he can't re-trigger its verification mail.

So we should ether resend the email after a certain amount of time or make the passwort-reset feature possible event if the user is not verified.

Update Feather to 3.x

We need to Upgrade Feather to Version 3.x

Keep in mind that we have to upgrade to the new Channel based Pub/Sub.

• make sure to secure the new channels
• fix failing tests (@visualjerk)

Uploaded images are overwritten with Video Thumbnais

This should only happen when you do not provide any image!

SSR/Cache bug when opening user profiles

Describe the bug
loading a users profile always contains all data from all users on the first fresh request.
hitting f5 fixes the issue until you get to the profile again

To Reproduce
Steps to reproduce the behavior:

1. Authenticate '
2. Open your own profile
3. see all posts from all users loaded (count and recent posts)

Expected behavior
only see posts related to this particular user

Maintenance: Reduce size of docker imge

Our current edge docker image is 205MB big. That's way too large. Probably there is some potential for minimization of the image size. https://hub.docker.com/r/humanconnection/api-feathers/tags/

Refine Tag Service

Make the Tag Service searchable so we can handle autocompletion and usage tags for things like "hot tags" or something like that.

Increase API Test Coverage

[Discussion] Lean Startup

Hi,

it is probably not the right channel for discussions, but I have a question or a point to make. I follow human-connection since I watched the interview at KenFM and was also thinking about joining the team. What stopped me is the long time you worked on this project. Since 2012 you are working on human-connection in one form or another and you have not released something to the public audience yet. I would name myself an entrepreneur and have co-founded several startups already. Some of them successfully and some not. But what I experienced all he times is that your assumptions from the beginning are usually wrong. Therefore you have to release fast and get out to the public, even with a bad version.

I see 2 challenges in human-connection:

1. How to get a lot of users
2. How to manage the discussions so that you have friendly, fact-oriented and in in general good discussions.

And I think you can only prove them when you go out, you cannot prove your assumptions with a small audience. Perhaps you want to test some of the mechanisms from Stackoverflow to make users to moderators automatically or you other ideas? Get them out and test them. The same with scalability. You already mentioned it somewhere that you think about this problem. But having scalability issues is actually nice, because it means that you have a lot of users. And whatever you do now, will probably not be suitable for 100 times more users tomorrow anyway, so why trying it? Get your MVP out and let us test it.

Sorry, I don't get it. I think the idea to start with a "perfect" version is "stupid".