# MaiJie

**Repository Path**: Kumono/MaiJie

## Basic Information

- **Project Name**: MaiJie
- **Description**: Bilingual education knowledge platform
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-08
- **Last Updated**: 2026-08-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 迈杰教育双语内容平台

Nuxt 4 全栈内容平台，包含双语前台、可视化 Markdown 后台、PostgreSQL 搜索、MinIO 媒体库、标准图片位、SEO、Umami、Uptime Kuma 与自动备份。

## 本地启动

项目在开发和生产环境均使用 PostgreSQL 与 MinIO。首次启动：

```powershell
pnpm install
pnpm dev:setup
pnpm dev
```

MinIO 控制台地址为 `http://localhost:29001`（API 仍为 `http://localhost:9000`）。未设置密码哈希时，开发服务器可使用 `admin / admin` 登录；生产构建必须通过 `NUXT_ADMIN_PASSWORD_HASH` 配置密码。

复制 `.env.example` 为 `.env` 后可覆盖本地默认配置。管理员密码哈希通过以下命令生成：

```powershell
pnpm auth:hash "a-strong-password-of-at-least-12-characters"
```

## 常用命令

- `pnpm infra:up` / `pnpm infra:down`：启动或停止本地 PostgreSQL、MinIO。
- `pnpm db:migrate` / `pnpm db:seed`：迁移数据库并写入初始化数据。
- `pnpm lint`、`pnpm typecheck`、`pnpm build`：静态检查和生产构建。
- `pnpm test:unit`：运行带覆盖率阈值的单元测试。
- `pnpm test:integration`：使用隔离数据库与 Bucket 运行后台 API 集成测试。
- `pnpm test:e2e`：在 375、768、1024、1440px 下运行前台和后台 Playwright 测试。
- `pnpm test:all`：执行完整质量门禁。

部署、备份和后台操作见 [docs/deployment.md](docs/deployment.md)、[docs/backup-restore.md](docs/backup-restore.md) 和 [docs/admin-guide.md](docs/admin-guide.md)。

后台 PDF 数据导出需要可嵌入的中文 `.ttf` 或 `.otf` 字体。Windows 开发环境会自动使用系统黑体；生产环境请通过 `NUXT_EXPORT_FONT_PATH` 指向容器内的字体文件。