Life Connect ADB — wiki index

How this is organised

docs/
├── architecture/   concepts: how the whole thing fits together
├── services/       entities: one page per microservice or repo project
├── infra/          stubs: pointers to infra/*.md (Pulumi project, AWS audit)
├── concepts/       cross-cutting topics (events, deploy, auth, …)
├── runbooks/       how-to guides
├── decisions/      design decisions (ADR-style)  — empty for now
├── archive/        retired content (functional-epics/, technical-epics/, …)
└── index.md        you are here

Read the kind: field on each page's frontmatter to know what shape to expect.

Architecture (concepts)

• Overview — global topology, project inventory, Mermaid arch diagram.
• Service-to-service communication — FQDN, gateway, BFF, sync vs async.
• Data layer — MongoDB Atlas, S3, Neo4j, messaging.
• Authentication — Keycloak, JWT, token flow.

Cross-cutting concepts

• EventBridge fanout — Atlas Triggers → AWS partner buses → SQS queues.
• Atlas Triggers — the producer side of every async event.
• ECS Fargate deploy lifecycle — what pulumi up actually does.
• Keycloak hosting — Elestio EC2s per env, why not containerised.
• Cloudflare Pages auto-deploy — adb-doc and adb-ui delivery.
• Bitbucket Pipelines (legacy) — what's still on Bitbucket and why.
• Terraform-managed envs (legacy) — the 28 workspaces in tf-states.life-connect.fr.

Accounting model

• Accounting model overview — events, journals, plan of accounts, FEC, matrices.
• Events catalog — one page per AccountingEventType constant, with live code references.
• Journals · Plan of accounts · FEC fields · pieceReference numbering · Tenant matrix · Owner matrix · Take-over UI rules

Services (entities)

Backend (Java / Spring WebFlux):

• adb (Maven parent + proxy) · adb-persons · adb-parts · adb-contracts · adb-accounting
• adb-files · adb-utilities · adb-aggregates · adb-views · adb-reports

Frontend:

• adb-ui (Angular legacy) · adb-web (Cloudflare Workers BFF)

Infrastructure & tooling:

• adb-charts (legacy Helm) · adb-infrastructure (Atlas + EventBridge scripts) · adb-tests-artillery · adb-doc

External / non-monorepo:

• adb-tickets · adb-notes (deprecated) · adb-graph (incomplete)

Infrastructure (stubs to infra/*.md)

• Section overview
• Pulumi project overview — layout, stacks, local dev. Source: infra/README.md.
• Current AWS + MongoDB Atlas state — read-only audit baseline. Source: infra/CURRENT_AWS_STATE.md.
• MongoDB Atlas — Realm CLI setup — install + auth for atlas and realm-cli. Source: infra/MONGODB_REALM_CLI_SETUP.md.

Runbooks

• Provision a new environment — using infra/scripts/new-env.sh.
• Deploy a PR preview — /deploy and /destroy PR comments.
• Run the local stack — make up from infra/.

Reference

• Data dictionary — collection attributes — surviving from the legacy docs; will get frontmatter and a domain pass in a follow-up.

Archive

The archive/ tree holds content that was true at some point but isn't actively maintained: functional-epics, technical-epics, productBoard, implicit. Anything in archive/ defaults to status: stale.

• Archive index

Conventions and meta

• AGENTS.md — how agents operate on this wiki.
• Style guide — page conventions.
• adb-doc/log.md — chronological maintenance log (repo-only, not on the site).