Skip to content

Commit dc40fb7

Browse files
authored
Merge pull request #8 from be-framework/immanence
用語統一とドキュメント改善: イマナンスとトランセンデンスの概念強化
2 parents fd962ff + 9430614 commit dc40fb7

4 files changed

Lines changed: 39 additions & 7 deletions

File tree

‎manuals/1.0/en/02-input-classes.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,8 @@ Input Classes contain only **Immanent Nature** elements. These are the object's
7171

7272
**Transcendent Forces** (powers that the object cannot achieve by itself) are not included here. They appear in Being Classes, which we'll learn about next.
7373

74+
For example, a `UserInput` class holds only raw data like email address and name. The power to validate whether the email is valid, the power to save to a database, the power to send notifications—these are all transcendent forces and do not exist in Input Classes. Input Classes simply declare "this is the data I am."
75+
7476
Input Classes represent the starting point of transformation—the object's initial form.
7577

7678
---

‎manuals/1.0/en/03-being-classes.md‎

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,11 @@ permalink: /manuals/1.0/en/03-being-classes.html
1515

1616
Being Classes are where transformation actually occurs.
1717

18-
The object's own nature (**Immanent Nature**) meets forces provided from the outside (**Transcendent Forces**), and a new being is born. If Input Classes are the "beginning," Being Classes express the "moment of change."
18+
The object's own nature (**Immanent Nature**) meets forces provided from the outside (**Transcendent Forces**), and a new being is born.
19+
20+
For example, a `UserInput` with email and name (immanence) meets an email validation service and formatter (transcendence), creating a "validated user profile" as a new being. The original data remains immutable; by meeting validation—a transcendent force the object doesn't possess—a new being emerges.
21+
22+
If Input Classes are the "beginning," Being Classes express the "moment of change."
1923

2024
## Basic Structure
2125

@@ -43,10 +47,16 @@ Every Being Class follows the same flow of transformation:
4347

4448
**Immanent Nature** (`#[Input]`) + **Transcendent Forces** (`#[Inject]`) → **New Immanent Nature**
4549

50+
It's like cooking. Ingredients (immanent nature) combined with fire and seasoning (transcendent forces) create a dish (new immanent nature). Flour alone isn't bread; with yeast and an oven's power, it becomes bread. The ingredients persist, yet their form becomes something new.
51+
4652
- **Immanent factors**: What the object inherits from its previous form
4753
- **Transcendent factors**: External capabilities and context provided by the world
4854
- **New Immanent**: The transformed being that emerges from this interaction
4955

56+
This pattern appears everywhere in nature. A seed (immanent) meets soil, water, and sunlight (transcendent) to become a flower. A student (immanent) meets teachers and materials (transcendent) to become an expert. All growth, all learning, all change follows this pattern. The Be Framework expresses this universal law of transformation in code.
57+
58+
The programming world is the same. `$cartItems` (immanent) meets tax calculation services (transcendent) to become billing amounts. `$zipCode` (immanent) meets address lookup APIs (transcendent) to become complete addresses. `$rawImage` (immanent) meets image processing engines (transcendent) to become thumbnails. Data cannot change by itself. Only by borrowing external forces can it become something new.
59+
5060
## Entelecheia - Becoming Who You're Meant to Be
5161

5262
The constructor is where a new self is born. To become the intended self, **Immanent Nature** meets **Transcendent Forces** that the self doesn't possess, and transformation logic unfolds.
@@ -75,7 +85,11 @@ final readonly class OrderCalculation
7585
2. They interact, and the transformation logic unfolds.
7686
3. Through property assignment, a new being is born.
7787

