55 lines
1.8 KiB
Markdown
55 lines
1.8 KiB
Markdown
# 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
|
||
```
|