Update the docs

Author: m0ver

README.md

@@ -4,8 +4,7 @@
 
 Welcome to the tinystruct framework documentation. This documentation provides comprehensive guidance for using and developing with the tinystruct framework.
 
-欢迎查阅 tinystruct 框架文档。本文档为使用和开发 tinystruct 框架提供全面的指导。
-
+欢迎查阅 tinystruct 框架文档。本文档为使用和开�tinystruct 框架提供全面的指导�
 ## What's New in v1.7.18
 
 - **Enhanced AI Integration**: Built-in support for AI integration and plugin-based architecture
@@ -43,11 +42,10 @@ Welcome to the tinystruct framework documentation. This documentation provides c
 - [数据库集成](zh/database.md)
 - [高级特性](zh/advanced-features.md)
 - [最佳实践](zh/best-practices.md)
-- API参考
-  - [应用程序 API](zh/api/application.md)
+- API参�  - [应用程序 API](zh/api/application.md)
   - [动作 API](zh/api/action.md)
   - [配置 API](zh/api/configuration.md)
-  - [数据库 API](zh/api/database.md)
+  - [数据�API](zh/api/database.md)
 
 ## Quick Start
 
@@ -68,7 +66,7 @@ Add the dependency to your `pom.xml`:
 <dependency>
     <groupId>org.tinystruct</groupId>
     <artifactId>tinystruct</artifactId>
-    <version>1.7.19</version>
+    <version>1.7.25</version>
     <classifier>jar-with-dependencies</classifier>
 </dependency>
 ```
@@ -161,7 +159,6 @@ If you'd like to contribute to this documentation, please:
 2. Create a new branch for your changes / 创建新的分支
 3. Submit a pull request with your improvements / 提交拉取请求
 
-## License / 许可证
-
+## License / 许可�
 This documentation is licensed under the same terms as the tinystruct framework (Apache License 2.0).
-本文档采用与 tinystruct 框架相同的许可条款。
+本文档采用与 tinystruct 框架相同的许可条款�

en/README.md

@@ -28,7 +28,7 @@ Add the dependency to your pom.xml:
 <dependency>
     <groupId>org.tinystruct</groupId>
     <artifactId>tinystruct</artifactId>
-    <version>1.7.23</version>
+    <version>1.7.25</version>
     <classifier>jar-with-dependencies</classifier>
 </dependency>
 ```
