diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..636f769 --- /dev/null +++ b/.dockerignore @@ -0,0 +1,9 @@ +**/bin/ +**/obj/ +.vs/ +TestResults/ +.git/ +.repo-tasks/ +.repo-context/ +.tasks/ +.agile/ diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..1166a17 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,22 @@ +# syntax=docker/dockerfile:1.7 +ARG SDK_IMAGE=mcr.microsoft.com/dotnet/sdk:10.0 +ARG RUNTIME_IMAGE=mcr.microsoft.com/dotnet/aspnet:10.0 + +FROM ${SDK_IMAGE} AS build +ARG NUGET_FEED_URL=http://192.168.10.100:3000/api/packages/AgileWebs/nuget/index.json +ARG NUGET_FEED_USERNAME= +ARG NUGET_FEED_TOKEN= +WORKDIR /src +COPY . . + +RUN if [ -n "$NUGET_FEED_USERNAME" ] && [ -n "$NUGET_FEED_TOKEN" ]; then dotnet nuget add source "$NUGET_FEED_URL" --name gitea-org --username "$NUGET_FEED_USERNAME" --password "$NUGET_FEED_TOKEN" --store-password-in-clear-text --allow-insecure-connections --configfile /root/.nuget/NuGet/NuGet.Config; fi + +RUN dotnet restore "src/Customer.Orders.Bff.Rest/Customer.Orders.Bff.Rest.csproj" --configfile /root/.nuget/NuGet/NuGet.Config +RUN dotnet publish "src/Customer.Orders.Bff.Rest/Customer.Orders.Bff.Rest.csproj" -c Release -o /app/publish /p:UseAppHost=false --no-restore + +FROM ${RUNTIME_IMAGE} AS runtime +WORKDIR /app +ENV ASPNETCORE_URLS=http://+:8080 ASPNETCORE_ENVIRONMENT=Production +EXPOSE 8080 +COPY --from=build /app/publish . +ENTRYPOINT ["dotnet", "Customer.Orders.Bff.Rest.dll"] diff --git a/docs/roadmap/feature-epics.md b/docs/roadmap/feature-epics.md new file mode 100644 index 0000000..05b7966 --- /dev/null +++ b/docs/roadmap/feature-epics.md @@ -0,0 +1,18 @@ +# Feature Epics + +## Repository +customer-orders-bff + +## Core Epics +- Epic 1: Expand domain-aligned capabilities for restaurant operations. +- Epic 2: Stabilize service contracts for containerized runtime integration. +- Epic 3: Improve observability and operational readiness for demo compose environments. + +## Domain-Specific Candidate Features +- Order lifecycle consistency and state transitions. +- Kitchen queue and dispatch optimization hooks. +- Operations control-plane policies (flags, service windows, overrides). +- POS closeout and settlement summary alignment. + +## Documentation Contract +Any code change in this repository must include docs updates in the same branch. diff --git a/docs/runbooks/containerization.md b/docs/runbooks/containerization.md new file mode 100644 index 0000000..3249da7 --- /dev/null +++ b/docs/runbooks/containerization.md @@ -0,0 +1,40 @@ +# Containerization Runbook + +## Image Build + +If the repo consumes internal packages from Gitea, pass feed credentials as build args. + +```bash +docker build --build-arg NUGET_FEED_USERNAME= --build-arg NUGET_FEED_TOKEN= -t agilewebs/customer-orders-bff:dev . +``` + +## Local Run + +```bash +docker run --rm -p 8080:8080 --name customer-orders-bff agilewebs/customer-orders-bff:dev +``` + +## Health Probe + +- Path: `/health` +- Fallback path: `/healthz` +- Port: `8080` + +## Runtime Notes + +- Exposes REST edge endpoints for customer order lifecycle flows. + +## Health Endpoint Consistency + +- Canonical probe: `/health` +- Compatibility probe: `/healthz` +- Container port: `8080` + +## Demo Integration + +- Participates in: **restaurant** demo compose stack. +- Integration artifact path: `greenfield/demo/restaurant/docker-compose.yml` +## Known Limitations + +- Current runtime adapters are still predominantly in-memory for deterministic local/demo behavior. +- Demo PostgreSQL seeds validate integration contracts and smoke determinism, but do not yet imply full persistence implementation parity. diff --git a/src/Customer.Orders.Bff.Application/Adapters/DefaultCustomerOrdersServiceClient.cs b/src/Customer.Orders.Bff.Application/Adapters/DefaultCustomerOrdersServiceClient.cs index beac07f..6786e85 100644 --- a/src/Customer.Orders.Bff.Application/Adapters/DefaultCustomerOrdersServiceClient.cs +++ b/src/Customer.Orders.Bff.Application/Adapters/DefaultCustomerOrdersServiceClient.cs @@ -9,4 +9,9 @@ public sealed class DefaultCustomerOrdersServiceClient : ICustomerOrdersServiceC { return Task.FromResult(new GetCustomerOrderStatusResponse(request.ContextId, "Default service-backed response.")); } + + public Task SubmitOrderAsync(SubmitCustomerOrderRequest request, CancellationToken cancellationToken) + { + return Task.FromResult(new SubmitCustomerOrderResponse(request.ContextId, request.OrderId, true, "Order accepted by default adapter.")); + } } diff --git a/src/Customer.Orders.Bff.Application/Adapters/ICustomerOrdersServiceClient.cs b/src/Customer.Orders.Bff.Application/Adapters/ICustomerOrdersServiceClient.cs index cf9477a..88c94fa 100644 --- a/src/Customer.Orders.Bff.Application/Adapters/ICustomerOrdersServiceClient.cs +++ b/src/Customer.Orders.Bff.Application/Adapters/ICustomerOrdersServiceClient.cs @@ -6,4 +6,5 @@ namespace Customer.Orders.Bff.Application.Adapters; public interface ICustomerOrdersServiceClient { Task FetchAsync(GetCustomerOrderStatusRequest request, CancellationToken cancellationToken); + Task SubmitOrderAsync(SubmitCustomerOrderRequest request, CancellationToken cancellationToken); } diff --git a/src/Customer.Orders.Bff.Application/Handlers/ISubmitCustomerOrderHandler.cs b/src/Customer.Orders.Bff.Application/Handlers/ISubmitCustomerOrderHandler.cs new file mode 100644 index 0000000..4805bb1 --- /dev/null +++ b/src/Customer.Orders.Bff.Application/Handlers/ISubmitCustomerOrderHandler.cs @@ -0,0 +1,9 @@ +using Customer.Orders.Bff.Contracts.Requests; +using Customer.Orders.Bff.Contracts.Responses; + +namespace Customer.Orders.Bff.Application.Handlers; + +public interface ISubmitCustomerOrderHandler +{ + Task HandleAsync(SubmitCustomerOrderRequest request, CancellationToken cancellationToken); +} diff --git a/src/Customer.Orders.Bff.Application/Handlers/SubmitCustomerOrderHandler.cs b/src/Customer.Orders.Bff.Application/Handlers/SubmitCustomerOrderHandler.cs new file mode 100644 index 0000000..bb8a11b --- /dev/null +++ b/src/Customer.Orders.Bff.Application/Handlers/SubmitCustomerOrderHandler.cs @@ -0,0 +1,13 @@ +using Customer.Orders.Bff.Application.Adapters; +using Customer.Orders.Bff.Contracts.Requests; +using Customer.Orders.Bff.Contracts.Responses; + +namespace Customer.Orders.Bff.Application.Handlers; + +public sealed class SubmitCustomerOrderHandler(ICustomerOrdersServiceClient serviceClient) : ISubmitCustomerOrderHandler +{ + public Task HandleAsync(SubmitCustomerOrderRequest request, CancellationToken cancellationToken) + { + return serviceClient.SubmitOrderAsync(request, cancellationToken); + } +} diff --git a/src/Customer.Orders.Bff.Contracts/Requests/SubmitCustomerOrderRequest.cs b/src/Customer.Orders.Bff.Contracts/Requests/SubmitCustomerOrderRequest.cs new file mode 100644 index 0000000..00846c9 --- /dev/null +++ b/src/Customer.Orders.Bff.Contracts/Requests/SubmitCustomerOrderRequest.cs @@ -0,0 +1,8 @@ +namespace Customer.Orders.Bff.Contracts.Requests; + +public sealed record SubmitCustomerOrderRequest( + string ContextId, + string OrderId, + string TableId, + int GuestCount, + IReadOnlyList ItemIds); diff --git a/src/Customer.Orders.Bff.Contracts/Responses/SubmitCustomerOrderResponse.cs b/src/Customer.Orders.Bff.Contracts/Responses/SubmitCustomerOrderResponse.cs new file mode 100644 index 0000000..4791ece --- /dev/null +++ b/src/Customer.Orders.Bff.Contracts/Responses/SubmitCustomerOrderResponse.cs @@ -0,0 +1,7 @@ +namespace Customer.Orders.Bff.Contracts.Responses; + +public sealed record SubmitCustomerOrderResponse( + string ContextId, + string OrderId, + bool Accepted, + string Summary); diff --git a/src/Customer.Orders.Bff.Rest/Program.cs b/src/Customer.Orders.Bff.Rest/Program.cs index be7e8fb..cbd8846 100644 --- a/src/Customer.Orders.Bff.Rest/Program.cs +++ b/src/Customer.Orders.Bff.Rest/Program.cs @@ -5,6 +5,7 @@ using Customer.Orders.Bff.Contracts.Requests; var builder = WebApplication.CreateBuilder(args); builder.Services.AddSingleton(); builder.Services.AddSingleton(); +builder.Services.AddSingleton(); var app = builder.Build(); @@ -14,4 +15,12 @@ app.MapGet("/api/customer/orders/status", async (string contextId, IGetCustomerO return Results.Ok(await handler.HandleAsync(request, ct)); }); +app.MapPost("/api/customer/orders", async (SubmitCustomerOrderRequest request, ISubmitCustomerOrderHandler handler, CancellationToken ct) => +{ + return Results.Ok(await handler.HandleAsync(request, ct)); +}); + +app.MapGet("/health", () => Results.Ok(new { status = "ok", service = "customer-orders-bff" })); +app.MapGet("/healthz", () => Results.Ok(new { status = "ok", service = "customer-orders-bff" })); + app.Run();