Skip to content
BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

32 Commits
backend
backend
 
 
docs
docs
 
 
frontend
frontend
 
 
.env.example
.env.example
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CLAUDE.md
CLAUDE.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
docker-compose.yml
docker-compose.yml
 
 

Repository files navigation

harosystem

セルフホスト型のカレンダー Web アプリケーション。サイバーパンク風ネオンテーマの UI で、Google Calendar の代替として Docker 一発で立ち上げられます。

ライト / ダーク / システム依存の外観モードと、モードごとに選べる 6 種のテーマ (NEØN / SYNTHWAVE / MATRIX / PAPER / SAKURA / MINT) を搭載。

✨ 機能

カレンダー

  • 日 / 週 / 月表示 の切り替え（矢印キー・ホイール操作対応）
  • イベントのドラッグ移動・リサイズ（15 分スナップ）
  • 空きスロットクリック / セルのダブルクリックで即座に作成
  • 現在時刻インジケーター・終日イベント対応

イベント & タスク

  • イベント: 日時指定のカレンダーエントリ（終日対応・繰り返し(RRULE)対応：毎日/平日/毎週(曜日)/毎月 + 終了条件）
  • タスク: 開始時刻・終了時刻を持つ TODO アイテム（予定と同じ時間モデル。時刻未設定ならバックログのプールに入る）
  • Markdown サポート: 本文に Markdown を使用可能。タスク内のチェックボックスはサイドバーにサブタスクとして表示・操作可能（▸/▾ で折りたたみ/展開）
  • ラベル (プロジェクト): 色・デフォルト通知設定付きのカテゴリ分類
  • 個別カラー: イベント / タスクごとに 22 色のパレットから色をオーバーライド可能
  • ノート (Markdown): プロジェクト（ラベル）に紐づく Markdown ノートを /notes で管理。1 つのノートに複数タスクを紐付けでき（Note 1:N Task）、調査メモや継続作業を横断的に集約できる
  • アジャイルボード (Jira 風): ラベル（プロジェクト）単位のスプリントでタスクを計画・進行管理
    • ラベル分離: /board・/backlog のラベルセレクタでプロジェクトを切替。スプリントは選択ラベルに紐づき、アクティブはラベルごとに 1 つ
    • バックログ /backlog: 選択ラベルのスプリントと Backlog プールの縦リスト。D&D でスプリントへ割り当てて計画。スプリントの作成・開始・完了・削除
    • アクティブボード /board: 進行中スプリントのタスクを Todo / In Progress / Done の 3 列で管理。D&D でステータス変更（done と相互同期）
    • 操作: 列の空白ダブルクリック / 「＋タスク追加」で作成フォーム、カードクリックで詳細パネル（タイトル/本文ダブルクリックで編集）
    • 時間未定で作成したタスクは自動的に Backlog プールへ

テーマ

  • ライト / ダーク / システム依存の外観モード
  • ダークテーマ: NEØN / SYNTHWAVE / MATRIX
  • ライトテーマ: PAPER / SAKURA / MINT

外部カレンダー連携

  • ICS フィード購読: 外部カレンダー（Google Calendar 祝日など）を購読
  • webcal:// URL の自動変換、定期同期（デフォルト 5 分間隔）
  • フィードごとの表示 / 非表示切り替え

通知

  • ブラウザ通知: イベント / タスクの開始前 N 分にデスクトップ通知
  • Webhook 連携: Discord / Slack / カスタム URL への通知（テスト送信機能付き）

データ管理

  • ICS インポート / エクスポート: 標準 iCalendar 形式でバックアップ・移行

🏗️ アーキテクチャ

┌─────────────────┐      ┌──────────────────────┐      ┌──────────────┐
│   Browser        │      │   Nginx              │      │  PostgreSQL  │
│   Angular 18     │─────▶│   :443 (HTTPS/TLS)   │      │  16-alpine   │
│                  │      │   :80 → 301 → :443   │      │              │
│                  │      │   /api → :8000       │──┐   │              │
└─────────────────┘      └──────────────────────┘  │   └──────────────┘
                                                    │          ▲
                                                    ▼          │
                                              ┌─────────────────┐
                                              │  FastAPI (:8000) │
                                              │  + Background    │
                                              │    - Feed sync   │
                                              │    - Notify loop │
                                              └─────────────────┘