78-
Entelecheia is a philosophical concept proposed by Aristotle, representing the process by which potentiality transitions to actuality. It's the moment when an object's possibilities are realized through interaction with external forces. In the Be Framework, this transformation process in the constructor is considered the realization of entelecheia.
88+
Entelecheia (ἐντελέχεια) is a philosophical concept proposed by Aristotle, meaning "having purpose within." An acorn is born to become an oak tree, an egg exists to become a bird. Each harbors its "intended self" within. The egg as potentiality becomes the bird as actuality. In other words, the egg exists for the entelecheia of becoming a bird.
89+
90+
The Be Framework is the same. This constructor transformation process is precisely the realization of entelecheia. `OrderCalculation` wants to become a calculated order. `ValidatedUser` wants to become a verified user. Each class becomes its "intended self" through the constructor. The Be Framework focuses not on actions (DOING) but on being (BEING). Actions are not the purpose—they are the means to become the intended being.
91+
92+
Life is the same. Reading books is to become "a person with deep insight," practicing instruments is to become "a person who moves hearts through music." Actions are means; being is the purpose. Focusing not on "what to do" but "what to become"—the Be Framework expresses this way of thinking in code.
7993

8094
## Bridging to Final Objects
8195

@@ -108,7 +122,7 @@ final readonly class OrderValidation
108122

109123
## Natural Flow
110124

111-
Being Classes don't "do" things—they naturally become what they're meant to be through the interaction of their **Immanent Nature** with **Transcendent Forces** provided by the world. This is the principle of wu wei (無為) from Taoist philosophy. They don't change other things; they transform themselves.
125+
Being Classes don't "do" things. What they possess (immanence) meets forces given from outside (transcendence), naturally transforming into what they should be. This is the same as Laozi's teaching at the beginning: "The Tao does nothing, yet nothing is left undone"—without forcing, everything is accomplished in the natural flow. They don't change other things; they transform themselves.
112126

113127
---
114128

‎manuals/1.0/ja/02-input-classes.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -69,6 +69,8 @@ final readonly class PaymentInput
6969

7070
入力クラスでは、すべてが**イマナンス**です。ここには**トランセンデンス(Transcendence/超越的な力)**はありません。トランセンデンスは外部から提供される、自分だけでは実現不可能な力であり、それらは後で**存在クラス(Being クラス)**において現れます。
7171

72+
例えば、`UserInput`クラスはメールアドレスと名前という素のデータだけを持ちます。このメールアドレスが有効かどうかを検証する力、データベースに保存する力、通知を送る力——これらはすべてトランセンデンスであり、入力クラスには存在しません。入力クラスはただ「私はこういうデータです」と宣言するだけです。
73+
7274
入力クラスは変容の出発点です。自己を超えたものと出会って、新しい何かへと変わっていく最初の姿を表します。
7375

7476
---

‎manuals/1.0/ja/03-being-classes.md‎

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,11 @@ permalink: /manuals/1.0/ja/03-being-classes.html
1515

1616
存在クラスは変容が実際に起こる場所です。
1717

18-
オブジェクト自身が持つ性質(**内在的性質(イマナンス)**)と、外部から提供される力(**超越的な力(トランセンデンス)**)が出会い、次の新しい存在が生まれます。入力クラスが「始まり」なら、存在クラスは「変わる瞬間」を表現します。
18+
オブジェクト自身が持つ性質(**内在的性質(イマナンス)**)と、外部から提供される力(**超越的な力(トランセンデンス)**)が出会い、次の新しい存在が生まれます。
19+
20+
例えば、`UserInput`が持つメールアドレスと名前(イマナンス)が、メール検証サービスやフォーマッター(トランセンデンス)と出会うことで、「検証済みのユーザープロフィール」という新しい存在が生まれます。元のデータは不変のまま、検証という自分にはない超越的な力との出会いを通じて、新しい存在が立ち上がります。
21+
22+
入力クラスが「始まり」なら、存在クラスは「変わる瞬間」を表現します。
1923

2024
## 基本構造
2125

@@ -43,10 +47,16 @@ final readonly class UserProfile
4347

4448
**内在的性質** (`#[Input]`) + **超越的力** (`#[Inject]`) → **新しい内在的性質**
4549

50+
まるで料理のようです。素材(内在的性質)に、火や調味料(超越的力)を加えることで、料理(新しい内在的性質)が生まれます。小麦粉はそれだけではパンになりませんが、イーストとオーブンの力を借りてパンになります。素材は同じでも、まったく新しい存在になるのです。
51+
4652
- **内在的要因**: オブジェクトが前の形態から継承するもの
4753
- **超越的要因**: 世界によって提供される外部の能力と文脈
4854
- **新しい内在的**: この相互作用から生まれる変容した存在
4955

