Merge branch 'dev' into 'main'

v2.0.2

See merge request AndreyPopov/spot-trading-bot!42

Author: PopovAndrii

docs/developer/for-developers.md

@@ -84,3 +84,18 @@ Formatting is handled by the configured linters, not Prettier:
 
 Keep public release documentation and tags in the established project format.
 Development happens on GitLab; publish the GitHub mirror only after the GitLab side is ready.
+
+## Release commands
+
+For this project, bump the version in `src/package.json` without creating a git tag automatically:
+
+```sh
+docker compose exec app sh -lc "cd /var/www/src && npm version 2.0.2 --no-git-tag-version"
+```
+
+Then create and push the release tag from the host:
+
+```sh
+git tag -a v2.0.2 -m "Release v2.0.2 — test"
+git push origin v2.0.2
+```

docs/guide/overview.md

@@ -58,6 +58,20 @@ In `real` mode the bot places live orders with real funds. Start on
 consider real keys. See the [Disclaimer](/help/disclaimer).
 :::
 
+::: info AI-assisted deployment and coding
+Using AI is encouraged, especially for setup, deployment, and repetitive operator
+work. It usually does not break the project by itself — it helps you launch faster
+and reduces routine friction.
+
+But always review AI-generated changes with your own eyes. New features and non-trivial
+edits should be tested on **Binance testnet first**. AI often gets architecture or
+integration details wrong — not only because the model can make mistakes, but also
+because humans frequently describe requirements incompletely.
+
+Treat AI as an accelerator, not as a final authority: inspect the code, verify the
+behavior, and test the risky paths manually.
+:::
+
 ## How to read these docs
 
 - **[Getting Started](/guide/getting-started)** — get it running in a few minutes.

docs/index.md

@@ -2,7 +2,7 @@
 layout: home
 
 hero:
-  name: Spot Trading Bot for Binance
+  name: Spot Trading Bot for<br>Binance
   text: DCA / Grid hybrid
   tagline: A self-hosted, non-custodial spot bot that averages a position down, closes the whole grid at a profit, and scalps the oscillations in between.
   image:

src/package-lock.json

@@ -1,15 +1,15 @@
 {
   "name": "spot-trading-bot",
   "description": "DCA/Grid hybrid. A self-hosted, non-custodial spot bot that averages a position down, closes the whole grid at a profit, and scalps the oscillations in between.",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "private": true,
   "license": "GPL-3.0-or-later",
   "scripts": {
     "build-css": "sass scss/:public/stylesheets/ --no-source-map",
     "gen-qr": "node ./tools/gen-qr.js",
     "dev": "concurrently \"npm:watch-css\" \"npm:start\"",
     "start": "nodemon ./bin/www",
-    "setup-user": "node ./bin/setup-user.js",
+    "setup-user": "npm_config_update_notifier=false node ./bin/setup-user.js",
     "test": "node --test",
     "prod-runtime": "pm2-runtime start ./bin/www --name my-app",
     "lint": "eslint .",

src/package.json

@@ -73,6 +73,26 @@ function hybridView(obj) {
   }
 }
 
+function emptyPairState() {
+  return {
+    BUY: [],
+    SELL: [],
+    param: {},
+  };
+}
+
+async function loadOrCreatePairState(filePath) {
+  try {
+    return JSON.parse(await fs.readFile(filePath, 'utf8'));
+  } catch (err) {
+    if (err?.code !== 'ENOENT') throw err;
+
+    const data = emptyPairState();
+    await writeFileAtomic(filePath, JSON.stringify(data, null, 2), 'utf8');
+    return data;
+  }
+}
+
 router.post('/table/:symbol', async (req, res, next) => {
   try {
     const rawSymbol = req.body.message;
@@ -257,8 +277,7 @@ router.post('/calculator/restart', async (req, res, next) => {
 
     const filePath = path.join(__dirname, '../data', `${symbol}-binance.json`);
 
-    const content = await fs.readFile(filePath, 'utf8');
-    let data = JSON.parse(content);
+    let data = await loadOrCreatePairState(filePath);
 
     const newData = req.body.message;
     // data = { ...data, ...newData };
@@ -332,8 +351,7 @@ router.post('/calculator/param', async (req, res, next) => {
     const symbol = rawPair.replace(/[^a-zA-Z0-9_-]/g, '');
     const filePath = path.join(__dirname, '../data', `${symbol}-binance.json`);
 
-    const content = await fs.readFile(filePath, 'utf8');
-    const data = JSON.parse(content);
+    const data = await loadOrCreatePairState(filePath);
 
     if (!data.param || typeof data.param !== 'object') {
       data.param = {};
@@ -379,12 +397,7 @@ router.post('/calculator/hybrid', async (req, res) => {
     const symbol = String(msg.pair).replace(/[^a-zA-Z0-9_-]/g, '');
     const filePath = path.join(__dirname, '../data', `${symbol}-binance.json`);
 
-    let data;
-    try {
-      data = JSON.parse(await fs.readFile(filePath, 'utf8'));
-    } catch {
-      return res.status(404).json({ message: `No cycle for ${symbol}` });
-    }
+    const data = await loadOrCreatePairState(filePath);
     if (!data.param || typeof data.param !== 'object') {
       data.param = {};
     }