1. はじめに

Livlog Engineering Handbook は、リブログ合同会社がどのような考え方でサービスを作り、どのような技術を使い、どのように運用しているかをまとめた技術文書です。

リブログ合同会社では、地域、日常、記録、記憶、生活の中にある情報を、Webサービスやアプリケーションを通じて再利用できる形にすることを大切にしています。

私たちの開発テーマは、単に便利なシステムを作ることではありません。

埋もれている情報を見つけること。日々の記録に意味を与えること。地域や場所に残された物語を、次の誰かが見つけられる形にすること。

そのために、オープンデータ、地図、写真、AI、Web技術を組み合わせ、小さく作り、公開し、改善しながら育てる開発を行っています。

リブログの開発テーマ

リブログのサービスには、いくつかの共通したテーマがあります。

写真、地名、施設、道、駅、木材、日々の感情など、単体では単なる情報に見えるものでも、整理し、つなげ、検索できる形にすると、新しい意味が生まれます。

リブログでは、こうした情報をWeb上に再構成し、誰かの発見や行動につながる形にすることを目指しています。

有名な観光地だけではなく、生活の中にある道、駅、水路、地名、公共施設、自然景観にも価値があります。

リブログでは、地域に眠る情報をデータ化し、地図や検索機能を通じて見つけやすくすることで、日常の風景をアーカイブしています。

リブログの開発では、最初から大規模なシステムを作るのではなく、まず動く形にして公開し、その後に改善していくことを重視しています。

完璧な設計よりも、実際に使える状態にすること。大きな計画よりも、小さな公開を積み重ねること。机上の仕様よりも、実際の利用を通じて改善すること。

この考え方を、リブログの開発の基本姿勢としています。

このHandbookには、以下の目的があります。

この文書は、完成された技術書ではありません。リブログのサービスと同じように、必要に応じて更新し、育てていく文書です。

このHandbookは、次のような人に向けて書いています。

記録を意味に、人生をストーリーに。

英語では、次のように表現しています。

Turn records into meaning. Turn life into a story.

リブログの技術は、この言葉を実現するための手段です。

開発へ初めて入る場合は、初回の開発を始めるから読み始めます。既存プロダクトへの参加と新規プロダクトの立ち上げを分け、最初のIssueへ着手するために必要な情報と依頼方法を確認できます。

本Handbookは、以下の4部と付録で構成しています。

第一部：リブログの開発 — プロダクト、技術とアーキテクチャ、開発思想、開発・運用・保守・ドキュメントの方針を説明します。
第二部：技術領域 — アプリケーション、システム、インフラ、データ、開発ツールを領域別に整理します。
第三部：Handbookの運用と今後 — 今後の拡充方針と、Handbookを更新・公開するためのルールを説明します。
第四部：AIネイティブ開発 — 初期開発を含むすべての変更をIssueから始め、Goal First、調査、要件整理、設計、実装、テスト、レビュー、全体ドキュメントへの同期まで進めるAIネイティブ開発手順を説明します。変更の規模とリスクに応じて工程と文書を選び、小さな変更では必要な観点をIssue本文や一つの依頼へ統合します。
付録 — 用語集と、技術スタック調査・SQL解析と設計書作成に使う実務プロンプトを収録します。

最初から読む場合は、第1章から順に読むと、プロダクト、開発方針、技術詳細、文書運用の順で全体像を把握できます。

目的が決まっている場合は、次の入口から読み始めます。

各プロダクトの詳細設計や運用知識は、ロードマップに沿って追加し、この全体構成からたどれるようにします。

Livlog Engineering Handbook は、リブログが作ってきたもの、考えてきたこと、これから作っていくものを記録するための技術的な土台です。

最終更新 4 日前