Skip to main content

OPS Platform Engineering Onboarding

OPS Platform is Almalgo's operations platform for Deep Funding-style work: identity and access, teams and groups, circles, projects, tasks, reviews, payments, escrow/web3, notifications, integrations, analytics, and operational observability.

This section is written for engineers joining the project. It explains the current v2 architecture on main, preserves the v1 boundary branch, and documents project evolution from the first commit forward.

Branch model​

  • main: current v2 platform line.
  • v1: frozen v1 app branch created at b9ef9d5087dc14368120f659c81bc3706ca20af2.
  • feat/docs-website: documentation update branch.

Important nuance: v1 and v2 diverged around 10bca61 (2026-02-20). The v1 boundary commit b9ef9d5 is not an ancestor of current main; it is a frozen branch line with selected v1-era feature merges.

Current documentation snapshot​

  • Source commit at generation time: 6b63251
  • Full source commit: 6b63251aad520bf2fbda69e216cbebc4fd5d3674
  • v2 first-parent commits documented: 402
  • v1 first-parent commits documented: 121
  • v1 boundary: b9ef9d5087dc14368120f659c81bc3706ca20af2
  • v1/v2 merge-base: 10bca61b9c56e9cff9e3868b3f2d054e0a4aff55

What to read first​

  1. Local Development
  2. Architecture Overview
  3. Repository Map
  4. v1 and v2 Branches
  5. Commit-by-Commit History

Core repo areas​

  • apps/webapp — Next.js frontend.
  • backend/core-api — FastAPI backend and modular API.
  • supabase/migrations — database schema and migration history.
  • app-doc — Docusaurus docs site.
  • docs — internal runbooks, deployment docs, migration plans, and architecture references.
  • monitoring — Prometheus, Grafana, Alertmanager assets.
  • .github/workflows — CI/CD, deployment, and security workflows.