# 手机品牌型号汇总

当前项目以根目录作为统一入口，支持通过 Docker Compose 直接启动设备查询、数据管理和 MySQL 服务。

## 启动方式

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

如需本地测试 MySQL，一起叠加测试配置启动：

```bash
docker compose -f docker-compose.yml -f docker-compose.test.yml up --build -d
```

如需自定义 MySQL 连接，先复制环境模板：

```bash
cp .env.example .env
```

页面入口：

- `http://127.0.0.1:8123/web/device_query.html`
- `http://127.0.0.1:8123/web/brand_management.html`
- `http://127.0.0.1:8123/web/device_query.html?view=docs`

## 目录结构

```text
workspace/  上游原始数据、补充资料与历史文件
dist/       构建产物与 MySQL seed
docs/       项目文档
sql/        MySQL schema
tools/      构建、同步、导入与服务脚本
web/        页面与静态资源
```

## 说明

- `workspace/` 用于存放原始数据工作区
- `docker-compose.yml`、`Dockerfile`、`tools/` 都位于项目主目录
- 默认主配置面向远程 MySQL
- `docker-compose.test.yml` 中的 MySQL 仅用于本地测试
- 容器内生成的 `dist/device_index.json` 与 `dist/mobilemodels_mysql_seed.sql` 会直接挂载到宿主机项目根目录的 `dist/`
- Compose 会优先读取 shell 环境变量和项目根目录 `.env`，再回退到 `docker-compose.yml` 默认值
- 上游原始 git 同步、索引构建和 MySQL 刷新都在容器内完成
- 项目内置“每日自动同步”调度，不依赖 GitHub Actions；时间点可在数据管理页设置，也可用 `.env` 覆盖默认值
- 如需 GitHub 加速，可配置 `GITHUB_PROXY_PREFIX`，也可在数据管理页直接修改

更多说明见：

- [docs/README.md](docs/README.md)
- [docs/web-ui.md](docs/web-ui.md)
