# LS

**Repository Path**: ljhasdasdasd/ls

## Basic Information

- **Project Name**: LS
- **Description**: 鼠子的智能AI助手
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-24
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 法律智能系统 (Legal Smart System) 项目文档

本项目是一个基于 **Java Spring Boot** 后端和 **React** 前端的法律智能管理系统，模仿 Alpha/iCourt 的设计理念，提供案件管理、智能检索、文档管理和律师协作功能。

## 1. 系统架构

### 1.1 技术栈

*   **后端 (Server)**
    *   **语言**: Java 17
    *   **框架**: Spring Boot 3.2.3
    *   **数据库**: MySQL 8.0
    *   **缓存**: Redis 7.0
    *   **安全**: Spring Security + JWT (JSON Web Token)
    *   **ORM**: Spring Data JPA (Hibernate)

*   **前端 (Web)**
    *   **框架**: React 18 + TypeScript
    *   **构建工具**: Vite
    *   **路由**: React Router DOM
    *   **样式**: CSS Modules / Lucide Icons

### 1.2 目录结构

```
LS/
├── docker-compose.yml      # 数据库和缓存的基础设施编排
├── server/                 # 后端项目代码 (Maven)
│   ├── src/main/java/      # Java 源代码
│   ├── src/main/resources/ # 配置文件 (application.yml)
│   └── pom.xml             # Maven 依赖定义
└── web/                    # 前端项目代码 (npm)
    ├── src/                # React 组件和页面
    ├── package.json        # 前端依赖定义
    └── vite.config.ts      # Vite 配置
```

---

## 2. 快速启动指南

### 2.1 前置要求

*   **Docker Desktop** (推荐) 或 Docker Engine
*   **Node.js** (v16+)
*   (可选) Java JDK 17+ 和 Maven (如果想在本地非 Docker 环境运行后端)

### 2.2 步骤一：启动基础设施 (MySQL & Redis)

在项目根目录下运行：

```bash
docker-compose up -d
```

这将启动 MySQL (端口 3306) 和 Redis (端口 6379)。
*   **数据库名**: `legal_smart`
*   **用户名**: `root`
*   **密码**: `root`

### 2.3 步骤二：启动后端服务

**方式 A：使用 Docker 运行 (无需本地安装 Java/Maven)**

```bash
docker run --rm --name legal-app \
  -v "$(pwd)/server":/usr/src/mymaven \
  -w /usr/src/mymaven \
  -p 8080:8080 \
  maven:3.9-eclipse-temurin-17 mvn spring-boot:run
```

**方式 B：本地运行 (需安装 JDK 17)**

1.  修改 `server/src/main/resources/application.yml`，将 `host.docker.internal` 改回 `localhost`。
2.  进入 server 目录并运行：
    ```bash
    cd server
    ./mvnw spring-boot:run
    # 或者如果安装了 maven
    mvn spring-boot:run
    ```

后端启动后，API 地址为: `http://localhost:8080/api`

### 2.4 步骤三：启动前端服务

打开新的终端窗口：

```bash
cd web
npm install
npm run dev
```

前端启动后，访问地址为: `http://localhost:5173`

### 2.5 登录系统

系统首次启动时会自动创建管理员账号：

*   **用户名**: `admin`
*   **密码**: `admin123`

---

## 3. 功能模块说明

### 3.1 案件管理 (Case Management)
*   查看所有案件列表，支持状态筛选 (Active, Pending, Closed)。
*   创建新案件，关联客户信息和案件类型。
*   删除案件 (软删除或物理删除)。

### 3.2 智能检索 (AI Research)
*   集成多个法律数据库入口 (Quark AI, 中国裁判文书网, 北大法宝等)。
*   记录用户的检索历史。
*   后台 API 已预留 AI 接口调用位置，可对接 LLM 进行法律问答。

### 3.3 文档中心 (Documents)
*   上传、下载法律文书。
*   区分“模板文档”和“用户上传文档”。
*   文件存储在本地文件系统 (`server/upload-dir`)。

### 3.4 办案工具 (Tools & Notes)
*   **日期计算器**: 计算诉讼时效和举证期限。
*   **诉讼费计算器**: 估算案件受理费。
*   **办案笔记**: 随手记录案情摘要，支持增删改查。

### 3.5 日程管理 (Calendar)
*   可视化日历，展示开庭时间、会议和截止日期。
*   与案件数据联动 (未来规划)。

---

## 4. Docker 部署 (生产环境建议)

如果要将整个应用打包部署到服务器，建议创建一个顶层的 `Dockerfile` 或更新 `docker-compose.yml` 来包含应用服务。

**示例生产级 docker-compose.yml:**

```yaml
version: '3.8'
services:
  mysql:
    image: mysql:8.0
    # ... 配置保持不变 ...

  redis:
    image: redis:7.0
    # ... 配置保持不变 ...

  backend:
    build: ./server
    ports:
      - "8080:8080"
    depends_on:
      - mysql
      - redis
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/legal_smart
      - SPRING_REDIS_HOST=redis

  frontend:
    build: ./web
    ports:
      - "80:80"
```

---

## 5. 常见问题 (FAQ)

**Q: 启动后端时报错 "Connection refused" 连接数据库失败？**
A: 请确保 Docker 中的 MySQL 容器已启动 (`docker ps` 查看)。如果是 Mac 用户，确保 `application.yml` 中数据库地址使用的是 `host.docker.internal`；如果是 Linux 或 Windows，可能需要用 `localhost` 或容器名。

**Q: 前端登录后没有反应？**
A: 请检查浏览器控制台 (F12) 的 Network 标签，确认 `/api/auth/signin` 请求是否成功。如果失败，可能是后端未启动或 CORS 配置问题。

**Q: 如何修改数据库密码？**
A: 修改 `docker-compose.yml` 中的 `MYSQL_ROOT_PASSWORD`，同时更新 `server/.../application.yml` 中的配置，然后执行 `docker-compose down -v` (注意这会清空数据) 并重新启动。