Repository files navigation

This public repository is read-only and no longer maintained. For the latest sample code repositories, visit theSAP Samples organization.

In response to the current COVID-19 pandemic and its resulting impact on students and families, GENYOUth, child health and wellness nonprofit, and SAP, market leader in enterprise software sales, have created the SAP4Kids application.

It's our goal to ensure families have access to the food and resources they need when they need them. For this, we developed an application they can use to find available resources in their neighborhood.

Check out the application running in production for alive demo.

This repository contains the entire source code of this application, so it can be adapted and used by other organizations. We also think it is an excellent resource for many developers to see how SAP technology can be used to make the world run better.This project consists of three distinct web applications:

• Assistance Entry Form

  Provides a quick way for organizations to submit information on feeding

  sites and other free resources (i.e. financial, workforce, housing, and healthcare) they provide to helpstudents and families.

• Approval List

  All entered data needs to be approved by an admin to be shown on the map.

• Resource Locator

  An interactive map that helps students and families find resources near them.

• Create your ownGoogle Maps API Key

• Install Node.js LTS version 12 fromhttps://nodejs.org/en/download/.

• Create an SAP Cloud Platform trial account in the region Europe (Frankfurt)

• Follow this tutorial to install the Cloud Foundry command-line tool.

• Add the Multi-Target Application Cloud FoundryCLI Plugin.

  cf add-plugin-repo CF-Community https://plugins.cloudfoundry.orgcf install-plugin multiapps

• Install make via a package manager...

  ...for Mac users: This tool should be preinstalled on your machine.

  ...for Windows users (installchocolatey first).

  choco install make

• Install SQLite3 via a package manager...

  ...for Mac users (installbrew first).

  brew install sqlite

  ...for Windows users (installchocolatey first).

  choco install sqlite

Optional: Set up theSAP Web Analytics service if you want to add it to the project

1. Clone the project.

   git clone https://github.com/SAP-samples/SAP4Kidscd SAP4Kidsnpm install

2. Open the project with VS Code.

   code .

3. Replace the placeholder for the Google Maps Key, the reCaptcha site key, and the Web Analytics token in the key files (ui_form/webapp/resources/keys.js andui_map/webapp/resources/keys.js)
4. Build and deploy the project to the cloud.

   npm run deploy# deploys to a production account# npm run deploy:trial # deploys to a trial account

5. Wait until the process completed and look for the output line, which references the URL of the started app router. Open the displayed URL in a browser.
6. Open the SAP Cloud Platform Cockpit and assign the role collectionDataAdmin to your user (compare to step two ofthis tutorial)

Explain why local DB just for assistance entry / FE app

1. Clone the project.

   git clone https://github.com/SAP-samples/SAP4Kidscd SAP4Kidsnpm install

2. Open the project with VS Code.

   code .

3. Replace the placeholder for the Google Maps Key, the reCaptcha site key, and the Web Analytics token in the key files (ui_form/webapp/resources/keys.js andui_map/webapp/resources/keys.js)
4. Initialize the SQLite database vianpm run deploy:cds.
5. Start the app withnpm start
6. The backend service will run onhttp://localhost:4004 and the web apps on port8080 (entry form),8081 (interactive map), and8082 (approval app).

When prompted for a password, enter the user namealice and confirm with an empty string as password.

The project consists of the following modules and services:Have a look at thedetailed architecture page for more information.

• The map only displays records within a 200 mile radius of the specified location. Interacting with the map (dragging or zooming in/out) has no effect on the displayed assistance locations.

This content is provided "as-is" with no other support.

cf set-env sap4kids-srv destinations "[{name: "usda_arcgis",url: "https://services1.arcgis.com/RLQu0rK7h4kbsBq5/ArcGIS/rest/services/Summer_Meal_Sites_2020/FeatureServer/0/"}]"