# test_good

一个基于 Streamlit 的示例应用，展示各种数据可视化和交互功能。

## 功能特性

- 📊 多种图表类型（matplotlib、plotly）
- 📁 数据操作和处理
- 📝 交互式表单
- 🎨 可定制主题
- 📱 响应式布局

## 技术栈

- Python 3.14+
- Streamlit 1.52.1
- Matplotlib 3.10.8
- Plotly 6.5.0
- Pandas 2.3.3
- NumPy 2.3.5

## 快速开始

### 使用 uv（推荐）

```bash
# 安装依赖
uv sync

# 运行应用
uv run streamlit run app.py
```

### 使用传统方式

```bash
# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

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

# 运行应用
streamlit run app.py
```

## 项目结构

```
test_good/
├── app.py              # 主应用文件
├── main.py             # 入口文件
├── pyproject.toml      # 项目配置
├── justfile           # 任务自动化
├── Dockerfile         # Docker 配置
├── .dockerignore      # Docker 忽略文件
└── README.md          # 项目文档
```

## 使用 just

项目使用 justfile 进行任务管理：

```bash
# 查看所有可用命令
just --list

# 运行应用
just run

# 代码格式化
just fmt

# 代码检查
just lint
```

## Docker 部署

```bash
# 构建镜像
docker build -t test-good .

# 运行容器
docker run -p 8501:8501 test-good
```

## 开发指南

1. 代码风格遵循 PEP 8
2. 使用 ruff 进行代码格式化
3. 提交信息遵循 Conventional Commits 规范

## 许可证

MIT License