75 lines
3.4 KiB
Markdown
75 lines
3.4 KiB
Markdown
# cloud-cap-samples
|
|
|
|
This is a monorepository for sample projects on Cloud Application Programming Model (CAP).
|
|
|
|
## Description
|
|
|
|
This repository provides a list of samples and reusable packages created based on [CAP](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/00823f91779d4d42aa29a498e0535cdf.html?q=cloud%20application%20programming%20model).
|
|
The SAP Cloud Application Programming Model enables you to quickly create business applications by allowing you to focus on your domain logic. It offers a consistent end-to-end programming model that includes languages, libraries and APIs tailored for full-stack development on SAP Cloud Platform.
|
|
|
|
The samples provided can be run in a local setup on sqlite db.
|
|
|
|
#### Samples:
|
|
* [bookshop](./packages/bookshop) - Showcases different services serving the same set of data entities from a sqlite database. The services match different use cases visualized in corresponding Fiori apps.
|
|
* [bookstore](./packages/bookstore) - A variant of the bookshop application, built in a modular fashion on top of products-service and common reuse packages.
|
|
* [common-contacts](./packages/common-contacts) - A reuse package with common domain models and services for contacts-related data.
|
|
* [common-currencies](./packages/common-currencies) - A reuse package providing common domain models and services for currencies-related data.
|
|
* [media-server](./packages/media-server) - A reuse service to manage and serve media content on behalf of other services and apps.
|
|
* [orders-service](./packages/orders-service) - A reuse package providing domain models and services to submit and manage purchase orders.
|
|
* [products-service](./packages/products-service) - A reuse package providing domain models and services to manage product catalogs.
|
|
* [reviews-service](./packages/reviews-service) - A reuse service providing generic means to add reviews and ratings to target objects, e.g. products.
|
|
* [users-service](./packages/users-service) - A reuse service for users-related functions, like registration, user profile mgmt, etc.
|
|
|
|
|
|
## Requirements
|
|
* [Node.js](https://nodejs.org/en/) v8 or higher
|
|
* [git](https://git-scm.com)
|
|
* [sqlite](https://www.sqlite.org/download.html) (Windows only; pre-installed on Mac/Linux)
|
|
|
|
#### Optional (if you want to import the code into an editor)
|
|
* [VS Code](https://code.visualstudio.com)
|
|
* [Add CDS extension to VS](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/be944d6d51f343f6b3f53c29c44ff00a.html)
|
|
|
|
## Download and Installation
|
|
|
|
#### Clone and build the application
|
|
`git clone https://github.com/SAP-samples/cloud-cap-samples.git`
|
|
|
|
`cd samples`
|
|
|
|
`npm install`
|
|
|
|
#### Run the samples
|
|
|
|
`npm run <sample name>`
|
|
|
|
eg: `npm run bookshop`
|
|
|
|
#### Test the application
|
|
|
|
Open these links in your browser:
|
|
|
|
* <http://localhost:4004/fiori.html> – Fiori Launchpad sandbox
|
|
* <http://localhost:4004/> – generic index page
|
|
|
|
## Limitations
|
|
|
|
None
|
|
|
|
## Known Issues
|
|
|
|
None
|
|
|
|
## How to obtain support
|
|
|
|
In case you find a bug, or you need additional support, please open an issue [here](https://github.wdf.sap.corp/staging-for-SAP-samples-public/cloud-cap-samples/issues) in GitHub.
|
|
|
|
## To-Do (upcoming changes)
|
|
|
|
None
|
|
|
|
## License
|
|
|
|
Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under SAP Sample Code License Agreement, except as noted otherwise in the [LICENSE](/LICENSE) file.
|
|
|