https://github.com/cecilphillip/shadowshop

Sample estore application using Stripe and Temporal. Orchestrated with .NET Aspire.
https://github.com/cecilphillip/shadowshop

aspnetcore docker dotnet dotnet-aspire stripe stripe-checkout temporal temporal-workflows

Last synced: 3 days ago
JSON representation

Sample estore application using Stripe and Temporal. Orchestrated with .NET Aspire.

• Host: GitHub
• URL: https://github.com/cecilphillip/shadowshop
• Owner: cecilphillip
• License: mit
• Created: 2024-09-26T01:54:13.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-10-31T04:43:35.000Z (20 days ago)
• Last Synced: 2024-10-31T05:24:09.639Z (20 days ago)
• Topics: aspnetcore, docker, dotnet, dotnet-aspire, stripe, stripe-checkout, temporal, temporal-workflows
• Language: C#
• Homepage:
• Size: 4.52 MB
• Stars: 25
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Shadow Shop Sample 

A modified version of the [Aspire Shop](https://github.com/dotnet/aspire-samples/tree/main/samples/AspireShop) sample

application that adds integration with [Stripe](https://stripe.com) for payment processing, [temporal](https://temporal.io/)

for durable workflows, other customer Aspire Integrations. 

![Architecture Diagram](./docs/images/diagram_architecture.png)

## Aspire Integrations

- [HashiCorp Vault](./src/ShadowShop.AppHost/Resources/VaultResource.cs) - Secret store

- [Temporal](./src/ShadowShop.AppHost/Resources/TemporalDevResource.cs) - Workflow Engine

- [Stripe](./src/ShadowShop.AppHost/Resources/StripeDevResource.cs) - Payment event proxy

- [Grafana](./src/ShadowShop.AppHost/Resources/GrafanaStackResource.cs) - OpenTelemetry server and UI

## Getting Setup

### Prerequisites

- [.NET SDK](https://get.dot.net/) 8.0 or later

- [.NET Aspire workload](https://learn.microsoft.com/en-us/dotnet/aspire/fundamentals/setup-tooling?tabs=linux&pivots=dotnet-cli)

- [Stripe account](https://dashboard.stripe.com) & [Stripe CLI](https://stripe.com/docs/stripe-cli)

- [Docker](https://www.docker.com)

### Run the solution

* Add your [Stripe API keys](https://dashboard.stripe.com/apikeys) to the [setup.sh](./src/ShadowShop.AppHost/.config/vault/setup.sh) file.

* Add your [Stripe Secret key](https://dashboard.stripe.com/apikeys)  to the AppHost's [appsettings.Development.json](./src/ShadowShop.AppHost/appsettings.Development.json) file.

* Run the [App Host](./src/ShadowShop.AppHost) project

### Troubleshooting

*Product images aren't showing* 


If the product items load without the images, purge the data by deleting the postgres volume and test data in the Stripe account.

Then try running the solution again.

*The webhook handle throws a StripeException because the API versions don't match* 


Make sure the API version in your Stripe account matches the version the [pinned version](https://github.com/stripe/stripe-dotnet/blob/master/src/Stripe.net/Constants/ApiVersion.cs#L6) for the .NET SDK. 

## Images

The product images were generated by [Canva AI Image Generator](https://www.canva.com/ai-image-generator/).

## License

The code in this repo is licensed under the [MIT](LICENSE) license.