Files
LFSpecs/README.md
T

55 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# LFSpecs
公开硬件规格库:收录手机、芯片等设备的详细参数,支持横向对比。设计文档见 [DESIGN.md](./DESIGN.md)。
## 技术栈
Astro 7(SSR / Node adapter)+ Tailwind CSS 4 + shadcn/ui(React islands)+ SQLite(`node:sqlite`,无原生依赖)
## 本地开发
```bash
pnpm install
cp .env.example .env # Windows: Copy-Item .env.example .env
pnpm db:seed # 建表 + 写入种子数据(Xiaomi 14 / 骁龙 8 Gen 3)
pnpm dev # http://localhost:4321
```
组件自检页:`/poc`(验证 Button / Card / Dialog 可用,M0 验收后可删)。
## 部署
### 小内存服务器(当前 ECS 方案)
ECS 只有 1.6G 内存,Docker 多阶段构建会触发 `kcompactd` 长时间阻塞(load 飙到 40+)。因此改为「宿主构建 + 容器挂载」:
```bash
bash scripts/deploy.sh
```
脚本依次执行:拉代码 → `pnpm install` → `pnpm build` → `docker compose up -d --force-recreate`。容器用 `node:24-slim` 镜像,挂载 `dist` / `node_modules` / `data`,只有 `./data` 需要持久化。
前提:服务器 Node 装在 `/opt/node`(脚本会自动加进 PATH),且已存在 `.env`。
### 普通机器 / CI
`docker compose build && docker compose up -d` 仍可用仓库里的 `Dockerfile` 构建单镜像,不需要挂载。
## 运维
```bash
pnpm backup # VACUUM INTO 快照 + 打包 uploads 到 backups/<时间戳>/
pnpm db:seed # 重跑种子数据(幂等,按 slug upsert)
```
## 目录
```
src/lib/schema/ zod 数据模型(phone / soc / FieldMeta)
src/lib/db.ts SQLite 连接 + 迁移
src/lib/repo.ts 唯一数据出入口
src/lib/storage.ts 图片存储驱动(local / s3 接口)
migrations/ SQL 迁移,按文件名顺序执行
scripts/ seed / backup
```