cloud-cap-samples/samples.md

Overview of Samples

The following list gives an overview of the samples provided in subdirectories. Each sub directory essentially is an individual npm package arranged in an all-in-one monorepo umbrella setup.

@capire/hello-world

• A simplistic Hello World service using CDS and cds.services.

@capire/bookshop

• Getting Started with CAP, briefly introducing:
• Project Setup and Layouts
• Domain Modeling
• Defining Services
• Generic Providers
• Adding Custom Logic
• Using Databases

@capire/common

• Showcases how to extend @sap/cds/common thereby covering:
• Building extension packages
• Providing reuse packages
• Verticalization
• Using Aspects
• Used in the fiori app sample

@capire/orders

• A standalone orders management service, demonstrating:
• Using Compositions in Domain Models, along with
• Serving deeply nested documents

@capire/reviews

• Shows how to implement a modular service to manage product reviews, including:
• Consuming other services synchronously and asynchronously
• Serving requests synchronously
• Emitting events asynchronously
• Grow as you go, with:
• Mocking app services
• Running service meshes
• Late-cut Micro Services
• As well as managed data, input validations, and authorization

@capire/suppliers

• Shows how to integrate remote services, in this case the BusinessPartner service from SAP S/4HANA.
• Extending @capire/bookshop with suppliers from SAP S/4HANA
• Providing that as a pre-built integration & extension package
• Used in @capire/fiori

@capire/fiori

• A composite app, reusing and combining these packages:
  • @capire/bookshop
  • @capire/common
  • @capire/orders
  • @capire/reviews
  • @capire/suppliers
• Adds a SAP Fiori elements application to bookshop, thereby introducing to:
  • OData Annotations in .cds files
  • Support for Fiori Draft
  • Support for Value Helps
  • Serving SAP Fiori apps locally
• The Vue.js app imported from bookshop is served as well

All-in-one Monorepo

Each sample sub directory essentially is a standard npm package, some with standard npm dependencies to other samples. The root folder's package.json has local links to the sub folders, such that an npm install populates a local node_modules folder acts like a local npm registry to the individual sample packages.