> For the complete documentation index, see [llms.txt](https://livlog-llc.gitbook.io/engineering-handbook/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://livlog-llc.gitbook.io/engineering-handbook/riburoguno/2-products/chroco-technology-stack.md).

# CHROCO 技術構成

CHROCOは、ブックマークを並べることで、ブログ記事、旅行記、作品制作の過程などをタイムラインとして整理できるWebサービスです。

このページでは、外部公開しても差し支えない範囲で、CHROCOの技術構成を概要として整理します。詳細な依存関係、設定値、内部接続情報、調査ログは掲載しません。

## 位置づけ

CHROCOは、リブログの「記録を時系列に整理する」領域のプロダクトです。

ブログ、旅の記録、制作過程、外部ページなどを、単なるリンク集ではなく、時間の流れを持ったストーリーとして整理することを目的にしています。

## 技術構成の概要

| 項目       | 内容                                            |
| -------- | --------------------------------------------- |
| アプリケーション | タイムライン作成・公開、プロフィール、RSS、埋め込み表示を提供するWebアプリケーション |
| バックエンド   | Javaを中心としたサーバーサイドWebアプリケーション                  |
| Web UI   | サーバーサイドテンプレート、HTML、CSS、JavaScriptを組み合わせた構成    |
| データ      | タイムライン、ブックマーク、プロフィール、公開設定などをRDBで管理            |
| 外部連携     | SSO、画像保存、URLメタデータ取得、AIによる補助、メール通知など           |
| 運用       | Webアプリケーションとして継続運用しやすい構成を重視                   |

## 構成の特徴

CHROCOでは、ユーザーが登録したURLや記録を、タイムラインとして読みやすく表示することが重要です。

そのため、以下を重視します。

* URLや外部ページの情報を扱いやすくする
* タイムライン表示をシンプルに保つ
* 公開ページとして読みやすいHTMLを生成する
* 画像やプロフィール情報を安全に扱う
* RSSや埋め込み表示など、外部から参照しやすい形式を用意する

## 開発・運用上のポイント

CHROCOは、画面の使いやすさとデータ構造の安定性が重要です。

初期段階では、登録・並び替え・公開表示といった基本機能を優先し、利用しながら改善します。URL解析やAI補助のように不確実性がある処理は、失敗時の扱いや手動修正を前提に設計します。

## 技術スタック調査の扱い

CHROCOの技術スタックを調査する場合は、以下を確認します。

* Webアプリケーションの実行単位
* サーバーサイドテンプレート
* データベースと永続化方式
* 外部ページ解析や画像保存の仕組み
* 認証・ユーザー管理
* RSSや埋め込み表示
* デプロイ方法
* 運用ログとエラー確認方法

詳細な依存関係や内部設定は、公開Handbookではなく内部調査資料として管理します。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://livlog-llc.gitbook.io/engineering-handbook/riburoguno/2-products/chroco-technology-stack.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.