Web version

.gitignore

@@ -1,5 +1,8 @@
-/src/.idea/
+/src/.idea/
 bin
 obj
 *.user
-/dist/
+/dist/
+server.env
+certs/
+docker-registry-config.json

.vscode/launch.json

@@ -0,0 +1,35 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            // Use IntelliSense to find out which attributes exist for C# debugging
+            // Use hover for the description of the existing attributes
+            // For further information visit https://github.com/dotnet/vscode-csharp/blob/main/debugger-launchjson.md.
+            "name": ".NET Core Launch (web)",
+            "type": "coreclr",
+            "request": "launch",
+            "preLaunchTask": "build",
+            // If you have changed target frameworks, make sure to update the program path.
+            "program": "${workspaceFolder}/src/Hosts/NVs.Budget.Hosts.Web.Server/bin/Debug/net8.0/NVs.Budget.Hosts.Web.Server.dll",
+            "args": [],
+            "cwd": "${workspaceFolder}/src/Hosts/NVs.Budget.Hosts.Web.Server",
+            "stopAtEntry": false,
+            // Enable launching a web browser when ASP.NET Core starts. For more information: https://aka.ms/VSCode-CS-LaunchJson-WebBrowser
+            "serverReadyAction": {
+                "action": "openExternally",
+                "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
+            },
+            "env": {
+                "ASPNETCORE_ENVIRONMENT": "Development"
+            },
+            "sourceFileMap": {
+                "/Views": "${workspaceFolder}/Views"
+            }
+        },
+        {
+            "name": ".NET Core Attach",
+            "type": "coreclr",
+            "request": "attach"
+        }
+    ]
+}

.vscode/tasks.json

@@ -0,0 +1,41 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "build",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "build",
+                "${workspaceFolder}/src/NVs.Budget.sln",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary;ForceNoAlign"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "publish",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "publish",
+                "${workspaceFolder}/src/NVs.Budget.sln",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary;ForceNoAlign"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "watch",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "watch",
+                "run",
+                "--project",
+                "${workspaceFolder}/src/NVs.Budget.sln"
+            ],
+            "problemMatcher": "$msCompile"
+        }
+    ]
+}

DEVELOPMENT.md

