Initial Dever 0.0.1

2026-11-03 03:32:07 +00:00
commit 81233d098c
@@ -0,0 +1,11 @@
+# greeting
+
+本领域的职责与行为见主题说明；函数签名和调用关系从源码读取。
+
+## 说明
+
+- [应用命令样例](doc/api.md)
+- [应用命令样例](doc/app.md)
+- [应用命令样例](doc/domain.md)
+
+[调用流程](link.md)由 `dever inspect . --links` 生成。
@@ -0,0 +1,17 @@
+cmd greet = app.greet
+
+cmd double = app.double
+
+cmd echo = app.echo
+
+cmd many = app.many
+
+cmd divide = app.divide
+
+cmd pair = app.pair
+
+cmd empty = app.empty
+
+cmd positive = app.positive
+
+cmd maybe = app.maybe
@@ -0,0 +1,29 @@
+type Profile {
+  id: Id
+  name: Text
+  scores: List<Int>
+  ratio: Float?
+}
+
+type Problem { error Rejected(message: Text) }
+
+greet(name: Text) (message: Text) {
+  message = utility.decorate(domain.greet(name))
+}
+
+double(value: Int) (answer: Int) { answer = domain.double(value) }
+
+echo(value: Profile) (answer: Profile) { answer = value }
+
+many(rows: List<Profile>) (answer: List<Profile>) { answer = rows }
+
+divide(value: Float, divisor: Float) (answer: Float) { answer = value / divisor }
+
+pair(value: Int) (first: Int, second: Int) { first = value
+ second = value + 1 }
+
+empty() () {}
+
+positive(value: Int) (answer: Int) { answer = domain.positive(value) }
+
+maybe(value: Int?) (answer: Int?) { answer = value }
@@ -0,0 +1,39 @@
+# 应用命令样例
+
+验证应用调用边界与类型化命令执行。
+
+### greet
+
+将命令绑定到本领域能力。
+
+### double
+
+将命令绑定到本领域能力。
+
+### echo
+
+将命令绑定到本领域能力。
+
+### many
+
+将命令绑定到本领域能力。
+
+### divide
+
+将命令绑定到本领域能力。
+
+### pair
+
+将命令绑定到本领域能力。
+
+### empty
+
+将命令绑定到本领域能力。
+
+### positive
+
+将命令绑定到本领域能力。
+
+### maybe
+
+验证可空标量从命令解码结果借用后仍按值返回。
@@ -0,0 +1,101 @@
+# 应用命令样例
+
+验证应用调用边界与类型化命令执行。
+
+## demo.greeting.Profile
+
+定义命令传输的业务数据。
+
+字段：
+- `id`：输入或输出的业务值
+- `name`：输入或输出的业务值
+- `scores`：输入或输出的业务值
+- `ratio`：输入或输出的业务值
+
+## demo.greeting.Problem
+
+定义命令传输的业务数据。
+
+分支：
+- `error Rejected(message: Text)`：输入或输出的业务值
+
+## demo.greeting.greet
+
+完成命令对应的业务处理。
+
+输入：
+- `name`：输入或输出的业务值
+输出：
+- `message`：输入或输出的业务值
+
+## demo.greeting.double
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.echo
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.many
+
+完成命令对应的业务处理。
+
+输入：
+- `rows`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.divide
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+- `divisor`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.pair
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `first`：输入或输出的业务值
+- `second`：输入或输出的业务值
+
+## demo.greeting.empty
+
+完成命令对应的业务处理。
+
+输入：无
+输出：无
+
+## demo.greeting.positive
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.maybe
+
+保持可空整数的完整值，不给空输入填入默认值。
+
+输入：
+- `value`：可空整数
+输出：
+- `answer`：原始值
@@ -0,0 +1,30 @@
+# 应用命令样例
+
+验证应用调用边界与类型化命令执行。
+
+## demo.greeting.domain.greet
+
+完成命令对应的业务处理。
+
+输入：
+- `name`：输入或输出的业务值
+输出：
+- `message`：输入或输出的业务值
+
+## demo.greeting.domain.double
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
+
+## demo.greeting.domain.positive
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
@@ -0,0 +1,6 @@
+greet(name: Text) (message: Text) { message = "Hello, " + name }
+
+double(value: Int) (answer: Int) { answer = value * 2 }
+
+positive(value: Int < 0) (answer: Int) { fail(app.Problem.Rejected("negative")) }
+positive(value: other) (answer: Int) { answer = value }
@@ -0,0 +1,9 @@
+# utility
+
+本领域的职责与行为见主题说明；函数签名和调用关系从源码读取。
+
+## 说明
+
+- [应用命令样例](doc/app.md)
+
+[调用流程](link.md)由 `dever inspect . --links` 生成。
@@ -0,0 +1 @@
+decorate(value: Text) (answer: Text) { answer = "[" + value + "]" }
@@ -0,0 +1,12 @@
+# 应用命令样例
+
+验证应用调用边界与类型化命令执行。
+
+## demo.utility.decorate
+
+完成命令对应的业务处理。
+
+输入：
+- `value`：输入或输出的业务值
+输出：
+- `answer`：输入或输出的业务值
				`@@ -0,0 +1 @@`
				`decorate(value: Text) (answer: Text) { answer = "[" + value + "]" }`