eleven

Imported from YusufStar/eleven (AGENTS.md). Install upstream with npx skills add YusufStar/eleven. Copyright stays with the author.

Eleven — Agent context

Full-stack CRM and project management app: organizations, contacts, deals, pipelines, projects, tasks, file storage. Multi-tenant; org upgrade via one-time Stripe payment.

Tech stack

• Backend: Bun + Elysia (port 3333), Prisma (PostgreSQL 16), Better Auth, Stripe webhook POST /webhooks/stripe, S3-compatible (e.g. R2) via @aws-sdk/client-s3, optional Sharp for images.
• Frontend: Next.js 16 App Router, shadcn/ui + Tailwind, TanStack Query + React Hook Form + Zod, TanStack Table, Recharts.
• Local: Docker Compose (PostgreSQL, Redis). Use Bun for install/run/scripts (see .cursor/rules and backend/.cursor/rules).

Project layout

• backend/ — Elysia API: src/index.ts (CORS, auth mount, routes), src/auth/, src/plugins/, src/routes/ (contacts, deals, payments, projects, profile, team, tasks, upload, settings), src/dummy/, prisma/schema.prisma + migrations.
• frontend/ — Next.js: app/(auth)/, app/dashboard/, app/accept-invitation/, components/, services/ (API + TanStack Query), lib/ (auth-client, utils, schema).

Conventions

• Language: English only (UI, copy, comments, docs, errors). Rule: .cursor/rules/english-only.mdc.
• Backend: Prefer Bun over Node/npm/pnpm; run from backend/ with bun run dev, bun run db:migrate, bun run db:generate, bun run db:studio. Rule: backend/.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc.
• API: REST; auth via Elysia auth plugin; org-scoped data where applicable.
• DB: Prisma schema in backend/prisma/schema.prisma; client output in backend/prisma/generated/prisma. Main entities: User, Session, Organization, Member, Contact, Deal, Pipeline, Stage, Activity, Project, Task, ProjectFile, TaskAttachment, Plan/paidAt.

Key paths

• Backend entry: backend/src/index.ts
• Auth: backend/src/auth/, backend/src/plugins/auth.plugin.ts
• Routes: backend/src/routes/ (contacts, deals, payments, projects, team, tasks, upload, settings)
• Frontend auth: frontend/lib/auth-client.ts
• Services (API + queries): frontend/services/ (contacts, deals, payments, projects, tasks, team, upload, settings)

Scripts

Learned User Preferences

• User may ask in Turkish; keep all project UI, copy, code comments, and docs in English unless explicitly told otherwise.
• Use Bun (bun run, bun install, bun patch) for backend scripts and dependency patches—not npm.

Learned Workspace Facts

• Product is pivoting from CRM to a team work platform (tasks, sprints, projects, chat, files, AI reports); CRM entities (contacts, deals, pipelines) are being removed.
• Prisma uses @prisma/adapter-pg with a Bun patch at backend/patches/@prisma%2Fadapter-pg@7.8.0.patch fixing duplicate values passed to pg.client.query in performIO.
• Do not use explicit pg.Pool with Bun + PrismaPg—it conflicts with the Bun runtime.
• Two Postgres URLs: DATABASE_URL (superuser, Better Auth) and DATABASE_APP_URL (RLS org-scoped via dbForOrg() in backend/src/db/prisma.ts).
• AI Reports: Claude tool-calling returns structured JSON via submit_report (KPIs, Recharts charts, recommended actions); actions persist in AiReportAction with apply endpoints; legacy markdown reports render read-only via the legacy dashboard.
• Real-time updates use a WebSocket hub (backend/src/lib/ws-hub.ts, /live routes); chat may still fall back to polling.