How benomads/ortaqzan works
OrtaqZan is a Spring Boot legal-assistance service. A user submits a message and memory ID to the assistant endpoint; the service streams tokens from a LangChain4j assistant. Configuration defines document ingestion, embeddings, retrieval, and chat memory, while Elasticsearch is configured as the embedding store. The README also advertises contract analysis and multilingual guidance, though sampled code does not show a separate contract-analysis workflow. The graph follows shown calls and configuration; uncertain framework wiring is omitted or marked dashed.
Main entry points: AssistantConfig.java Assistant configuration · data Legal document corpus · AssistantController.java Assistant endpoint · AssistantService.java Streaming service
Components 16
API and streaming
- Assistant endpoint
src/main/java/benomads/ortaq_zan/assistant/AssistantController.java - Streaming service
src/main/java/benomads/ortaq_zan/service/AssistantService.java - Application entry point
src/main/java/benomads/ortaq_zan/OrtaqZanApplication.java
Assistant runtime
- Legal assistant
src/main/java/benomads/ortaq_zan/assistant/Assistant.java - Assistant configuration
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Chat memory
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java
Legal knowledge
- Embedding model
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Content retriever
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Document ingestion
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Legal document corpus
src/main/resources/data - Elasticsearch store config
src/main/java/benomads/ortaq_zan/vectordb/ElasticEmbeddingStoreConfig.java - Document loader
src/main/java/benomads/ortaq_zan/service/DocumentLoader.java - Loader examples
src/main/java/benomads/ortaq_zan/service/DocumentLoaderExamples.java
User domain
- User entity
src/main/java/benomads/ortaq_zan/entity/User.java
Other components
- User
- Elasticsearch
Connections 15
- User → Assistant endpoint: submits message
src/main/java/benomads/ortaq_zan/assistant/AssistantController.java - Assistant endpoint → Streaming service: forwards request
src/main/java/benomads/ortaq_zan/assistant/AssistantController.java - Streaming service → Legal assistant: starts token stream
src/main/java/benomads/ortaq_zan/service/AssistantService.java - Legal assistant → User: streams legal guidance
README.md - Assistant configuration → Embedding model: creates
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Assistant configuration → Content retriever: configures
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Assistant configuration → Chat memory: provides
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Assistant configuration → Document ingestion: runs ingestion
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Document ingestion → Legal document corpus: loads documents
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Content retriever → Embedding model: embeds queries
src/main/java/benomads/ortaq_zan/assistant/AssistantConfig.java - Content retriever → Elasticsearch: searches embeddings
- Document ingestion → Elasticsearch: stores embeddings
- Elasticsearch store config → Elasticsearch: configures connection
src/main/java/benomads/ortaq_zan/vectordb/ElasticEmbeddingStoreConfig.java - Document loader → Legal document corpus: loads documents
src/main/java/benomads/ortaq_zan/service/DocumentLoader.java - Loader examples → Legal document corpus: demonstrates loading
src/main/java/benomads/ortaq_zan/service/DocumentLoaderExamples.java