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..1f7a1ae --- /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/Pos.Transactions.Bff.Rest/Pos.Transactions.Bff.Rest.csproj" --configfile /root/.nuget/NuGet/NuGet.Config +RUN dotnet publish "src/Pos.Transactions.Bff.Rest/Pos.Transactions.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", "Pos.Transactions.Bff.Rest.dll"] diff --git a/docs/roadmap/feature-epics.md b/docs/roadmap/feature-epics.md new file mode 100644 index 0000000..37285b1 --- /dev/null +++ b/docs/roadmap/feature-epics.md @@ -0,0 +1,18 @@ +# Feature Epics + +## Repository +pos-transactions-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..276ffc1 --- /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/pos-transactions-bff:dev . +``` + +## Local Run + +```bash +docker run --rm -p 8080:8080 --name pos-transactions-bff agilewebs/pos-transactions-bff:dev +``` + +## Health Probe + +- Path: `/health` +- Fallback path: `/healthz` +- Port: `8080` + +## Runtime Notes + +- Exposes REST edge endpoints for transaction summary and payment capture. + +## 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/Pos.Transactions.Bff.Application/Adapters/DefaultPosTransactionsServiceClient.cs b/src/Pos.Transactions.Bff.Application/Adapters/DefaultPosTransactionsServiceClient.cs index 5d05e57..66440af 100644 --- a/src/Pos.Transactions.Bff.Application/Adapters/DefaultPosTransactionsServiceClient.cs +++ b/src/Pos.Transactions.Bff.Application/Adapters/DefaultPosTransactionsServiceClient.cs @@ -9,4 +9,9 @@ public sealed class DefaultPosTransactionsServiceClient : IPosTransactionsServic { return Task.FromResult(new GetPosTransactionSummaryResponse(request.ContextId, "Default service-backed response.")); } + + public Task CapturePaymentAsync(CapturePosPaymentRequest request, CancellationToken cancellationToken) + { + return Task.FromResult(new CapturePosPaymentResponse(request.ContextId, request.TransactionId, true, "Payment captured by default adapter.")); + } } diff --git a/src/Pos.Transactions.Bff.Application/Adapters/IPosTransactionsServiceClient.cs b/src/Pos.Transactions.Bff.Application/Adapters/IPosTransactionsServiceClient.cs index 0a31b6c..9168951 100644 --- a/src/Pos.Transactions.Bff.Application/Adapters/IPosTransactionsServiceClient.cs +++ b/src/Pos.Transactions.Bff.Application/Adapters/IPosTransactionsServiceClient.cs @@ -6,4 +6,5 @@ namespace Pos.Transactions.Bff.Application.Adapters; public interface IPosTransactionsServiceClient { Task FetchAsync(GetPosTransactionSummaryRequest request, CancellationToken cancellationToken); + Task CapturePaymentAsync(CapturePosPaymentRequest request, CancellationToken cancellationToken); } diff --git a/src/Pos.Transactions.Bff.Application/Handlers/CapturePosPaymentHandler.cs b/src/Pos.Transactions.Bff.Application/Handlers/CapturePosPaymentHandler.cs new file mode 100644 index 0000000..a5169f3 --- /dev/null +++ b/src/Pos.Transactions.Bff.Application/Handlers/CapturePosPaymentHandler.cs @@ -0,0 +1,13 @@ +using Pos.Transactions.Bff.Application.Adapters; +using Pos.Transactions.Bff.Contracts.Requests; +using Pos.Transactions.Bff.Contracts.Responses; + +namespace Pos.Transactions.Bff.Application.Handlers; + +public sealed class CapturePosPaymentHandler(IPosTransactionsServiceClient serviceClient) : ICapturePosPaymentHandler +{ + public Task HandleAsync(CapturePosPaymentRequest request, CancellationToken cancellationToken) + { + return serviceClient.CapturePaymentAsync(request, cancellationToken); + } +} diff --git a/src/Pos.Transactions.Bff.Application/Handlers/ICapturePosPaymentHandler.cs b/src/Pos.Transactions.Bff.Application/Handlers/ICapturePosPaymentHandler.cs new file mode 100644 index 0000000..5ba4d51 --- /dev/null +++ b/src/Pos.Transactions.Bff.Application/Handlers/ICapturePosPaymentHandler.cs @@ -0,0 +1,9 @@ +using Pos.Transactions.Bff.Contracts.Requests; +using Pos.Transactions.Bff.Contracts.Responses; + +namespace Pos.Transactions.Bff.Application.Handlers; + +public interface ICapturePosPaymentHandler +{ + Task HandleAsync(CapturePosPaymentRequest request, CancellationToken cancellationToken); +} diff --git a/src/Pos.Transactions.Bff.Contracts/Requests/CapturePosPaymentRequest.cs b/src/Pos.Transactions.Bff.Contracts/Requests/CapturePosPaymentRequest.cs new file mode 100644 index 0000000..286db9c --- /dev/null +++ b/src/Pos.Transactions.Bff.Contracts/Requests/CapturePosPaymentRequest.cs @@ -0,0 +1,8 @@ +namespace Pos.Transactions.Bff.Contracts.Requests; + +public sealed record CapturePosPaymentRequest( + string ContextId, + string TransactionId, + decimal Amount, + string Currency, + string PaymentMethod); diff --git a/src/Pos.Transactions.Bff.Contracts/Responses/CapturePosPaymentResponse.cs b/src/Pos.Transactions.Bff.Contracts/Responses/CapturePosPaymentResponse.cs new file mode 100644 index 0000000..683f96a --- /dev/null +++ b/src/Pos.Transactions.Bff.Contracts/Responses/CapturePosPaymentResponse.cs @@ -0,0 +1,7 @@ +namespace Pos.Transactions.Bff.Contracts.Responses; + +public sealed record CapturePosPaymentResponse( + string ContextId, + string TransactionId, + bool Succeeded, + string Summary); diff --git a/src/Pos.Transactions.Bff.Rest/Program.cs b/src/Pos.Transactions.Bff.Rest/Program.cs index d14e347..1c34bfe 100644 --- a/src/Pos.Transactions.Bff.Rest/Program.cs +++ b/src/Pos.Transactions.Bff.Rest/Program.cs @@ -5,6 +5,7 @@ using Pos.Transactions.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/pos/transactions/summary", async (string contextId, IGetPosTran return Results.Ok(await handler.HandleAsync(request, ct)); }); +app.MapPost("/api/pos/transactions/payments", async (CapturePosPaymentRequest request, ICapturePosPaymentHandler handler, CancellationToken ct) => +{ + return Results.Ok(await handler.HandleAsync(request, ct)); +}); + +app.MapGet("/health", () => Results.Ok(new { status = "ok", service = "pos-transactions-bff" })); +app.MapGet("/healthz", () => Results.Ok(new { status = "ok", service = "pos-transactions-bff" })); + app.Run();