How kmn-orga/walletinsight works
Main Components
• Frontend: Developed in Vue.js (as indicated by the presence of a “frontend” directory with Vue files, components, Vite configuration). It handles the dashboard, data visualization, file upload for bank account movements, and general user interactions.
• Backend: Built on Node.js using the NestJS framework (evident from configuration files such as nest-cli.json, the NestJS controller, service, and module files in the “backend/src” directory). It manages business logic, processes requests from the frontend, and handles file uploads.
• Database: PostgreSQL is used for storing transactions and categorization data. Represent it as a distinct data store in the architecture.
• Deployment Infrastructure: Docker Compose is used for deploying the system, which suggests that each service (frontend, backend, microservice, database) might be containerized.
Relationships & Interactions
• The Backend processes file uploads (e.g., Excel files) and triggers the logic for inserting transaction data into the database.
• The Backend communicates with PostgreSQL to persist and query transaction data.
• All components are deployed and orchestrated through Docker Compose, so include an overarching deployment container that interacts with all individual containers.
Architectural Patterns or Design Principles
• Separation of Concerns: Clearly distinguish between the responsibilities of the frontend (UI and interaction), backend (API and business logic), and microservice (categorization logic).
• Modular Design: The backend is organized into modules (e.g., the “upload” module) following the NestJS structure. Emphasize this modularity.
• Microservices Communication: The integration of a Python-based microservice using gRPC highlights a decoupled approach, favoring scalability and independent deployment.
• Containerization: Detail the use of Docker Compose for deployment, which promotes environment consistency and scalability.
Relevant Technologies & Frameworks
• Frontend: Vue.js, Vite, and state management (e.g., Vue stores).
• Backend: Node.js with NestJS (including components like controllers, services, and modules).
• Microservice: Python (with gRPC integration) – note that the microservice is a critical part, even if its file structure isn’t directly shown.
• Database: PostgreSQL along with any plugins or extensions mentioned in the README.
• Deployment: Docker Compose for orchestrating containers during deployment.