메뉴
Orientation map for the open-meet monorepo. Use at the start of a task to find which app, module, and shared package own a feature (auth, meetings, meeting-scoped chat, persistent team chat, recording, RBAC, branding, uploads) before editing. Answers "where does this change go?".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Playbook for adding or changing API behavior in apps/server (NestJS + Fastify). Use when implementing endpoints, services, repositories, DTOs, guards, or gateways. Enforces controller→service→repository layering, the shared response/error envelope, DTO validation, and the separate user/admin auth systems.
Playbook for UI work in apps/web and apps/admin (Next.js App Router + next-intl). Use when adding pages, components, hooks, forms, or data fetching. Enforces Server Components by default, TanStack Query, react-hook-form + Zod, the typed API clients, @open-meet/ui primitives, and locale-aware routing.
Use whenever adding or changing user-facing UI or API copy. open-meet ships 15 locales; this skill keeps every locale in lockstep and registers new namespaces so useTranslations doesn't throw at runtime.
Use for database/schema work in apps/server — adding models, fields, relations, indexes, or migrations. The Prisma schema is split into multiple files by domain; this skill keeps edits and migrations in the right place.
Use when changing websocket / Socket.IO behavior — events, payloads, or gateways. open-meet has two namespaces (/meeting and /chat); this skill keeps the shared socket contract and both ends in sync.
Use before finishing a task to pick and run the narrowest relevant checks for what you changed, and to self-review the change checklist. Maps the changed area to the exact lint/typecheck/test commands.
| name | repo-map |
| description | Orientation map for the open-meet monorepo. Use at the start of a task to find which app, module, and shared package own a feature (auth, meetings, meeting-scoped chat, persistent team chat, recording, RBAC, branding, uploads) before editing. Answers "where does this change go?". |
Monorepo: pnpm workspaces + Turborepo. Three apps + shared packages. Live API reference: Swagger at http://localhost:3002/api/docs.
apps/web — user-facing Next.js app. Routes app/[locale]/; features features/web/{auth,home,lobby,meeting,chat,history,account}; typed API wrappers lib/api/; providers/, stores/.apps/admin — admin console (Next.js). Routes app/[locale]/; features features/{accounts,analytics,auth,branding,configuration,dashboard,groups,meetings,profile,rbac,users}; API wrapper lib/api/.apps/server — NestJS + Fastify API, global /api prefix. Bootstrap/global: src/main.ts, src/common/*. User modules: src/modules/client/{auth,meetings,chat,messaging,recording,settings}. Admin modules: src/modules/admin/*. Public config: src/modules/config. Uploads: src/modules/uploads. Storage: src/storage. Realtime infra: src/websocket. Integrations: src/integrations/{livekit,redis,mail}. Prisma: prisma/schema/*.prisma. Tests: test/unit, test/e2e.@open-meet/types (packages/types) — DTOs src/dto/*, API envelope src/api.ts, socket contracts src/socket.ts, RBAC catalog src/permissions/*.@open-meet/config — zod env schemas src/env.ts.@open-meet/ui — shared React primitives.@open-meet/utils — pure helpers.@open-meet/tailwind-config, @open-meet/typescript-config — shared presets.| Task | API | Frontend | Shared contract |
|---|---|---|---|
| User auth | modules/client/auth/* | apps/web features/web/auth/* | dto/auth.ts |
| Meetings / lobby / scheduling | modules/client/meetings/* | features/web/{meeting,lobby,home} | dto/meeting.ts |
| Meeting-scoped chat / reactions / knock | modules/client/chat/* (chat.gateway.ts) | features/web/meeting/* | socket.ts (/meeting) |
| Persistent team chat (DMs/groups) | modules/client/messaging/* (conversation.gateway.ts) | features/web/chat/* | dto/messaging.ts + socket.ts (/chat) |
| Recording | modules/client/recording/* | meeting controls | dto/recording.ts |
| Admin RBAC | modules/admin/rbac/* | apps/admin features/rbac/* | permissions/* |
| Branding / config | modules/config/*, modules/admin/{branding,configuration}/* | lib/branding.ts, admin features/{branding,configuration}/* | dto/config.ts |
| Uploads / storage | modules/uploads/*, storage/* | — | — |
| Shared response / contracts | — | — | packages/types/src/{api.ts,dto/*,socket.ts} |
When the owning area is unclear, search before editing. If you cannot confirm something from the repo, write "Not detected yet" rather than guess.
Deeper design: .claude/docs/architecture.md.