# ipmp **Repository Path**: hitools/ipmp ## Basic Information - **Project Name**: ipmp - **Description**: ipmp题库,欢迎加入丰富 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-06-03 - **Last Updated**: 2026-06-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # IPMP 客观题题库 一个离线 IPMP D 级客观题题库项目,包含最终清洗资源、SQLite 运行库、网页练习服务和 Flutter App。 ## 当前数据方案 `res/` 是当前最终题库资源包,也是后续重新导入 App 的标准入口。旧的解析中间文件、staging CSV 和旧题图目录已经不再作为维护来源。 - 最终题库:`res/question_bank/questions.csv` - 题图映射:`res/question_bank/question_images.csv` - 题图文件:`res/images///_img_.png` - 原始资料:`data/sources/*.pdf` - 运行库:`runtime/ipmp_topics.sqlite` - App 资源:`app/assets/question_bank/question_bank.sqlite`、`app/assets/question_images/` 当前最终资源统计: - 题目:510 道 - 题图:107 张 - 来源 PDF: - `IPMP国际项目管理D级考题答案.pdf` - `项目管理资料汇总.pdf` ## 文件结构 ```text . ├── app/ # Flutter 离线刷题 App │ └── assets/ # 由 runtime SQLite + res/images 生成 ├── data/ │ └── sources/ # 仅保留原始 PDF ├── db/ │ └── schema.sql # SQLite 题库表结构 ├── res/ # 最终清洗后的题库资源包 │ ├── README.md │ ├── question_bank/ │ │ ├── questions.csv │ │ ├── question_images.csv │ │ └── summary.json │ └── images/ ├── runtime/ # 本地运行库和备份 ├── scripts/ │ ├── ipmp_bank.py # 题库初始化、导入、导出、校验、抽题 CLI │ └── serve_bank.py # 本地/局域网刷题服务 ├── tools/ │ └── export_flutter_assets.py # 从 SQLite + res/images 导出 Flutter assets └── web/ └── index.html # Python 网页练习页面 ``` ## App 最新导入流程 从最终资源 `res/` 同步到 SQLite,再导出 Flutter App assets: ```bash python3 scripts/ipmp_bank.py import-csv \ res/question_bank/questions.csv \ --image-manifest res/question_bank/question_images.csv python3 scripts/ipmp_bank.py validate python3 tools/export_flutter_assets.py ``` `tools/export_flutter_assets.py` 默认读取: - 数据库:`runtime/ipmp_topics.sqlite` - 图片来源:`res/images` - 图片映射:`res/question_bank/question_images.csv` - 题库版本:`res/question_bank/summary.json` 中的 `bankVersion` 导出结果: - `app/assets/question_bank/question_bank.sqlite` - `app/assets/question_images/` 导出时会复制 SQLite 题库并写入 App 元数据表,清理 `app/assets/question_images/` 中不再被题库引用的旧图片,并将图片统一导出为 `res` 中的新命名,例如 `pm_summary_p031_q028_img_01.png`。 如果题目 ID 集合发生增删,先递增 `res/question_bank/summary.json` 的 `bankVersion`;App 会根据 `bankVersion` 只执行一次本地孤立做题记录清理。 ## CSV 字段 `res/question_bank/questions.csv`: | 字段 | 说明 | | --- | --- | | `external_id` | 题目编号,必须唯一 | | `type` | `true_false`、`single_choice`、`multiple_choice` | | `domain` | 知识域 | | `chapter` | 章节 | | `difficulty` | `easy`、`medium`、`hard` | | `status` | `draft`、`reviewed`、`published`、`archived` | | `source` | 题目来源 | | `stem` | 题干 | | `explanation` | 答案解析 | | `correct_options` | 默认选项顺序下的答案,如 `A`、`B`、`A,C` | | `option_1` - `option_6` | 选项内容 | | `image_count` | 题图数量 | | `image_paths` | 分号分隔的 `res/` 相对图片路径 | `res/question_bank/question_images.csv`: | 字段 | 说明 | | --- | --- | | `external_id` | 关联题目编号 | | `sort_order` | 题图顺序 | | `resource_path` | 新资源路径,相对 `res/` | | `resource_image_name` | 新图片文件名 | | `original_image_name` | 原始裁图文件名 | | `source_image_path` | 导出时的源图片路径 | | `source_page_number` | 来源 PDF 页码 | | `pdf_xref` | PDF 内嵌图片 xref | | `rect` | 图片在 PDF 页面上的矩形坐标 | ## 网页练习 本机使用: ```bash python3 scripts/serve_bank.py --question-image-dir app/assets/question_images ``` 浏览器打开: ```text http://127.0.0.1:8000 ``` 同一个 Wi-Fi 下小组手机访问: ```bash python3 scripts/serve_bank.py \ --host 0.0.0.0 \ --port 8000 \ --question-image-dir app/assets/question_images ``` ## Flutter 验证 ```bash cd app fvm flutter test ``` ## 维护原则 - `res/` 是清洗后的标准资源包。 - `data/sources/*.pdf` 是原始资料留档。 - `runtime/ipmp_topics.sqlite` 是本地运行库,可由 `res/` 重新导入。 - `app/assets/` 是 App 构建资源,可由 SQLite 和 `res/images` 重新导出。 - 不再依赖旧 `data/staging`、旧解析 CSV、旧 docx 或旧图片目录。 ## Git 管理建议 建议提交: - `res/**` - `data/sources/*.pdf`,是否提交取决于资料版权策略 - `db/schema.sql` - `scripts/*.py` - `tools/*.py` - `web/index.html` - `app/` - `README.md` 不建议提交: - `runtime/ipmp_topics.sqlite` - `runtime/wrong_topics.sqlite` - `runtime/backups/` - `__pycache__/` - `.DS_Store`