@@ -0,0 +1,222 @@
+# Local Development Guide
+
+This guide covers setting up and running the Budget application for local development.
+
+## Prerequisites
+
+### Required Software
+- Docker Desktop
+- PowerShell 7+ (for Windows) or Bash (for Linux/Mac)
+- .NET SDK 8.0+
+- Node.js 20+
+- npm
+
+## Quick Start
+
+The easiest way to start development is using the scripts in `src/Hosts/web-debug/`:
+
+```powershell
+cd src/Hosts/web-debug
+.\start-all.ps1
+```
+
+This will:
+1. Start PostgreSQL database in Docker
+2. Generate SSL certificates
+3. Launch the .NET server with watch mode
+4. Launch the Angular client with watch mode
+
+## Configuration
+
+### 1. Environment Setup
+
+1. Navigate to `src/Hosts/web-debug/`
+2. Copy `server.env.example` to `server.env`
+3. Fill in your Yandex OAuth credentials:
+   ```
+   Auth__Yandex__ClientSecret = your_client_secret
+   Auth__Yandex__ClientId = your_client_id
+   ```
+
+### 2. Database Setup
+
+The development setup uses Docker Compose to run PostgreSQL. The database is automatically created when you run `docker compose up -d`.
+
+**Connection Details:**
+- Host: `localhost`
+- Port: `20000`
+- Database: `budgetdb`
+- User: `postgres`
+- Password: `postgres`
+
+## Service URLs
+
+Once all services are running:
+
+- **Server (HTTPS)**: https://localhost:7237
+- **Server (HTTP)**: http://localhost:5153
+- **Client**: https://localhost:4200
+- **PostgreSQL**: localhost:20000
+
+## Development Workflow
+
+1. **Start all services**:
+   ```powershell
+   cd src/Hosts/web-debug
+   .\start-all.ps1
+   ```
+
+2. **Make changes** to your code in the editor
+
+3. **Watch mode automatically reloads**:
+   - **.NET Server**: `dotnet watch` detects changes and rebuilds/restarts
+   - **Angular Client**: Hot Module Replacement (HMR) updates the browser
+
+4. **View changes** in your browser at http://localhost:4200
+
+## Starting Services Individually
+
+### Start only Docker dependencies
+```powershell
+cd src/Hosts/web-debug
+docker compose up -d
+```
+
+### Start only the server
+```powershell
+cd src/Hosts/web-debug
+.\start-server.ps1
+```
+
+### Start only the client
+```powershell
+cd src/Hosts/web-debug
+.\start-client.ps1
+```
+
+### Stop all services
+```powershell
+cd src/Hosts/web-debug
+.\stop-all.ps1
+```
+
+Then manually stop server/client processes (Ctrl+C in their windows).
+
+## Database Management
+
+### Apply Migrations
+
+After starting the services, apply database migrations:
+```bash
+GET https://localhost:7237/admin/patch-db
+```
+
+Or use curl:
+```bash
+curl -k https://localhost:7237/admin/patch-db
+```
+
+### Reset Database
+
+To completely reset the database (removes all data):
+```powershell
+cd src/Hosts/web-debug
+docker compose down -v
+```
+
+This removes the Docker volume containing PostgreSQL data. The database will be recreated on next start.
+
+## Troubleshooting
+
+### Certificate Issues
+
+If you encounter SSL certificate errors:
+
+```powershell
+cd src/Hosts/web-debug
+# Delete the certs directory
+Remove-Item -Recurse -Force .\certs
+
+# Restart services to regenerate certificates
+.\start-all.ps1
+```
+
+### Database Connection Issues
+
+```powershell
+cd src/Hosts/web-debug
+# Check if PostgreSQL is running
+docker compose ps
+
+# View PostgreSQL logs
+docker compose logs postgres
+
+# Restart PostgreSQL
+docker compose restart postgres
+```
+
+### Port Already in Use
+
+If ports are already in use, stop any conflicting services:
+- Server: 7237 (HTTPS), 5153 (HTTP)
+- Client: 4200
+- PostgreSQL: 20000
+
+### Server Won't Start
+
+1. Check that PostgreSQL is running: `docker compose ps`
+2. Verify connection strings in `server.env`
+3. Check server logs in the PowerShell window where it's running
+4. Ensure ports 7237 and 5153 are not in use
+
+### Client Won't Start
+
+1. Verify Node.js and npm are installed: `node --version` and `npm --version`
+2. Check that port 4200 is not in use
+3. Try deleting `node_modules` and reinstalling:
+   ```bash
+   cd src/Hosts/NVs.Budget.Hosts.Web.Client/budget-client
+   rm -rf node_modules
+   npm install
+   ```
+
+## Project Structure
+
+```
+src/Hosts/web-debug/
+├── docker-compose.yml      # Docker services (postgres, dev-certs)
+├── dev-certs.Dockerfile    # Certificate generation
+├── server.env              # Server environment variables (gitignored)
+├── server.env.example      # Template for server.env
+├── start-all.ps1           # Master script to start everything
+├── start-server.ps1        # Start .NET server on host
+├── start-client.ps1        # Start Angular client on host
+├── stop-all.ps1            # Stop Docker services
+└── README.md               # Additional details
+```
+
+## Docker Volumes
+
+The development setup creates persistent Docker volumes:
+
+- `web-debug_budgetdb-data`: PostgreSQL data (persistent across restarts)
+- `web-debug_certs`: SSL certificates
+
+To remove all volumes and start fresh:
+```powershell
+docker compose down -v
+```
+
+## Benefits of This Development Setup
+
+✅ **Fast Iteration**: Watch mode catches changes instantly  
+✅ **Better Debugging**: Direct access to processes on host  
+✅ **Isolated Dependencies**: Database runs in Docker  
+✅ **Flexible Development**: Start/stop services independently  
+✅ **Production-like**: SSL certificates and proper configuration
+
+## Additional Resources
+
+For more detailed information about the development scripts, see:
+- [src/Hosts/web-debug/README.md](src/Hosts/web-debug/README.md) - Detailed documentation of development scripts
+