LocalShare - 局域网消息与文件共享工具

一个基于 Web 的局域网共享工具，支持消息发布和文件共享。

功能特性

• 创建会话，组织消息和文件
• 发布文本消息
• 上传和下载文件
• 删除会话（需输入会话名确认）
• 响应式设计，支持移动端

技术栈

• 后端：Python + Flask + SQLite
• 前端：React + Vite + TailwindCSS

快速开始

1. 启动后端

cd backend

# 创建虚拟环境
python -m venv venv
# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 启动服务
python main.py

后端将运行在 http://localhost:8000

2. 启动前端

cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

前端将运行在 http://localhost:3000

3. 访问应用

打开浏览器访问 http://localhost:3000

局域网内其他用户可通过 http://<你的局域网IP>:3000 访问

生产部署

# 1. 构建前端
cd frontend
npm run build

# 2. 复制构建产物到后端
# Windows:
xcopy /E /I dist ..\backend\static
# Linux/Mac:
cp -r dist/* ../backend/static/

# 3. 启动后端
cd backend
python main.py

生产模式下，访问 http://localhost:8000 即可使用

项目结构

localshare/
├── backend/           # Python 后端
│   ├── main.py        # 应用工厂
│   ├── database.py    # 数据库初始化
│   ├── models.py      # 数据工具
│   ├── config.py      # 配置文件
│   ├── routers/       # API 路由
│   ├── services/      # 业务逻辑
│   └── uploads/       # 文件存储目录
├── frontend/          # React 前端
│   ├── src/
│   │   ├── api/       # API 调用
│   │   ├── pages/     # 页面组件
│   │   └── components/# UI 组件
│   └── package.json
└── docs/              # 文档
    ├── PRD.md         # 产品需求文档
    ├── TDD.md         # 技术设计文档
    ├── SAD.md         # 软件架构文档
    └── START.md       # 启动指南