@@ -97,4 +97,4 @@ public class Example extends AbstractApplication {
 
 ## License
 
-Licensed under the Apache License, Version 2.0
+Licensed under the Apache License, Version 2.0

en/SUMMARY.md

@@ -9,10 +9,11 @@
 * [Database Integration](database.md)
 * [Advanced Features](advanced-features.md)
 * [Best Practices](best-practices.md)
+* [What's New in 1.7.25](whats-new-1.7.25.md)
 * [What's New in 1.7.23](whats-new-1.7.23.md)
 
 ## API Reference
 * [Action API](api/action.md)
 * [Application API](api/application.md)
 * [Configuration API](api/configuration.md)
-* [Database API](api/database.md)
+* [Database API](api/database.md)

en/core-concepts.md

@@ -52,7 +52,7 @@ Actions are the core building blocks of tinystruct applications. They handle bot
 )
 ```
 
-### HTTP Method-Specific Actions (New in 1.7.17)
+### HTTP Method-Specific Actions (New in 1.7.25)
 
 You can now specify which HTTP methods an action responds to:
 
@@ -271,7 +271,7 @@ dispatcher.dispatch(new UserCreatedEvent(newUser));
 
 ## AI Integration
 
-New in version 1.7.17, tinystruct includes built-in support for AI integration:
+New in version 1.7.25, tinystruct includes built-in support for AI integration:
 
 ### MCP (Model Context Protocol) Support
 

en/database.md

@@ -736,6 +736,75 @@ found.update();
 found.delete();
 ```
 
+## Vector Database Operations (New in 1.7.25)
+
+Tinystruct 1.7.25 introduces native support for vector databases, designed for AI applications that require similarity searches based on vector embeddings.
+
+### Configuration
+
+To enable vector database support, configure the following properties in your `config.properties`:
+
+```properties
+# Vector Database Configuration
+vector.database.driver=org.sqlite.JDBC
+vector.database.url=jdbc:sqlite:src/main/resources/vector.db
+```
+
+### VectorOperator
+
+The `VectorOperator` class is a specialized operator for managing vector data. It extends `DatabaseOperator` and provides methods for adding, deleting, and searching vectors.
+
+#### Adding Vectors
+
+```java
+double[] vector = {0.1, 0.2, 0.3, ...}; // Your embedding vector
+String label = "Document Title";
+int entityId = 101;
+String entityType = "Article";
+
+try (VectorOperator operator = new VectorOperator()) {
+    operator.add(vector, label, entityId, entityType);
+} catch (ApplicationException e) {
+    // Handle exception
+}
+```
+
+#### Similarity Search
+
+You can search for the most similar vectors using cosine similarity:
+
+```java
+double[] queryVector = {...};
+int topK = 5; // Number of results to return
+
+try (VectorOperator operator = new VectorOperator()) {
+    List<SearchResult> results = operator.search(queryVector, topK);
+    
+    for (SearchResult result : results) {
+        System.out.println("Entity ID: " + result.getEntityId());
+        System.out.println("Score: " + result.getScore()); // Cosine similarity score
+    }
+} catch (ApplicationException e) {
+    // Handle exception
+}
+```
+
+### Vector Interface
+
+For a higher-level abstraction, you can use the `Vector` interface:
+
+```java
+import org.tinystruct.data.Vector;
+
+// Similarity search based on a query string (requires implementation of embedding generation)
+List<Data> similarItems = vector.similarity("search query");
+```
+
+### Supported Engines
+
+The current implementation of `VectorOperator` uses **SQLite** as its default storage engine, making it lightweight and easy to deploy without a separate database server.
+
+
 ## Best Practices
 
 1. **Connection Management**: Always close your database connections when done.

en/getting-started.md

@@ -29,7 +29,7 @@ Add the tinystruct dependency to your project's `pom.xml` file:
 <dependency>
     <groupId>org.tinystruct</groupId>
     <artifactId>tinystruct</artifactId>
-    <version>1.7.23</version>
+    <version>1.7.25</version>
     <classifier>jar-with-dependencies</classifier>
 </dependency>
 ```
@@ -74,7 +74,7 @@ public class HelloWorldApp extends AbstractApplication {
         return "Hello, " + name + "!";
     }
 
-    // HTTP method-specific actions (new in 1.7.17)
+    // HTTP method-specific actions (new in 1.7.25)
     @Action(value = "greet", mode = Mode.HTTP_GET)
     public String greetGet() {
         return "GET: Hello!";
@@ -185,7 +185,7 @@ The framework automatically:
 
 ### HTTP Method-Specific Actions
 
-New in version 1.7.17, you can specify which HTTP methods an action responds to:
+New in version 1.7.25, you can specify which HTTP methods an action responds to:
 
 ```java
 @Action(value = "resource", mode = Mode.HTTP_GET)
@@ -208,25 +208,25 @@ A typical tinystruct project structure looks like this:
 ```
 my-app/
 ├── src/
-│   ├── main/
-│   │   ├── java/
-│   │   │   └── com/
-│   │   │       └── example/
-│   │   │           ├── HelloWorldApp.java
-│   │   │           ├── actions/
-│   │   │           ├── models/
-│   │   │           ├── services/
-│   │   │           └── repositories/
-│   │   └── resources/
-│   │       ├── config.properties
-│   │       └── templates/
-│   └── test/
-│       └── java/
-│           └── com/
-│               └── example/
-│                   └── HelloWorldAppTest.java
+�  ├── main/
+�  �  ├── java/
+�  �  �  └── com/
+�  �  �      └── example/
+�  �  �          ├── HelloWorldApp.java
+�  �  �          ├── actions/
+�  �  �          ├── models/
+�  �  �          ├── services/
+�  �  �          └── repositories/
+�  �  └── resources/
+�  �      ├── config.properties
+�  �      └── templates/
+�  └── test/
+�      └── java/
+�          └── com/
+�              └── example/
+�                  └── HelloWorldAppTest.java
 ├── bin/
-│   └── dispatcher
+�  └── dispatcher
 └── pom.xml
 ```
 

en/whats-new-1.7.25.md

@@ -0,0 +1,77 @@
+# What's New in tinystruct 1.7.25
+
+This document highlights the new features, improvements, and changes introduced in tinystruct version 1.7.25.
+
+> See also: [What's New in 1.7.23](whats-new-1.7.23.md) for earlier features including the built-in POJO generator and native LocalDateTime support.
+
+## Major New Features
+
+### 1. Vector Database Support
+
+Version 1.7.25 introduces comprehensive support for vector operations, enabling next-gen AI applications that require similarity searches and embedding storage.
+
+**Key Components:**
+- **`org.tinystruct.data.Vector`**: A new interface for managing vector collections.
+- **`org.tinystruct.data.VectorOperator`**: A specialized operator for executing vector-based queries, supporting SQLite as the default storage engine.
+- **Similarity Search**: Built-in support for cosine similarity searches to find related data based on embedding vectors.
+
+**Example Usage:**
+
+```java
+// Adding a vector to the database
+double[] embedding = getEmbedding("Some text content");
+try (VectorOperator operator = new VectorOperator()) {
+    operator.add(embedding, "label", 123, "entityType");
+}
+
+// Searching for similar vectors
+try (VectorOperator operator = new VectorOperator()) {
+    List<SearchResult> results = operator.search(queryVector, 5);
+    for (SearchResult result : results) {
+        System.out.println("Similar entity ID: " + result.getEntityId());
+    }
+}
+```
+
+### 2. Performance & Stability Improvements
+
+- **`SSEPushManager` Fixes**: Enhanced reliability for Server-Sent Events with better connection management and test coverage.
+- **NullPointerException Handling**: Fixed various edge cases where NPEs could occur during complex request handling.
+- **Optimized Thread Management**: Replaced active-wait loops with more efficient thread blocking mechanisms, reducing CPU usage during idle periods.
+- **Enhanced Application Management**: Improved stability in the `ApplicationManager` for starting and stopping services.
+
+## Configuration
+
+To use the vector database, you can configure the following properties:
+
+```properties
+# config.properties
+vector.database.driver=org.sqlite.JDBC
+vector.database.url=jdbc:sqlite:src/main/resources/vector.db
+```
+
+## Migration Guide
+
+### From 1.7.23 to 1.7.25
+
+1. **Update Maven Dependency**
+   ```xml
+   <dependency>
+       <groupId>org.tinystruct</groupId>
+       <artifactId>tinystruct</artifactId>
+       <version>1.7.25</version>
+   </dependency>
+   ```
+
+2. **Initialize Vector Database** (Optional)
+   If you plan to use vector features, ensure the `vector.db` file is present in your resources or configured correctly in your properties.
+
+## Community and Resources
+
+- **GitHub**: <https://github.com/tinystruct/tinystruct>
+- **Documentation**: <https://tinystruct.org>
+- **Examples**: <https://github.com/tinystruct/tinystruct-examples>
+
+## Conclusion
+
+Version 1.7.25 focuses on bringing AI-native capabilities to the tinystruct framework through its new vector support, while continuing to improve the core performance and stability that developers expect.