# Estéban's infrastructure ecosystem

Explore the websites, services, internal tools, and dependencies in my infrastructure.

- [api.soubiran.dev](/infra/services/api-soubiran-dev), service
  - Forge, deployment. Deploy the Laravel application and run its database migrations and metadata imports.
    - [GitHub](https://github.com/barbapapazes/api.soubiran.dev), repository. Host the public application source and Forge deployment script.
      - [Laravel](https://laravel.com), stack. Handle HTTP routes, persistence, authorization, queues, and notifications.
      - [Laravel Sanctum](https://laravel.com/docs/sanctum), stack. Authenticate first-party browser requests with the Laravel session.
      - [Laravel Socialite](https://laravel.com/docs/socialite), stack. Connect user accounts to GitHub, Google, and Discord.
      - [Filament](https://filamentphp.com), stack. Provide the private administration panel for application records.
      - [Spatie Laravel Markdown](https://github.com/spatie/laravel-markdown), stack. Render the Markdown preview used when writing comments.
      - [Sentry](https://sentry.io), stack. Capture application exceptions and performance traces.
    - [redeploy.soubiran.dev](/infra/services/redeploy-soubiran-dev), service. Trigger this deployment only after an upstream website reaches production.
  - soubiran.dev metadata, data. Supply stable page IDs, titles, and URLs for personal website content and infrastructure documentation.
    - [soubiran.dev](/infra/websites/soubiran-dev), website. Publish the metadata during its static build.
  - [soubiran.dev](/infra/websites/soubiran-dev), website, consumer. Read public interaction data and send authenticated changes from the browser.
- [automation.soubiran.dev](/infra/services/automation-soubiran-dev), service
  - Cloudflare One, auth. Protect the automation endpoints so only my CLI can trigger them.
    - Cloudflare Workers, deployment. Expose the automation endpoints and trigger workflows from incoming requests.
      - Cloudflare Build, build. Deploy the worker and workflows automatically on each push.
        - GitHub, repository. Host the private source code for this internal automation service.
          - [Wrangler](https://developers.cloudflare.com/workers/wrangler), stack
          - [Evlog](https://evlog.dev), stack
      - Cloudflare Workflows, workflows. Run background jobs for the automation tasks handled by the service.
  - Cloudflare Domains, domain. Manage the DNS records that route `automation.soubiran.dev` to the worker.
- [calendar.soubiran.dev](/infra/internal-tools/calendar-soubiran-dev), internal-tool
  - Cloudflare Workers, deployment. Authorize calendar subscriptions and return the current iCalendar object.
    - [GitHub](https://github.com/barbapapazes/platform), repository. Host the private Worker and content-creation CLI source.
      - [Wrangler](https://developers.cloudflare.com/workers/wrangler/), stack. Configure the custom domain and R2 binding, then deploy the Worker.
      - [Evlog](https://evlog.dev), stack. Record structured delivery events without recording the calendar token.
    - Cloudflare R2, object-storage. Store the generated calendar under the fixed `content-creation.ics` key.
      - LinkedIn iCalendar feed, data. Hold the complete set of dated LinkedIn entries as all-day events.
        - Content creation CLI, build. Generate the complete feed and upload it to R2.
          - LinkedIn Markdown, data. Supply dated publication state and metadata from the private content repository.
  - Cloudflare Domains, domain. Route `calendar.soubiran.dev` to the Worker.
- [code.soubiran.dev](/infra/websites/code-soubiran-dev), website
  - Cloudflare Workers, deployment. Serve the browser app and handle the public `/mcp` endpoint.
    - [GitHub](https://github.com/barbapapazes/code.soubiran.dev), repository. Host the editor, Worker, shared image contract, and deployment configuration.
      - [Vite](https://vite.dev), stack. Build the browser app and Worker from one project.
      - [Vue](https://vuejs.org), stack. Bind the editor controls to URL search parameters.
      - [Nuxt UI](https://ui.nuxt.com), stack. Provide the editor controls and visual components.
      - [Shiki](https://shiki.style), stack. Render the syntax-highlighted code layer in the browser.
      - [modern-screenshot](https://github.com/qq15725/modern-screenshot), stack. Capture the rendered editor element as a PNG in the browser.
      - [Model Context Protocol SDK](https://modelcontextprotocol.io), stack. Define the image-generation tool and its image response.
      - [Cloudflare Agents](https://developers.cloudflare.com/agents/), stack. Expose the MCP server through the Worker's `/mcp` route.
      - [Evlog](https://evlog.dev), stack. Record structured MCP tool telemetry without logging image content.
      - GitHub Actions, ci/cd, consumer. Lint, build, type-check, and test changes pushed to the repository.
    - [Cloudflare Browser Run](https://developers.cloudflare.com/browser-rendering/), stack. Load a URL that describes an image and capture its rendered editor element.
  - Cloudflare Domains, domain. Route `code.soubiran.dev` to the Worker deployment.
- [mcp.soubiran.dev](/infra/services/mcp-soubiran-dev), service
  - Cloudflare Workers, deployment. Expose the MCP server at `/mcp` and redirect other paths to the personal website.
    - [Wrangler](https://developers.cloudflare.com/workers/wrangler/), build. Deploy the TypeScript Worker with Wrangler.
    - [GitHub](https://github.com/barbapapazes/mcp.soubiran.dev), repository. Host the Worker source, content tools, and deployment configuration.
      - [Model Context Protocol SDK](https://modelcontextprotocol.io), stack. Define the server, tool inputs, and protocol responses.
      - [Cloudflare Agents](https://developers.cloudflare.com/agents/), stack. Handle MCP requests at the Worker's `/mcp` endpoint.
      - [Zod](https://zod.dev), stack. Validate localized page catalogs and tool inputs.
      - [Acorn](https://github.com/acornjs/acorn), stack. Parse query code and require a single asynchronous arrow function.
    - [Cloudflare AI Search](https://developers.cloudflare.com/ai-search/), data. Search the `soubiran-dev` instance through the `AI_SEARCH` namespace binding.
    - [Cloudflare Worker Loader](https://developers.cloudflare.com/workers/runtime-apis/worker-loader/), runtime. Execute metadata queries in temporary Workers with network access disabled.
  - Localized page catalogs and Markdown, data. Load `pages.en.json` and `pages.fr.json`, then retrieve documents through each record's `markdownUrl`.
    - [soubiran.dev](/infra/websites/soubiran-dev), website, producer. Publish pages, posts, series, talks, and infrastructure documentation in a shared content catalog.
  - [Sentry](https://sentry.io), monitoring. Capture request and tool exceptions without collecting user information or HTTP bodies.
  - [Evlog](https://evlog.dev), monitoring. Record structured request and tool outcomes with sensitive content redacted.
- [redeploy.soubiran.dev](/infra/services/redeploy-soubiran-dev), service
  - Cloudflare One, auth. Authenticate deployment requests before they reach the Worker.
    - Cloudflare Workers, deployment. Validate each request and start its deployment workflow.
      - [GitHub](https://github.com/barbapapazes/redeploy.soubiran.dev), repository. Host the public Worker source and deployment configuration.
        - [Cloudflare SDK](https://github.com/cloudflare/cloudflare-typescript), stack. Read Worker build and production deployment state from the Cloudflare API.
        - [Evlog](https://evlog.dev), stack. Correlate the incoming request with its Workflow execution.
        - [Wrangler](https://developers.cloudflare.com/workers/wrangler/), stack. Configure and deploy the Worker and Workflow binding.
      - Cloudflare Workflows, workflows, consumer. Wait for the upstream deployment and invoke the dependent deploy hook.
        - Cloudflare deploy hooks, ci/cd, consumer. Start the dependent build after the upstream Worker reaches production.
          - [api.soubiran.dev](/infra/services/api-soubiran-dev), service, consumer. Rebuild after infrastructure or personal website content changes.
          - [soubiran.dev](/infra/websites/soubiran-dev), website, consumer. Rebuild after new talk metadata reaches production.
  - [soubiran.dev](/infra/websites/soubiran-dev), website. Request an API rebuild after publishing personal website content or infrastructure documentation.
  - [talks.soubiran.dev](/infra/websites/talks-soubiran-dev), website. Request a personal website rebuild after publishing talk metadata.
  - Cloudflare Domains, domain. Route `redeploy.soubiran.dev` to the Worker.
- [soubiran.dev](/infra/websites/soubiran-dev), website
  - Cloudflare Workers, deployment. Serve the generated `.output/public` directory with Workers Static Assets.
    - [Nuxt generate](https://nuxt.com/docs/4.x/api/commands/generate), build. Generate static pages, localized catalogs, and Markdown endpoints, then deploy with Wrangler.
      - [GitHub](https://github.com/barbapapazes/beta.soubiran.dev), repository. Host the personal website, Markdown content, and local Nuxt modules.
        - [Nuxt](https://nuxt.com), stack
        - [Nuxt Content](https://content.nuxt.com), stack. Import local Markdown and remote content into typed collections.
        - [Nuxt UI](https://ui.nuxt.com), stack
        - [Vue](https://vuejs.org), stack
        - [Tailwind CSS](https://tailwindcss.com), stack
        - [Vue Flow](https://vueflow.dev), stack. Render infrastructure ecosystem and dataflow diagrams.
        - [Pinia Colada](https://pinia-colada.esm.dev), stack. Manage browser-side API queries and mutations.
  - [talks.soubiran.dev](/infra/websites/talks-soubiran-dev), website, producer. Supply localized talk catalogs, per-talk metadata, summaries, transcripts, and statistics at build time.
  - Infrastructure documentation, data. Read English-only Markdown from `content/infra/` and publish it under `/infra`.
  - [GitHub repository data](https://docs.github.com/en/rest/repos/repos#get-a-repository), data. Fetch public repository metadata during the build for the projects section.
  - [api.soubiran.dev](/infra/services/api-soubiran-dev), service, producer. Handle authentication, comments, reactions, feedback, messages, notifications, administration, and assistant requests.
  - [PartyKit](https://www.partykit.io), realtime. Connect to the `soubiran-dev` room for the live viewer count when a host is configured.
  - Localized page catalogs and Markdown, data, consumer. Publish `pages.en.json`, `pages.fr.json`, and `/raw/` Markdown documents with stable content IDs.
    - [mcp.soubiran.dev](/infra/services/mcp-soubiran-dev), service, consumer. Load both catalogs to search, query metadata, and retrieve complete Markdown documents.
  - [Umami](https://umami.is), analytics. Track page views and user interactions through `useAnalytics`.
  - [Sentry](https://sentry.io), monitoring. Capture errors and identify releases by the build's Git commit.
  - Cloudflare Domains, domain. Manage the website's domain.
- [talks.soubiran.dev](/infra/websites/talks-soubiran-dev), website
  - Cloudflare Workers, deployment. Serve `dist`, including decks, thumbnails, localized catalogs, and Markdown artifacts.
    - Cloudflare Build, build. Build the Slidev workspaces and deploy their combined static output.
      - [GitHub](https://github.com/barbapapazes/talks), repository. Host the decks, shared theme, metadata package, and generation scripts.
        - [Slidev](https://sli.dev), stack. Compile each event workspace into a static deck.
        - [@soubiran/talks](https://www.npmjs.com/package/@soubiran/talks), stack. Define localized metadata schemas and statistics types shared with the website.
        - GitHub Actions, ci/cd, consumer. Check changes and request a dependent website deployment after pushes to `main`.
          - [redeploy.soubiran.dev](/infra/services/redeploy-soubiran-dev), service, consumer. Wait for the `talks` Worker deployment, then invoke the website deploy hook.
            - [soubiran.dev](/infra/websites/soubiran-dev), website, consumer. Rebuild using the published talk metadata and artifacts.
  - Localized talk metadata and artifacts, data, consumer. Publish `talks.en.json`, `talks.fr.json`, per-talk metadata, summaries, and recorded-talk transcripts.
    - [soubiran.dev](/infra/websites/soubiran-dev), website, consumer. Import both locales into Nuxt Content and publish talk pages and Markdown documents.
      - [mcp.soubiran.dev](/infra/services/mcp-soubiran-dev), service, consumer. Discover and retrieve talk documents through the website's page catalogs.
  - [Talk statistics](https://talks.soubiran.dev/statistics.json), data, consumer. Publish aggregate statistics in `statistics.json`.
    - [soubiran.dev](/infra/websites/soubiran-dev), website, consumer. Render the statistics section from validated build-time data.
  - PDF and audio storage, object-storage. Serve exports through `pdf.talks.soubiran.dev` and `audio.talks.soubiran.dev`.
  - Cloudflare Domains, domain. Route `talks.soubiran.dev` to the archive.
