LawLink: Instructions file for Codex

LawLink 工作区规则

这是项目的"约束先行"文档。任何 AI 助手（含 Claude Code）或人类协作者在本仓库工作前，必须先读完本文件。 规则与实践冲突时，先改本文件、再改代码。

---

一、项目定位

• LawLink 是面向独立律师、小团队和小型律所的开源、自部署案件/项目管理系统。
• 品牌标语（2026-09-21 用户定稿）：事有经纬，案有始终。 README、GitHub 仓库简介及后续品牌展示统一使用此句；产品功能说明另行保留。
• 第一版主线工作流： 收案登记 → 冲突检索 → 转正式案件 → 持续跟进 → 财务记录 → 结案归档 → 数据导出
• 不做共享 SaaS 多租户。一个律所/团队部署一套实例，单体应用 + 单库。
• 协议：MIT。

---

二、技术栈（已定型）

层	选型	说明
框架	Next.js 16 App Router + TypeScript	SSR + RSC，单仓单进程
UI 组件	shadcn/ui + Radix UI	拷贝式组件，深度可定制
样式	Tailwind CSS	高密度浅色工作台，保留主题扩展能力
动效	Framer Motion	微交互、页面切换
React	React 19	Next.js 16 配套
图标	lucide-react
图表	Recharts	工作台、财务统计
表单	React Hook Form + Zod
表格	TanStack Table	表头筛选、排序、分页
数据库	PostgreSQL 16 + Prisma 5
鉴权	NextAuth.js（Credentials Provider）	邮箱密码登录
部署	Docker Compose（app + postgres）

已弃用：Ant Design。不要再引入 antd 或 @ant-design/*。

预留接入（V1.5）：元典开放平台 MCP（law/case/company），用于冲突检索增强和企业核查。

---

三、目录约定

LawLink/
├── docs/                  # 设计文档（PRD / DATA-MODEL / UI-DESIGN）
├── prisma/                # schema、迁移、seed
├── public/                # 静态资源
├── storage/               # 本地私有文件（不入 git）
├── src/
│   ├── app/               # 路由与 Route Handler
│   │   ├── (auth)/        # 登录、注册路由分组
│   │   ├── (app)/         # 登录后的主应用路由分组
│   │   ├── (admin)/admin/ # 独立管理后台页面壳；仍复用同一登录、服务层与数据库
│   │   └── api/           # API 路由
│   ├── components/
│   │   ├── ui/            # shadcn/Radix 原子组件与全局无障碍、动效适配
│   │   ├── patterns/      # LawLink 跨页面视觉与交互模式
│   │   ├── layout/        # AppShell、Sidebar、Topbar
│   │   ├── matters/       # 案件相关组合组件
│   │   └── ...
│   ├── lib/               # 业务规则、工具函数、Prisma client
│   │   ├── auth/          # NextAuth 配置、session helpers
│   │   ├── permissions/   # 角色权限、案件可见性
│   │   └── ...
│   ├── server/            # Server Actions、服务层
│   ├── types/             # 共享 TS 类型
│   └── styles/            # globals.css、Tailwind config 扩展
└── tests/                 # （V1.5 引入）