src/
├── app/                      # Next.js App Router (pages)
├── features/                 # Feature modules (business logic)
├── server/                   # oRPC routers (API layer)
├── components/               # Shared UI components
└── lib/                      # Utilities and configuration

app/
├── (auth)/                   # Auth pages (login, register)
│   ├── login/
│   ├── register/
│   ├── forgot-password/
│   └── reset-password/
│
├── (dashboard)/              # Main app (requires auth)
│   ├── dashboard/
│   ├── clients/
│   │   ├── page.tsx          # List page
│   │   ├── new/page.tsx      # Create page
│   │   └── [id]/page.tsx     # Detail page
│   ├── contacts/
│   ├── activities/
│   ├── files/
│   ├── users/
│   └── settings/
│
├── api/
│   ├── auth/[...all]/        # better-auth handler
│   └── rpc/[[...rest]]/      # oRPC endpoint (single API entry)
│
└── layout.tsx

features/
├── clients/
│   ├── index.ts              # Client-safe exports (types, hooks, UI)
│   ├── server.ts             # Server-only exports (queries, actions)
│   ├── queries.ts            # Database read operations
│   ├── actions.ts            # Database write operations
│   ├── validation.ts         # Zod schemas
│   ├── types.ts              # Domain types (optional)
│   ├── hooks/                # Custom React hooks (optional)
│   └── ui/                   # Feature-specific components
│       ├── ClientCard.tsx
│       └── ContactSheet.tsx
│
├── activities/
├── dictionaries/
├── files/
├── invitations/
└── users/

// ✅ Client Components - import from index.ts
import { ClientCard, useClients } from "@/features/clients"

// ✅ Server/Routers - import from server.ts
import { listClients, createClient } from "@/features/clients/server"

// ❌ NEVER import server.ts from Client Components

server/
├── orpc.ts                   # Procedure definitions (authedProcedure, etc.)
└── routers/
    ├── index.ts              # AppRouter - aggregates all routers
    ├── clients.ts
    ├── contacts.ts
    ├── activities.ts
    ├── files.ts
    ├── users.ts
    ├── dictionaries.ts
    └── invitations.ts

components/
├── ui/                       # shadcn/ui primitives
│   ├── button.tsx
│   ├── input.tsx
│   ├── dialog.tsx
│   └── ...
│
├── data-table/               # Table system
│   ├── DataTable.tsx
│   ├── DataTableToolbar.tsx
│   ├── DataTablePagination.tsx
│   └── ...
│
├── detail-page/              # Detail page layout
│   ├── DetailPageWrapper.tsx
│   ├── SectionCard.tsx
│   └── PropertyRow.tsx
│
├── detail-sheet/             # Side panel forms
│   ├── DetailSheetForm.tsx
│   └── SheetHeader.tsx
│
├── inline-edit/              # Inline editing
│   ├── EditableText.tsx
│   └── EditableSelect.tsx
│
└── layout/                   # App shell
    ├── AppSidebar.tsx
    ├── Header.tsx
    └── EntityHeader.tsx

lib/
├── orpc/
│   └── client.ts             # orpcUtils - TanStack Query integration
│
├── auth/
│   ├── index.ts              # Main auth exports
│   ├── roles.ts              # RBAC (owner, admin, member, viewer)
│   ├── session.ts            # Session helpers
│   └── providers/            # Auth provider implementations
│
├── db/
│   ├── index.ts              # Drizzle client
│   └── schema/               # Database tables
│       ├── auth.ts
│       ├── clients.ts
│       ├── activities.ts
│       └── ...
│
├── config/
│   ├── index.ts              # appConfig (central configuration)
│   ├── navigation.ts         # Nav items
│   └── colors.ts             # Theme colors
│
├── storage/                  # File storage adapters
├── email/                    # Email adapters
├── url-state/                # URL state management
└── env.ts                    # Environment variables (T3 Env)