Session 3 — Architecture Standards

Goal: Confirm the technical architecture decisions are still current and internally consistent. Estimated time: 90 min

Reading Order

Read in this order — dependencies flow top-down:

#	File	What It Covers
1	domain-driven-design.md	Bounded contexts, CQRS, cross-context patterns, context map. The architectural backbone.
2	database.md	PostgreSQL strategy, schema separation, pgvector.
3	frontend.md	Vue 3/Nuxt/Quasar split, FSD layers, shared packages.
4	app-structure.md	Workspace app feature layout, folder conventions, route structure.
5	design-system.md	Component library, token system, Tailwind conventions.
6	roles.md	RBAC roles, capability model, role→frontend matrix.
7	validation-strategy.md	Input validation layers, Zod schemas, Hasura validation.
8	monorepo.md	Turborepo pipeline, caching, Docker build strategy, pnpm conventions.
9	realtime-strategy.md	WebSocket, Hasura subscriptions, live updates.
10	ai.md	RAG pipeline, agent workflows, Paperclip, MCP bridge.
11	communications.md	Omnichannel inbox, notification pipeline, channel provisioning.
12	workflow-orchestration.md	BullMQ, event triggers, scheduled jobs, worker patterns.
13	gdpr-strategy.md	Data retention, encryption, TTL policies, right to erasure.
14	tests.md	Testing strategy, Vitest, Playwright, offline testing.

🔍 What to Validate

• [ ] domain-driven-design.md §8 Context Map: does each upstream/downstream relationship still hold? Cross-reference with event-catalog.md (Session 5).
• [ ] roles.md: the Manager/Dispatcher/Driver trio — is the Driver auth flow documented anywhere? (Flagged as missing.)
• [ ] ai.md references Paperclip for agentic company governance — is this still the chosen platform?
• [ ] monorepo.md references Vercel Remote Cache as "planned" — still planned or dropped?
• [ ] gdpr-strategy.md: does it cover the right-to-erasure implementation, or only the strategy?
• [ ] tests.md: does the testing strategy match what tests actually exist in the repo today?
• [ ] frontend.md lists apps/backoffice/ — does this app still exist, or was it merged into workspace?
• [ ] design-system.md: does it reference Quasar's default UI bypass accurately? Is ShadCN-vue still the chosen library?
• [ ] validation-strategy.md at 3 KB — is this complete, or does it need expanding?
• [ ] workflow-orchestration.md at 18 KB — does it still reflect the actual NestJS worker patterns in the codebase?

Findings