LawLink AGENTS.md

LawLink 工作区规则

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

---

一、项目定位

• LawLink 是面向独立律师、小团队和小型律所的开源、自部署案件/项目管理系统。
• 第一版主线工作流： 收案登记 → 冲突检索 → 转正式案件 → 持续跟进 → 财务记录 → 结案归档 → 数据导出
• 不做共享 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)/         # 登录后的主应用路由分组
│   │   └── 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 引入）

规则：

• src/components/ui/ 只放 shadcn/Radix 原子组件。允许在原子层维护全站统一的语义 token、无障碍和基础动效适配，但禁止加入 LawLink 业务结构或领域判断；更新 shadcn 时必须审计并保留这些适配。
• src/components/patterns/ 放 PageHeader、ListToolbar、FormSection、全局动效策略等 LawLink 品牌化跨页面模式，不承载 Server Action 或领域状态机。
• 跨页面复用的业务组件提到对应领域目录，仅单页用的组件就近放在路由目录下 _components/。
• 业务规则（金额计算、状态机、冲突匹配算法）一律沉淀到 src/lib/ 或 src/server/，禁止散落在页面里。