Analytics — Code Map

API

• apps/api/src/analytics/analytics.module.ts
• apps/api/src/analytics/analytics.controller.ts — REST surface, role guards, toCsv helper, EXPORT_TABS enum.
• apps/api/src/analytics/analytics.service.ts — all aggregation methods. INTERVAL_MONTHS constant; typed response interfaces (AnalyticsRevenueSummary, RevenueTrendPoint, PlanDistributionEntry, MembersSummary, MembersActivation, AtRiskMember, …).
• apps/api/src/analytics/analytics.service.driver.ts — DB test driver.
• apps/api/src/analytics/analytics.service.unit.spec.ts — service tests.
• apps/api/src/analytics/analytics.controller.unit.spec.ts — controller tests.

Agent surface

• apps/api/src/ai/agent/tools/leaves/analytics.tools.ts — twelve analytics.* tool actions, each delegating to a service method.
• libs/shared/src/lib/agent-schemas/analytics.ts — Zod schemas for the agent tool inputs.

Web

• apps/web/src/app/[lang]/(protected)/dashboard/analytics/ — page tree with per-tab routes.
• apps/web/src/components/analytics/* — KPI cards, charts, tables.
• apps/web/src/lib/api/analytics.ts — typed client wrappers using useApi.

Insights cross-reference

• apps/api/src/insights/insights.service.ts — the agent tool analytics.org_insights delegates here.

Schema dependencies

• libs/db/src/lib/schema/payments.ts — subscriptions, payment_transactions.
• libs/db/src/lib/schema/memberships.ts — memberships.
• libs/db/src/lib/schema/users.ts — users.
• libs/db/src/lib/schema/scheduling.ts — class_sessions, bookings, class_types.
• libs/db/src/lib/schema/workouts.ts — workouts, workout_assignments, personal_records.
• libs/db/src/lib/schema/invitations.ts — invitations.
• libs/db/src/lib/schema/organizations.ts — organizations.