้ ็ฎๅฏๆ็บๆง็ญ็ฅ (Sustainability Strategy)
่งฃๆฑบ้ขจ้ช: ๅฎไธ็ถญ่ญท่ ็ๅฏๆ็บๆง้ขจ้ชใๅ่ฝ่จ่นใๆ่กๆฃงไพ่ณด
ๆฌๆๆช่ชชๆ Boring-Gemini ้ ็ฎ็ๅฏๆ็บ็ผๅฑ็ญ็ฅ๏ผ็ขบไฟ้ ็ฎ้ทๆๅฅๅบท็ผๅฑใ
๐ฏ ๅฏๆ็บๆง้กๆฏ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฑ ๅฏๆ็บๆงไธๅคงๆฏๆฑ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ ๐ฅ ไบบๅกๅฝๆง โ โ ๐ง ๆ่กๅฝๆง โ โ ๐ฆ ๆถๆงๅฝๆง โ โ
โ โ (Bus Factor) โ โ (Tech Agnostic) โ โ (Modularity) โ โ
โ โโโโโโโโโโฌโโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโ โโโโโโโโโโฌโโโโโโโโโ โ
โ โ โ โ โ
โ โข ๅค็ถญ่ญท่
โข LLM ๆฝ่ฑกๅฑค โข ๆไปถ็ณป็ตฑ โ
โ โข ๅฎๅๆๆช โข ๅฏ้ธไพ่ณด โข ๆๅฐๆ ธๅฟ โ
โ โข ่ชๅๅ CI/CD โข ้็ด็ญ็ฅ โข ๆธ
ๆฐ้็ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐จ ้ขจ้ช่ญๅฅ่็ทฉ่งฃ
้ขจ้ช 1: ๅฎไธ็ถญ่ญท่ (Bus Factor = 1)
็ถๅ็ๆ : โ ๏ธ ้ซ้ขจ้ช
ๅฝฑ้ฟ: ๅฆๆไธป่ฆ็ถญ่ญท่ ็กๆณ็นผ็บ๏ผ้ ็ฎๅฏ่ฝๅๆปฏ
็ทฉ่งฃ็ญ็ฅ:
| ็ญ็ฅ | ่กๅ | ็ๆ |
|---|---|---|
| ๆๆชๅฎๆด | ๆๆๆถๆงๆฑบ็ญ้ฝๆๆๆช่จ้ | โ ๅทฒๅฏฆๆฝ |
| ่ชๅๅ | CI/CD ๅ จ่ชๅๅ๏ผๆธๅฐไบบๅทฅๅนฒ้ | โ ๅทฒๅฏฆๆฝ |
| ็ถญ่ญท่ ๆๅ | ๅตๅปบ MAINTAINERS.md๏ผๆ็ขบ่ฒข็ป้ๆขฏ | โ ๅทฒๅฏฆๆฝ |
| ้ ๅๅฐๅฎถ | ๅจ CODEOWNERS ไธญๅฎ็พฉ้ ๅ่ฒ ่ฒฌไบบ | ๐ ้ฒ่กไธญ |
| ๆฑบ็ญ่จ้ | ADR (Architecture Decision Records) | ๐ ้ฒ่กไธญ |
| ็ฅ่ญ่ฝ็งป | ้่ฃฝ้้ต็ณป็ตฑ็่ชชๆ่ฆ้ ป | ๐ ่จๅไธญ |
ๆๅๆๆจ: - [ ] Bus Factor โฅ 2 (่ณๅฐ 2 ไฝๆดป่บ็ถญ่ญท่ ) - [ ] ๆๆๆ ธๅฟๆจก็ตๆๅๆด็ถญ่ญท่ - [ ] 100% ้้ตๅ่ฝๆๆๆช
้ขจ้ช 2: ๅ่ฝ่จ่น (Feature Creep)
็ถๅ็ๆ : โ ๏ธ ไธญ็ญ้ขจ้ช
ๅฝฑ้ฟ: ็ถญ่ญทๆๆฌๅขๅ ๏ผไปฃ็ขผ่ณช้ไธ้
็ทฉ่งฃ็ญ็ฅ:
| ็ญ็ฅ | ่กๅ | ็ๆ |
|---|---|---|
| ๅ่ฝ็ฉ้ฃ | ็ถญ่ญท feature-matrix.md | โ ๅทฒๅฏฆๆฝ |
| ๆจก็ตๅๅฎ่ฃ | extras: [mcp], [vector], [gui] |
โ ๅทฒๅฏฆๆฝ |
| ๆไปถๅชๅ | ๆฐๅ่ฝๅชๅ ไฝ็บๆไปถ | โ ๅทฒๅฏฆๆฝ |
| ๅฎๆๅฏฉๆฅ | ๅญฃๅบฆๅ่ฝๅฏฉๆฅๆ่ญฐ | ๐ ่จๅไธญ |
| ๆฃ็จๆต็จ | ๆ็ขบ็ๅ่ฝ็ๅฝ้ฑๆ | โ ๅทฒๅฏฆๆฝ |
| ่ฆ่็้ๆชป | ๆฐๅ่ฝๅฟ ้ ๆ 80%+ ๆธฌ่ฉฆ่ฆ่ | โ ๅทฒๅฏฆๆฝ |
ๅ่ฝ็ฐกๅๅๅ:
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆฐๅ่ฝๆๆก โ
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโ
โ ๆฏๅฆๅฏไปฅไฝ็บๆไปถๅฏฆ็พ๏ผ โ
โโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโ
ๆฏ โ โ ๅฆ
โโโโโโโโโโโผโโโโ โโโโโผโโโโโโโโโโ
โ ๅตๅปบๆไปถ โ โ ๆฏๅฆๆ ธๅฟๅ่ฝ๏ผโ
โโโโโโโโโโโโโโโ โโโโโฌโโโโโโโโโโ
ๆฏ โ โ ๅฆ
โโโโโโโโโผโโโโ โโผโโโโโโโโโโโโ
โ ๆทปๅ ๅฐๆ ธๅฟ โ โ ๆ็ตๆๅปถๅพ โ
โโโโโโโโโโโโโ โโโโโโโโโโโโโโ
ๆๅๆๆจ: - [ ] ๆ ธๅฟไพ่ณด < 15 ๅ - [ ] ๆฏๅญฃๅบฆๅฏฉๆฅไธฆๆธ ็ โฅ 1 ๅๅฏฆ้ฉๆงๅ่ฝ - [ ] ๆไปถไฝๆฐๅ่ฝๆฏไพ โฅ 50%
้ขจ้ช 3: ๆ่กๆฃงๅผทไพ่ณด (Vendor Lock-in)
็ถๅ็ๆ : โ ๏ธ ไธญ็ญ้ขจ้ช
ๅฝฑ้ฟ: ๅฆๆไพ่ณด็ๆๅ่ฎๆดๆๅๆญข๏ผ้ ็ฎๅๅฝฑ้ฟ
ไธป่ฆไพ่ณด้ขจ้ช:
| ไพ่ณด | ้ขจ้ช็ญ็ด | ็ทฉ่งฃ็ญ็ฅ |
|---|---|---|
google-genai (Gemini) |
๐ก ไธญ็ญ | LLM Provider ๆฝ่ฑกๅฑค |
chromadb |
๐ก ไธญ็ญ | ๅฏๆฟๆๅ้่ณๆๅบซไป้ข |
fastmcp |
๐ข ไฝ | MCP ๆฏ้ๆพๆจๆบ |
sentence-transformers |
๐ข ไฝ | ๅฏๆฟๆ embedding ๆจกๅ |
็ทฉ่งฃ็ญ็ฅ:
| ็ญ็ฅ | ่กๅ | ็ๆ |
|---|---|---|
| LLM ๆฝ่ฑก | src/boring/llm/provider.py ไป้ข |
โ ๅทฒๅฏฆๆฝ |
| ๅค Provider | Gemini, Ollama, OpenAI, Claude | โ ๅทฒๅฏฆๆฝ |
| ้็ดๆฉๅถ | ๅ่ฝๅจไพ่ณดไธๅฏ็จๆๅช้ ้็ด | โ ๅทฒๅฏฆๆฝ |
| ๆฌๅฐๅชๅ | ๆฏๆๅฎๅ จ้ข็ทไฝฟ็จ (Ollama) | โ ๅทฒๅฏฆๆฝ |
| ๅฏ้ธไพ่ณด | ้ๅไพ่ณดๆพๅจ extras ไธญ | โ ๅทฒๅฏฆๆฝ |
ไพ่ณดๆฟๆ็ฉ้ฃ:
โโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโ
โ ็ถๅไพ่ณด โ ๆฟไปฃๆนๆก โ ๅๆ้ฃๅบฆ โ
โโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโค
โ google-genai โ ollama/openai โ ๐ข ็ฐกๅฎ โ
โ chromadb โ qdrant/milvus โ ๐ก ไธญ็ญ โ
โ sentence-trans โ openai embeddingsโ ๐ก ไธญ็ญ โ
โ fastmcp โ ๆๅ MCP ๅฏฆ็พ โ ๐ก ไธญ็ญ โ
โ streamlit โ gradio/flask โ ๐ข ็ฐกๅฎ โ
โ typer โ click/argparse โ ๐ด ๅฐ้ฃ โ
โโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโ
ๆๅๆๆจ: - [x] ๆฏๆ โฅ 3 ๅ LLM Provider - [ ] 100% ๆ ธๅฟๅ่ฝๅฏ้ข็ท้่ก - [ ] ๆฏๅไธป่ฆไพ่ณดๆๆๆชๅ็ๆฟไปฃๆนๆก
๐ ่ชๅๅ็ญ็ฅ
ๆธๅฐไบบๅทฅ็ถญ่ญท่ฒ ๆ
| ่ชๅๅ้ ็ฎ | ๅทฅๅ ท | ็ๆ |
|---|---|---|
| ไปฃ็ขผๆ ผๅผๅ | ruff format |
โ ๅทฒๅฏฆๆฝ |
| Linting | ruff check |
โ ๅทฒๅฏฆๆฝ |
| ้กๅๆชขๆฅ | mypy |
โ ๅทฒๅฏฆๆฝ |
| ๆธฌ่ฉฆๅท่ก | pytest + GitHub Actions |
โ ๅทฒๅฏฆๆฝ |
| ไพ่ณดๆดๆฐ | dependabot |
โ ๅทฒๅฏฆๆฝ |
| ไพ่ณดๅฏฉ่จ | pip-audit |
โ ๅทฒๅฏฆๆฝ |
| ๅฎๅ จๆๆ | bandit |
โ ๅทฒๅฏฆๆฝ |
| ๆๆช็ๆ | mkdocs |
โ ๅทฒๅฏฆๆฝ |
| ็ๆฌ็ผๅธ | GitHub Actions publish.yml |
โ ๅทฒๅฏฆๆฝ |
| Issue ๅ้ก | GitHub Actions (่จๅ) | ๐ ่จๅไธญ |
| PR ่ชๅๅไฝต | dependabot-auto-merge.yml |
โ ๅทฒๅฏฆๆฝ |
่ณช้้ๆชป
# ๆๆ PR ๅฟ
้ ้้
quality_gates:
lint: "ruff check . (0 errors)"
format: "ruff format --check (0 changes)"
types: "mypy src/boring/ (0 errors)"
tests: "pytest (100% pass)"
coverage: ">= 50%"
security: "bandit (no high/medium)"
docs: "interrogate >= 80%"
๐ ๆๆช็ญ็ฅ
้ไฝ่ฒข็ป้ๆชป
| ๆๆช้กๅ | ็ฎๆจ่ฎ่ | ๅชๅ ็ด |
|---|---|---|
| README | ๆฐ็จๆถ | P0 |
| CONTRIBUTING | ๆฐ่ฒข็ป่ | P0 |
| MAINTAINERS | ๆฝๅจ็ถญ่ญท่ | P0 |
| Architecture | ้็ผ่ | P1 |
| API Reference | ๆดๅ้็ผ่ | P1 |
| Tutorials | ๅญธ็ฟ่ | P2 |
| ADR | ๆ ธๅฟๅ้ | P2 |
้่ช็ถญ่ญท
- ๆๆๆ ธๅฟๆๆชๆไพไธญ่ฑๆ็ๆฌ
- ไฝฟ็จ CI ๆชขๆฅ้่ชๅๆญฅ
๐ ๅฎๆๅฏฉๆฅๆธ ๅฎ
ๆๅบฆๅฏฉๆฅ
- [ ] ๆชขๆฅ dependabot PRs
- [ ] ๅฏฉๆฅๆฐ Issues ๅ PRs
- [ ] ๆดๆฐๅ่ฝ็ๆ (ๅฆๆ่ฎๆด)
ๅญฃๅบฆๅฏฉๆฅ
- [ ] ๅ่ฝ็ฉ้ฃๅฏฉๆฅ - ๆจ่จๆฃ็จๅ่ฝ
- [ ] ไพ่ณดๅฎๅ จๅฏฉ่จ
- [ ] ๆๆชๅฎๆดๆงๆชขๆฅ
- [ ] ็ถญ่ญท่ ็ๆ ็ขบ่ช
- [ ] Bus Factor ่ฉไผฐ
ๅนดๅบฆๅฏฉๆฅ
- [ ] ไธป่ฆ็ๆฌ่ฆๅ
- [ ] ๆถๆงๆฑบ็ญๅ้กง
- [ ] ่ฒข็ป่ ๆ่ฌ่่ชๅฏ
- [ ] ๅฏๆ็บๆง็ญ็ฅๆดๆฐ
๐ ็ฅ่ญไฟๅญ
้้ต็ฅ่ญ่ณ็ข
| ็ฅ่ญ้กๅ | ไฝ็ฝฎ | ่ฒ ่ฒฌไบบ |
|---|---|---|
| ๆถๆงๆฑบ็ญ | docs/adr/ |
@Boring206 |
| API ่จญ่จ | docs/api/ |
@Boring206 |
| ้ ็ฝฎ่ชชๆ | docs/reference/configuration.md |
@Boring206 |
| ๆ ้ๆ้ค | docs/reference/troubleshooting.md |
@Boring206 |
| ่ฎๆดๆฅ่ช | CHANGELOG.md |
@Boring206 |
้ฑๆง็ฅ่ญ่ฝๅ
็บ้ฒๆญข็ฅ่ญๆตๅคฑ๏ผไปฅไธ้ฑๆง็ฅ่ญ้่ฆๆๆชๅ๏ผ
- [ ] MCP ๅทฅๅ ท่จญ่จๅๅ
- [ ] RAG ็ดขๅผ็ญ็ฅๆฑบ็ญ
- [ ] Brain Manager ่ณๆ็ตๆงๆผ้ฒ
- [ ] ็ๆฌ็ผๅธๆต็จ็ดฐ็ฏ
- [ ] ๅธธ่ฆ bug ๆจกๅผๅ่งฃๆฑบๆนๆก
๐ ๅฅๅบทๆๆจ
้ ็ฎๅฅๅบทๅ่กจๆฟ
| ๆๆจ | ็ฎๆจ | ็ถๅ | ็ๆ |
|---|---|---|---|
| Bus Factor | โฅ 2 | 1 | ๐ก |
| ๆธฌ่ฉฆ่ฆ่็ | โฅ 60% | 60% | โ |
| ๆๆช่ฆ่็ | โฅ 80% | ~80% | โ |
| ้ๆพ Issues | < 50 | ~20 | โ |
| PR ้ฟๆๆ้ | < 7 ๅคฉ | ~2 ๅคฉ | โ |
| ไพ่ณด้ๆๆธ | 0 | 0 | โ |
| ๅฎๅ จๆผๆด | 0 ้ซ/ไธญ | 0 | โ |
| CI ้้็ | 100% | ~99% | โ |
๐ ๆๆฅ่จๅ
ๅฆๆไธป่ฆ็ถญ่ญท่ ็กๆณ็นผ็บ
- ็ญๆ (1-3 ๅๆ):
- ็คพๅๆๅกๆฅ็ฎก Issue ๅ้ก
- Dependabot ่ชๅ็ถญ่ญทไพ่ณด
-
CI/CD ๆ็บ้่ก
-
ไธญๆ (3-6 ๅๆ):
- ๆๅๆฐ็ถญ่ญท่ (้้ MAINTAINERS.md)
-
็คพๅๆ็ฅจๆฑบๅฎ้ ็ฎๆนๅ
-
้ทๆ:
- ่ๆ ฎๆ่ด็ตฆๅบ้ๆ (ๅฆ Python Software Foundation)
- ๆ Archive ้ ็ฎไธฆๆจ่ฆๆฟไปฃๆนๆก
่ฏ็ตกๆนๅผ
็ทๆฅๆ ๆณ่ซ่ฏ็ตก: - GitHub Issues: ๅ ฌ้่จ่ซ - Email: ่ฆ SECURITY.md
ๆๅพๆดๆฐ: 2026-01-12 | ็ๆฌ: 1.0.0