Sample app is hosted on Heroku platform: https://studies-pk.herokuapp.com/ Mobile app can be run by scanning QR code using Expo app: https://expo.io/@mattkobosko/studies API reference is available under: https://studies-pk.herokuapp.com/docs/index.html

Use the REST API /api/study/{id}/result endpoint add new Study result

Full API documentation is available under /docs/index.html.

• .NET Core 3.0
• Mongo 4.2
• Expo v36 + React Native (0.61.4) + React Native Web

• git v2.21.1+
• NodeJS v10+
• yarn v1.17.3+
• expo-cli v3.11.3
• Docker v19+
• .NET Core SDK v3.0.103+

# Verify if installed:
./infrastructure/verify.sh

• Visual Studio Code + extensions: ESLint and Prettier
• JetBrains Rider / Visual Studio
• Postman
• Mongo Express
• Android Emulator / iOS Simulator

git clone https://github.com/miazga/Studies.git
cd Studies
./infrastructure/verify.sh
./infrastructure/start.sh

• Open server/Server.sln in JetBrains Rider / Visual Studio
• Hit debug/run on the Server.API project

• Open client in Visual Studio Code and open Terminal (CTRL + ` or CMD + `)

yarn
expo start

• Open client in Visual Studio Code and open Terminal (CTRL + ` or CMD + `)

rm -rf node_modules/ && yarn
expo web

Steps to deploy into free Heroku app:

• create free app on Heroku
• find and replace studies-pk.herokuapp.com with your target host/domain
• build a static SPA by running

cd client
./scripts/build-web.sh

• modify ./server/scripts/build-and-push.sh script with your settings
• build and deploy an app by running

cd server
./scripts/build-and-push.sh

• setup connection string for the Mongo using Heroku panel add add a config: MongoDbSettings__ConnectionString="mongodb://{yourdatabase}"
• to build mobile app you must setup your account and run

cd client
rm -rf node_modules/ && yarn
expo build:android / expo build:ios

Can either install the APK generated in the build process or install Expo app (on both Android / iOS)

• Import Studies.postman_collection.json into Postman
• Setup host and id for the study to use (local server api http://localhost:5100)

• You can create a free Mongo cluster using Atlas Cloud -> https://www.mongodb.com/cloud/atlas/azure-mongodb
• To make your Atlas cluster reachable from anywhere make sure to whitecard all the IPs in security panel
• To configure RealTime udpates via SignalR on local environment make sure to confiugure AddCorsDefinitions() method with a proper url for Expo packager (default set to http://192.168.8.113:19006):

public static IServiceCollection AddCorsDefinitions(this IServiceCollection services)
{
    services.AddCors(options => options.AddPolicy("DevCorsPolicy", 
        builder =>
        {
            builder.AllowAnyMethod()
                .AllowAnyHeader()
                .WithOrigins("http://192.168.8.113:19006", "http://localhost:5100")
                .AllowCredentials();
        }));
    
    ...
}

• Data Structure - example Mongo document of the study:

{
    _id: BinData(3, 'TspP3zKBz0690SUPqFGEMg=='),
    Name: 'Study A',
    Results: [
        {
            StationId: 3,
            Created: ISODate('2020-03-07T12:09:11.000Z'),
            SensorId: 16,
            Value: '89'
        },
        {
            StationId: 2,
            Created: ISODate('2020-03-07T12:09:12.000Z'),
            SensorId: 10,
            Value: '48'
        },
        {
            StationId: 2,
            Created: ISODate('2020-03-07T12:09:26.000Z'),
            SensorId: 9,
            Value: '55'
        }
    ],
    Created: ISODate('2020-03-07T13:06:52.828Z'),
    State: 1
}

• Create SPA from React Native Project
• Real Time updates using SignalR
• Deploy on Heroku
• Add user authentication
• Use RabbitMQ as a batch for high performance