An Open Source Social Network for the positive change that we need in the World. Human-Connection is being built to provide better Communication Tools for everyone. We want to do more than comments and sharing!
Project status: ACTIVE
Created 5 months ago by Matthew RiderJoin Project
This Prototype tries to resolve the biggest hurdle of connecting our services together. This is not possible in a sane way using our current approach.
With this Prototype we can explore using the combination of GraphQL and the Neo4j Graph Database for achieving the connected nature of a social graph with better development experience as we do not need to connect data by our own any more through weird table structures etc.
- easer data structure
- better connected data
- easy to achieve "recommendations" based on actions (relations)
- more performant and better to understand API
- better API client that uses caching
We still need to evaluate the drawbacks and estimate the development cost of such an approach
Connect with other developers over Discord
Before you start, fork the repository using the fork button above, then clone it to your local machine using
git clone https://github.com/your-username/Nitro-Backend.git
docker-compose up # create indices etc. docker-compose exec neo4j migrate # if you want seed data # open another terminal and run docker-compose exec backend yarn run db:seed
App is running on port 4000
To wipe out your neo4j database run:
docker-compose down -v
yarn install # -or- npm install
cp .env.template .env
Configure the file
.env according to your needs and your local setup.
Start the GraphQL service:
yarn dev # -or- npm dev
And on the production machine run following:
yarn start # -or- npm start
This will start the GraphQL service (by default on localhost:4000) where you can issue GraphQL requests or access GraphQL Playground in the browser:
Set your Neo4j connection string and credentials in
NEO4J_URI=bolt://localhost:7687 NEO4J_USERNAME=neo4j NEO4J_PASSWORD=letmein
You need to install APOC as a plugin for the graph you create in the neo4j desktop app!
Note that grand-stack-starter does not currently bundle a distribution
of Neo4j. You can download Neo4j Desktop
and run locally for development, spin up a hosted Neo4j Sandbox instance,
run Neo4j in one of the many cloud options,
spin up Neo4j in a Docker container or on Debian-based systems install Neo4j from the Debian Repository.
Just be sure to update the Neo4j connection string and credentials accordingly in
Alternatively you can just mock all responses from the api which let you build a frontend application without running a neo4j instance.
.env or pass it on application start.
Optionally you can seed the GraphQL service by executing mutations that will write sample data to the database:
yarn run db:seed # -or- npm run db:seed
For a reset you can use the reset script:
yarn db:reset # -or- npm run db:reset
Beware: We have no multiple database setup at the moment. We clean the database after each test, running the tests will wipe out all your data!
Run the jest tests:
yarn run test # -or- npm run test
Run the cucumber features:
yarn run test:cucumber # -or- npm run test:cucumber
When some tests fail, try
yarn db:reset and after that
yarn db:seed. Then run the tests again
- add jwt authentication
- get directives working correctly (@toLower, @auth, @role, etc.)
- check if search is working
- check if sorting is working
- check if pagination is working
- check if upload is working (using graphql-yoga?)
- evaluate middleware
- ignore Posts and Comments by blacklisted Users
No documents can be found for project Human Connection
Human Connection - Agile Ventures Tutorial - Wednesday, 24th Apr at 11:45am (UTC)
Latest Project videos
No IssueTracker Stories can be found for project Human Connection