56+
このパターンは自然界のあらゆるところに見られます。種(内在)が土と水と太陽(超越)と出会って花になる。生徒(内在)が教師と教材(超越)と出会って専門家になる。すべての成長、すべての学び、すべての変化がこのパターンに従います。Be Frameworkは、この普遍的な変容の法則をコードで表現しているのです。
57+
58+
プログラムの世界でも同じです。`$cartItems`(内在)が税率計算サービス(超越)と出会って請求金額になる。`$zipCode`(内在)が住所検索API(超越)と出会って完全な住所になる。`$rawImage`(内在)が画像処理エンジン(超越)と出会ってサムネイルになる。データは自分だけでは変われません。外部の力を借りて、初めて新しい存在になれるのです。
59+
5060
## エンテレケイア - なりたい自分になる
5161

5262
コンストラクタは新しい自己が生まれる特別な場所です。なるべき自己になるために、内在的性質と、自らは持たないが世界から与えられる超越的な力が出会い、変容のロジックが働きます。
@@ -75,11 +85,15 @@ final readonly class OrderCalculation
7585
2. 相互に作用して変容のロジックが働く。
7686
3. プロパティの代入によって新しい存在が誕生する。
7787

78-
エンテレケイア(entelecheia)とは、アリストテレスが提唱した哲学概念で、潜在性が現実性へと移行する過程を表します。オブジェクトが持つ可能性が、外部の力との相互作用によって実現される瞬間です。Be Frameworkでは、このコンストラクタでの変容過程がまさにエンテレケイアの実現と考えています。
88+
エンテレケイア(entelecheia)とは、アリストテレスが提唱した哲学概念で、「内に目的を持つ」という意味です。どんぐりは樫の木になるべく生まれ、卵は鳥になるべく存在します。それぞれが「なりたい自分」を内に秘めているのです。
89+
90+
Be Frameworkでは、このコンストラクタでの変容過程がまさにエンテレケイアの実現です。`OrderCalculation`は計算された注文になりたい。`ValidatedUser`は検証済みユーザーになりたい。各クラスがコンストラクタで「なりたい自分」になるのです。Be Frameworkでは、動作(DOING)ではなく、存在(BEING)を中心に考えます。
91+
92+
人生でも同じです。本を読むのは「深い洞察を持つ人」になるため、楽器を練習するのは「音楽で人の心を動かす人」になるためです。動作は手段であり、存在こそが目的なのです。「何をするか」ではなく「何になりたいか」に焦点を合わせる—この考え方を、Be Frameworkはコードで表現しているのです。
7993

8094
## 最終オブジェクトへの橋渡し
8195

82-
存在クラスはしばしば橋として機能し、最終変容のためのデータを準備します:
96+
存在クラスはしばしば架け橋として機能し、最終変容のためのデータを準備します:
8397

8498
```php
8599
#[Be([SuccessfulOrder::class, FailedOrder::class])] // 複数の運命
@@ -108,7 +122,7 @@ final readonly class OrderValidation
108122

109123
## 自然な流れ
110124

111-
存在クラスは何かを「する」のではありません。自身の内在的性質と、世界から与えられる(自らは持たない)超越的力との相互作用を通して、自然にあるべき姿へと変容します。これは道教でいう無為自然の原理です。他の何かを変えるのではなく、自分自身が変わっていきます。
125+
存在クラスは何かを「する」のではありません。自分が持つもの(イマナンス)と、外部から与えられる力(トランセンデンス)が出会うことで、自然にあるべき姿へと変容します。これは冒頭の老子の「道常無為而無不為」—無理に力を加えることなく、自然な流れの中ですべてが成し遂げられる—という教えと同じです。他の何かを変えるのではなく、自分自身が変わっていきます。
112126

113127
---
114128

0 commit comments

Comments
 (0)