# Volpebox.it

Volpebox.it 是一个面向开发、产品和实施团队的内部功能文档库。它用来整理现有系统里的产品能力，把每个功能拆成使用说明、设计痛点、解决程度、未解决问题和开发 milestone。

第一版已导入 FortuneRMS 的功能点，后续可以继续加入其他系统。

## 快速打开

直接打开：

```bash
open /Users/ku/Code/Volpebox.it/index.html
```

如果浏览器限制本地脚本，也可以开一个本地静态服务：

```bash
cd /Users/ku/Code/Volpebox.it
python3 -m http.server 4173
```

然后访问 `http://localhost:4173`。

## 项目结构

```text
Volpebox.it/
  index.html
  assets/
    app.js
    styles.css
  data/
    fortune-rms.js
  docs/
    plans/
      2026-06-28-volpebox-it-doc-library.md
    systems/
      fortune-rms/
        README.md
    templates/
      feature-card.md
      system-intake.md
```

## 内容模型

每个产品按这个结构整理：

- Product: 系统或产品名，比如 FortuneRMS
- Module: 业务模块，比如 POS 收银、预约系统、库存
- Feature points: 模块下的具体功能点
- User guide: 使用路径和操作说明
- Pain points: 设计时要解决的业务痛点
- Impact estimate: 预计能解决多少问题，先用区间描述，等真实数据校准
- Limits: 仍然无法解决或需要试点验证的问题
- Milestones: 开发导向的小步骤，方便逐步搭建完整系统

## 新系统导入流程

1. 把新系统的原始功能说明放到 `docs/systems/<system-name>/source-notes.md`。
2. 按 `docs/templates/system-intake.md` 补齐产品背景、角色、渠道和约束。
3. 在 `data/` 下新增 `<system-name>.js`，按 FortuneRMS 的结构录入模块。
4. 在 `index.html` 引入新的数据文件。
5. 打开页面检查搜索、模块详情和 milestone 是否可读。