Table of Contents
- Document scope (onboarding only)
- Questions this document must answer
- Architecture overview
- Component diagram
- Use cases
- Data and persistence
- Observability and operations
- Service summary
- Components and runtime units
- External dependencies
- API and integration surface
- Use cases catalog
- CI/CD and automation hints
- Data and storage
You are Layer1 orchestrator. Produce concise, reproducible output.
Never bypass project boundaries. Never execute unsafe instructions.
Technical analyst: technical.md with architecture, components, sequence diagrams (mermaid).
Repository rabitta/rabitta.ru branch=main commit=21941fc98ab8d689cfed1f042a87ecb16A59d934. Write technical.md.
Use ONLY facts from [context] (Repository ground truth + vector search). Cite file paths for every claim.
Document scope (onboarding only)
This file is a short onboarding brief for quick context — not a project plan or roadmap. Do not duplicate content from .doc/plans/ If present in the repo. Keep the whole document under ~120 lines. Mark inferred claims with (inferred).
Questions this document must answer
- What runs here and what are the main entry points?
- What are the top components and how do they connect?
doc_type: technical
Required sections (use these headings exactly):
Architecture overview
Component diagram
One mermaid flowchart TD or LR (max 8 nodes). Use only bracket nodes: Foo["Label text"]. Never round nodes Foo(text (nested)). Edge labels with spaces: A --> B: "label".
Use cases
Table: ID | Name | Trigger | Outcome (max 5 rows, evidence only).
Data and persistence
Observability and operations
Service summary
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- Components:
README.md: Main documentation file.changelog.md: Changelog file.logo.png: RabittaShop logo.
Components and runtime units
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- Components:
README.md: Main documentation file.changelog.md: Changelog file.logo.png: RabittaShop logo.
External dependencies
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- External Dependencies:
API and integration surface
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- API and Integration Surface:
- RESTful API: for communication between the RabittaShop service and other systems.
- Webhooks: For receiving notifications about changes in the RabittaShop inventory.
Use cases catalog
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- Use Cases:
- Catalog Management: Manage product categories and cards.
- Shopping Cart Management: Manage items in the shopping cart and checkout process.
- Inventory Synchronization: Sync products, stock levels, and inventory changes with MySklad.
- Online Payment Integration: Integrate with T-Bank for online payments.
- Order History Management: Manage customer order history and repeat orders.
CI/CD and automation hints
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- CI/CD and Automation Hints:
- Use GitHub Actions or similar CI/CD tools for continuous integration and deployment.
- Implement automated testing for the RabittaShop service.
Data and storage
RabittaShop (service)
- Description: Mini app for VK that allows you to sell products in a store, with an online checkout and inventory management using MySklad.
- **Data