How astik2004/bankwise-ai-project works
BankWise is a banking-question assistant whose main journey is secure sign-in, document-backed knowledge-base preparation, then a user-scoped chat request answered through RAG and saved as conversation history. The graph separates document ingestion, knowledge-base/vector work, RAG stages, and chat/conversation persistence, with authentication as a supporting capability. The README documents the overall flows; source excerpts show document ingestion, embedding, and LLM invocation. Several subsystem implementations, including chat persistence and retrieval, were not sampled, so those connections are documented relationships rather than inspected calls.
Main entry points: RagServiceImpl.java RAG orchestration · DocumentIngestionServiceImpl.java Document ingestion · ChatServiceImpl.java Chat service · AuthServiceImpl.java Authentication service
Components 30
Identity and security
- Auth API
src/main/java/com/bankwise/auth/controller/AuthController.java - Authentication service
src/main/java/com/bankwise/auth/service/AuthServiceImpl.java - JWT service
src/main/java/com/bankwise/security/jwt/JwtService.java - Security principal
src/main/java/com/bankwise/security/principal/CustomUserPrincipal.java - User records
src/main/java/com/bankwise/auth/domain/User.java
Document ingestion
- Document API
src/main/java/com/bankwise/document/controller/DocumentController.java - Document service
src/main/java/com/bankwise/document/service/DocumentService.java - Document ingestion
src/main/java/com/bankwise/document/ingestion/DocumentIngestionServiceImpl.java - Document storage
src/main/java/com/bankwise/document/ingestion/storage/LocalDocumentStorage.java - Document records
src/main/java/com/bankwise/document/domain/Document.java
Knowledge base
- Knowledge-base service
src/main/java/com/bankwise/knowledgebase/service/KnowledgeBaseService.java - Knowledge-base ingestion
src/main/java/com/bankwise/knowledgebase/ingestion/KnowledgeBaseIngestionImpl.java - Knowledge-base chunks
src/main/java/com/bankwise/knowledgebase/domain/KnowledgeBaseChunk.java - Embedding service
src/main/java/com/bankwise/knowledgebase/embedding/SpringAiEmbeddingService.java - Vector store
RAG answer pipeline
- RAG orchestration
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - Query processor
src/main/java/com/bankwise/rag/query/DefaultQueryProcessor.java - Document retriever
src/main/java/com/bankwise/rag/retrieval/VectorStoreDocumentRetriever.java - Context builder
src/main/java/com/bankwise/rag/context/DefaultContextBuilder.java - Prompt builder
src/main/java/com/bankwise/rag/prompt/DefaultPromptBuilder.java - LLM service
src/main/java/com/bankwise/rag/llm/SpringAiLlmService.java - Answer validator
src/main/java/com/bankwise/rag/validation/DefaultAnswerValidator.java - Citation builder
src/main/java/com/bankwise/rag/citation/DefaultCitationBuilder.java
Chat and history
- Chat API
src/main/java/com/bankwise/chat/controller/ChatController.java - Chat service
src/main/java/com/bankwise/chat/service/ChatServiceImpl.java - Conversation service
src/main/java/com/bankwise/conversation/service/ConversationServiceImpl.java - Conversation records
src/main/java/com/bankwise/conversation/domain/Conversation.java - Chat messages
src/main/java/com/bankwise/chat/domain/ChatMessage.java
Other components
- User
- Chat model provider
Connections 32
- User → Auth API: registers or logs in
- Auth API → Authentication service: delegates auth
src/main/java/com/bankwise/auth/controller/AuthController.java - Authentication service → User records: reads and writes
src/main/java/com/bankwise/auth/service/AuthServiceImpl.java - Authentication service → JWT service: issues tokens
src/main/java/com/bankwise/auth/service/AuthServiceImpl.java - User → Document API: uploads documents
- Document API → Document service: delegates upload
src/main/java/com/bankwise/document/controller/DocumentController.java - Document service → Document records: manages records
- Document service → Document ingestion: starts ingestion
- Document ingestion → Document records: loads document
src/main/java/com/bankwise/document/ingestion/DocumentIngestionServiceImpl.java - Document ingestion → Document storage: reads file
src/main/java/com/bankwise/document/ingestion/DocumentIngestionServiceImpl.java - User → Knowledge-base service: manages knowledge base
- Document ingestion → Knowledge-base ingestion: provides chunks
- Knowledge-base ingestion → Knowledge-base chunks: creates chunks
src/main/java/com/bankwise/knowledgebase/ingestion/KnowledgeBaseIngestionImpl.java - Knowledge-base ingestion → Embedding service: requests embeddings
- Embedding service → Vector store: stores vectors
src/main/java/com/bankwise/knowledgebase/embedding/SpringAiEmbeddingService.java - User → Chat API: asks question
- Chat API → Chat service: delegates chat
src/main/java/com/bankwise/chat/controller/ChatController.java - Chat service → RAG orchestration: requests answer
- RAG orchestration → Knowledge-base service: validates access
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - RAG orchestration → Query processor: normalizes query
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - RAG orchestration → Document retriever: retrieves sources
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - Document retriever → Vector store: searches vectors
- RAG orchestration → Context builder: builds context
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - RAG orchestration → Prompt builder: builds prompt
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - RAG orchestration → LLM service: generates answer
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - LLM service → Chat model provider: calls model
- RAG orchestration → Answer validator: validates answer
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - RAG orchestration → Citation builder: builds citations
src/main/java/com/bankwise/rag/service/RagServiceImpl.java - Chat service → Conversation service: creates or loads thread
- Chat service → Chat messages: persists messages
- Conversation service → Conversation records: updates metadata
- Conversation service → Chat messages: tracks message count