updated docs

7project/src/README.md

@@ -1,23 +1,14 @@
 ## Folder structure
 
 - `src/`
-    - `backend/`
-        - `alembic/` - database migrations
-        - `app/` - main application code
-        - `tests/` - tests
-        - `docker-compose.test.yml` - docker compose for testing database
-        - `Dockerfile` - production Dockerfile
-        - `main.py` - App entrypoint
-        - `requirements.txt` - Python dependencies
-        - `test_locally.sh` - script to run tests with temporary database
+    - `backend/` - Python FastAPI backend application. Described in separate [README](./backend/README.md).
     - `charts/`
-        - `myapp-chart/` - Helm chart for deploying the application, supports prod and dev environments
-    - `frontend/` - React frontend application
-    - `tofu/` - Terraform/OpenTofu services deployment configurations
-        - `modules/` - separated modules for different services
-        - `main.tf` - main deployment configuration
-        - `variables.tf` - deployment variables
-        - `terraform.tfvars.example` - example variables file
+        - `myapp-chart/` - Helm chart for deploying the application, supports prod and dev environments. Described in
+          separate [README](./charts/README.md).
+    - `frontend/` - React frontend application. Described in separate
+      [README](./frontend/README.md).
+    - `tofu/` - Terraform/OpenTofu services deployment configurations. Described in separate
+      [README](./tofu/README.md).
     - `compose.yaml` - Docker Compose file for local development
     - `create_migration.sh` - script to create new Alembic database migration
     - `upgrade_database.sh` - script to upgrade database to latest Alembic revision

7project/src/backend/README.md

@@ -0,0 +1,23 @@
+# Backend
+
+This directory contains the backend code for the project. It is built using Python and FastAPI framework and with
+database migrations support using Alembic.
+
+## Directory structure
+
+- `alembic/` - database migrations
+- `app/` - main application code
+    - `api/` - API endpoints - routers/controllers with request handling logic
+    - `core/` - core application logic - database session management, security
+    - `models/` - database models
+    - `schemas/` - Endpoint schemas
+    - `services/` - utilities for various tasks
+    - `workers/` - background tasks
+    - `app.py` - FastAPI startup script
+    - `celery_app.py` - Celery startup script
+- `tests/` - tests
+- `docker-compose.test.yml` - docker compose for testing database
+- `Dockerfile` - production Dockerfile
+- `main.py` - App entrypoint
+- `requirements.txt` - Python dependencies
+- `test_locally.sh` - script to run tests with temporary database