TelosDB / docs /
@楽曲作りまくりおじさん 楽曲作りまくりおじさん authored 2 days ago
..
specification Release v0.3.2: Community/Pro 2エディション、Pro 埋め込みモデル同梱、リソース解決修正、リリースノート・仕様書整理 2 days ago
README.md Release v0.3.2: Community/Pro 2エディション、Pro 埋め込みモデル同梱、リソース解決修正、リリースノート・仕様書整理 2 days ago
README.md

docs — プロジェクトドキュメント

TelosDB の仕様・設計・参照資料を格納するディレクトリです。

構成

ディレクトリ 内容
specification/ システム仕様・設計。アーキテクチャ、DB、MCP API、UI、開発ガイド、埋め込み・エディション、モノリシック化、KPI・検証、UI テスト、OpenAPI / MCP スキーマ。
issues/ Issue 同期用の Markdown(Git 追跡外。node tools/scripts/sync_issues.mjs で同期)。
references/ 調査メモ・外部資料の参照。ベクトル化手法、BM25、Elasticsearch 等。

主なファイル(specification/)

01〜06: 製品仕様の本体(概要・アーキテクチャ・DB・MCP・開発・UI)。07〜12: 補足(埋め込み技術・ゴール/KPI・検証手順・モノリシック経緯・Pro 動作確認・UI テスト方針)。

  • 01_system_overview.md — システム概要・エディション・主要機能
  • 02_architecture_design.md — アーキテクチャ設計
  • 03_database_specification.md — データベース仕様
  • 04_mcp_api_specification.md — MCP API 仕様
  • 05_development_guide.md — 開発ガイド(ビルド・拡張)
  • 06_ui_design_spec.md — UI デザイン仕様
  • 07_embedding_tract.md — 埋め込みモデル(ONNX + tract)の組み込み
  • 08_embedding_tract_goals_and_kpi.md — 埋め込み改修:ゴールとテスト KPI
  • 09_embedding_tract_implementation_and_tests.md — KPI 達成のための改修・テスト
  • 10_monolithic_dev.md — モノリシック化(開発時アーキテクチャ)
  • 11_pro_vectorization_and_ann.md — Pro ベクトル化・ANN 動作確認
  • 12_ui_testing_options.md — UI をテストに組み込む方法(E2E / Playwright 等)
  • mcp.json, openapi.yaml — MCP / API スキーマ

運用ルール(Issue 管理・Git 運用など)は .agent/rules/ にあります。