diff --git a/summary/technical.md b/summary/technical.md new file mode 100644 index 0000000..75eaa73 --- /dev/null +++ b/summary/technical.md @@ -0,0 +1,96 @@ +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:** + - [VK](https://vk.com): for the VK platform. + - [MySklad](https://www.moysklad.ru/): For inventory management. + +## 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 \ No newline at end of file