レイヤー 技術
Frontend Angular 18 (Standalone Components, Signals), Tailwind CSS 3, Angular Material
Backend FastAPI, SQLAlchemy 2.0, Pydantic v2, Python 3.12
Database PostgreSQL 16
Infra Docker Compose, Nginx (HTTPS / 自己署名証明書)

🚀 セットアップ

前提条件

  • Docker & Docker Compose

起動

git clone <repository-url>
cd harosystem

# 1. 環境変数ファイルを作成し、認証情報を設定する
cp .env.example .env
# .env を編集して POSTGRES_PASSWORD を強力なものに変更

# 2. ビルドして起動
docker compose up --build -d

ブラウザで https://localhost:4443 にアクセス（自己署名証明書のため警告が出ます）。 http://localhost:4200 は HTTPS へ自動リダイレクトされます。

停止 / リセット

docker compose down       # 停止
docker compose down -v    # データ (pgdata ボリューム) も削除して完全リセット

🔒 セキュリティに関する注意事項

このアプリは 個人のローカル環境 / 信頼できる LAN 内での利用 を想定しています。インターネットへ公開する場合は以下を必ず確認してください。

  • 認証機能 (JWT) が組み込まれており、デフォルトで全てのデータが保護されています。
  • 起動時に初期ユーザー（ユーザー名: admin / パスワード: admin）が自動で作成されます。運用前に必ずDBからパスワードを変更するか、不正アクセスされないよう注意してください。
  • .env を必ず作成し、強力な DB パスワードと JWT_SECRET_KEY を設定してください。 デフォルト値はソースコードに含まれていません（未設定の場合は起動に失敗します）。
  • .env や証明書ファイルをコミットしないでください（.gitignore 済み）。
  • 同梱の TLS 証明書は 自己署名 です。公開時は Let's Encrypt 等の正規証明書に差し替えてください。
  • Webhook URL（Discord / Slack）はシークレットを含みます。DB バックアップの取り扱いに注意してください。

📡 API リファレンス

ベース URL: https://localhost:4443/api ※ GET /api/health 以外へのアクセスには、すべて Authorization: Bearer <token> ヘッダーによる JWT 認証が必要です。

GET /api/health → {"status": "ok"}
リソース パス メソッド
認証 /api/auth/login, /api/auth/me POST, GET
ラベル /api/labels, /api/labels/{id} GET, POST, PUT, DELETE
イベント /api/events, /api/events/{id} GET, POST, PUT, DELETE
タスク /api/tasks, /api/tasks/{id} GET, POST, PUT, DELETE
ノート /api/notes, /api/notes/{id} GET, POST, PUT, DELETE
フィード /api/feeds, /api/feeds/{id}, /api/feeds/{id}/sync GET, POST, PUT, DELETE
フィードイベント /api/feeds/events GET
Webhook /api/webhooks, /api/webhooks/{id}, /api/webhooks/{id}/test GET, POST, PUT, DELETE
ICS /api/ics/export, /api/ics/import GET, POST (multipart)

イベント / タスクの一覧は start, end, label_id クエリでフィルタできます。

イベント作成リクエスト例 
{
  "title": "キックオフMTG",
  "content": "# アジェンダ\n- 進捗確認\n- 次のマイルストーン",
  "content_type": "md",
  "start_at": "2026-06-11T10:00:00+09:00",
  "end_at": "2026-06-11T11:30:00+09:00",
  "label_id": 1,
  "color": "#a78bfa"
}

🗄️ データモデル

