How zeus22ru/wiki_4 works
This is a local-document knowledge base and RAG question-answering product, exposed through a web app, JSON API, CLI, and Telegram/Bitrix24 bots. The main path is document ingestion and indexing, then a user question through retrieval and local-model generation, with cited answers and chat history. The graph also preserves authentication, attachments, administration, and issue feedback. Edges follow explicit README or SOURCE INDEX references; unsampled subsystem links are omitted rather than inferred.
Main entry points: web_app.py Flask app · create_vector_db.py Document indexing · rag.py RAG orchestration · admin.py Admin API
Components 28
Web access
- Flask app
web_app.py - Account routes
api/routes/auth.py - Session access
api/middleware/auth.py - Chat API
api/routes/chat.py - Document API
api/routes/documents.py - Issue feedback API
api/routes/issues.py
Knowledge and RAG
- Document indexing
create_vector_db.py - Text chunking
core/chunking.py - HTML text extraction
core/html_text.py - Index manifest
core/index_manifest.py - RAG orchestration
core/rag.py - Hybrid retrieval
core/retrieval.py - Model API client
utils/embeddings.py - ChromaDB index
Chat and state
- Attachment routes
api/routes/chat_attachments.py - Attachment storage
core/chat_attachments.py - Chat history
core/chat_history.py
External channels
- Telegram API
api/routes/telegram.py - Telegram worker
scripts/telegram_bot_worker.py - Telegram service
integrations/telegram.py - Bitrix worker
scripts/bitrix24_bot_worker.py - Bitrix integration
integrations/bitrix24.py
Administration
- Admin API
api/routes/admin.py - Runtime settings
config/settings.py - Admin overrides
config/runtime_overrides.py
Other components
- Questioner
- Inference server
- GitHub Issues
Connections 38
- Questioner → Flask app: asks via
README.md - Flask app → Chat API: registers routes
web_app.py - Flask app → Document API: registers routes
web_app.py - Flask app → Account routes: registers routes
web_app.py - Flask app → Issue feedback API: registers routes
web_app.py - Account routes → Chat history: looks up users
api/routes/auth.py - Session access → Chat history: loads users
api/middleware/auth.py - Document API → Document indexing: invokes indexing
api/routes/documents.py - Document indexing → Text chunking: uses chunking
create_vector_db.py - Document indexing → HTML text extraction: uses extraction
create_vector_db.py - Document indexing → Index manifest: uses manifest
create_vector_db.py - Document indexing → Model API client: requests vectors
create_vector_db.py - Document indexing → ChromaDB index: writes index
README.md - Chat API → RAG orchestration: runs question answering
web_app.py - RAG orchestration → Hybrid retrieval: retrieves documents
core/rag.py - Hybrid retrieval → Model API client: embeds queries
core/retrieval.py - Hybrid retrieval → ChromaDB index: queries index
core/retrieval.py - RAG orchestration → Inference server: generates answers
- Model API client → Inference server: calls model API
utils/embeddings.py - Chat API → Chat history: saves messages
web_app.py - Chat API → Attachment storage: loads attachments
web_app.py - Flask app → Attachment routes: registers routes
web_app.py - Attachment routes → Attachment storage: uses storage
api/routes/chat_attachments.py - RAG orchestration → Attachment storage: enriches queries
core/rag.py - Flask app → Admin API: registers routes
web_app.py - Admin API → Session access: checks admin access
api/routes/admin.py - Admin API → Chat history: manages chat data
api/routes/admin.py - Admin API → Hybrid retrieval: uses retrieval
api/routes/admin.py - Admin API → Admin overrides: manages overrides
api/routes/admin.py - Runtime settings → Admin overrides: loads overrides
config/settings.py - Issue feedback API → GitHub Issues: submits feedback
api/routes/issues.py - Telegram worker → Telegram service: uses service
scripts/telegram_bot_worker.py - Telegram worker → RAG orchestration: uses chat runtime
- Telegram worker → Attachment storage: uses attachments
scripts/telegram_bot_worker.py - Telegram worker → Telegram API: calls internal API
- Telegram API → Chat history: manages linked chats
api/routes/telegram.py - Bitrix worker → Bitrix integration: uses integration
scripts/bitrix24_bot_worker.py - Bitrix worker → RAG orchestration: answers questions