erDiagram
    User ||--o{ Label : "has many"
    User ||--o{ Event : "has many"
    User ||--o{ Task : "has many"
    User ||--o{ Note : "has many"
    User ||--o{ Sprint : "has many"
    User ||--o{ Feed : "has many"
    User ||--o{ Webhook : "has many"
    Label ||--o{ Event : "has many"
    Label ||--o{ Task : "has many"
    Label ||--o{ Note : "has many"
    Label ||--o{ Sprint : "has many"
    Note ||--o{ Task : "has many"
    Sprint ||--o{ Task : "has many"
    Feed ||--o{ FeedEvent : "has many"

    User {
        int id PK
        string username UK
        string hashed_password
    }
    Label {
        int id PK
        string name UK
        string color
        bool notify_default
        int notify_before_min_default
    }
    Event {
        int id PK
        string title
        text content
        string content_type
        datetime start_at
        datetime end_at
        bool all_day
        string color
        bool notify_enabled
        int notify_before_min
        datetime notified_at
        int label_id FK
        string recurrence
    }
    Task {
        int id PK
        string title
        text content
        string content_type
        datetime start_at
        datetime end_at
        bool done
        string status
        string color
        bool notify_enabled
        int notify_before_min
        datetime notified_at
        int label_id FK
        int note_id FK
        int sprint_id FK
    }
    Feed {
        int id PK
        string name
        string url
        string color
        bool enabled
        datetime last_synced_at
        string last_error
    }
    FeedEvent {
        int id PK
        int feed_id FK
        string uid
        string title
        text content
        datetime start_at
        datetime end_at
        bool all_day
    }
    Webhook {
        int id PK
        string name
        string kind
        string url
        bool enabled
    }
Loading

⚙️ 設定

環境変数 (.env)

変数 説明
POSTGRES_USER PostgreSQL ユーザー名
POSTGRES_PASSWORD PostgreSQL パスワード（必ず変更すること）
POSTGRES_DB データベース名
JWT_SECRET_KEY JWTの署名に使用する秘密鍵（必ず推測不可能な長いランダム文字列に変更すること）
CORS_ORIGINS （任意）API の CORS 許可オリジン（カンマ区切り）。未設定なら localhost:4200 のみ
CERT_HOSTS （任意）自己署名証明書の SAN に追加するホスト名/IP（カンマ区切り）。localhost/127.0.0.1 は常に含む

バックエンドの DATABASE_URL は docker-compose.yml が上記から自動構築します。 DB認証情報と JWT_SECRET_KEY は未設定の場合、起動時にエラーで停止します（フェイルファスト）。

外部アクセス（このマシン以外から開く）

既定では localhost 向けです。LAN の別端末やドメインからアクセスするには .env に設定します：

# 例: LAN IP 192.168.1.10 とホスト名でアクセスする場合
CERT_HOSTS=192.168.1.10,calendar.local
# 別オリジンの SPA から API を叩くなら (任意)
CORS_ORIGINS=http://localhost:4200,https://calendar.example.com

証明書は起動時に生成されるため、CERT_HOSTS 変更後は frontend を作り直します： docker compose up -d --build --force-recreate frontend （自己署名のため、ブラウザの「安全でない」警告自体は残ります。本番は正式な証明書を推奨）。

フロントエンド設定（ブラウザ内、Settings ページ）

項目 デフォルト 説明
外観モード システム ライト / ダーク / システム依存
テーマ NEØN (ダーク) / PAPER (ライト) モードごとに選択可能
表示開始 / 終了時間 7:00 / 22:00 タイムグリッドの表示範囲
スロット高さ 60px 1 時間あたりのピクセル高さ
週の開始曜日 日曜日 月曜始まりに変更可能
通知 有効 ブラウザ通知の ON/OFF とデフォルトタイミング
自動更新間隔 — 外部カレンダー変更の定期再取得

🔧 開発

# フロントエンドテスト
cd frontend && npx jest

# バックエンド構文チェック
cd backend && python -m py_compile app/main.py app/models.py app/schemas.py

# ログ確認
docker compose logs -f

ネットワーク設定

Docker ネットワークの MTU は 1400 に設定されています（docker-compose.yml）。 ホストのアップリンクが MTU 1400（USB テザリング等）の場合に TLS ハンドシェイクのパケットロスを防ぐためです。通常の環境では削除しても問題ありません。

📄 ライセンス

MIT License

About

No description, website, or topics provided.

Resources

Readme
MIT license
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages