This repository now contains the monorepo root. The Expo client lives in client/ and has its own README:

Client README

This project uses Swagger for API documentation.

• Swagger UI: Access the interactive API documentation at http://localhost:8000/swagger/index.html when the server is running.
• Spec Files: The raw Swagger specification files are located in the docs/ directory (swagger.json, swagger.yaml).

The application includes comprehensive monitoring with Prometheus and Grafana.

A pre-configured dashboard "Household Manager API" is automatically provisioned with panels for:

• Overview: Uptime, request rate, error rate, P95 latency, active users
• HTTP Metrics: Request rate by status, latency percentiles, top endpoints
• Database Metrics: Queries by operation, query latency, connections
• Redis Metrics: Operations by type, cache hit/miss rate
• Authentication: Login attempts, token validation
• Business Metrics: Homes, tasks, bills, shopping items, polls
• External Services: S3 uploads, email sends, OCR requests

The application is configured using environment variables. You can copy the example file to get started:

cp .env.example .env

For Docker-based local development, the repository already includes a tracked .env.dev with safe dev defaults for PostgreSQL and Redis.

This project uses Docker Compose for easy deployment.

To run the application in development mode with hot-reloading and monitoring:

docker compose -f docker-compose.dev.yaml up --build

Available services:

• API Server: http://localhost:8000
• Swagger UI: http://localhost:8000/swagger/index.html
• Prometheus: http://localhost:9090
• Grafana: http://localhost:3000
• PostgreSQL: localhost:5432
• Redis: localhost:6379

To run the application with the main compose file:

1. Create a .env file with your deployment values.
2. Set Grafana credentials in .env:

   ADMIN_USERNAME=your-admin-user
   ADMIN_PASSWORD=your-secure-password
   GRAFANA_ROOT_URL=https://grafana.yourdomain.com
   

3. Run Docker Compose:

docker compose up --build -d

If you prefer to run the Go server locally without Docker (requires a running Postgres and Redis instance):

1. Ensure Postgres and Redis are running and accessible.
2. Update .env with the correct DB_DSN and REDIS_ADDR (e.g., localhost).
3. Run the server:

go run cmd/server/main.go

diploma-server/
├── cmd/server/           # Application entry point
├── internal/
│   ├── cache/            # Redis client
│   ├── config/           # Configuration management
│   ├── http/
│   │   ├── handlers/     # API endpoint handlers
│   │   └── middleware/   # HTTP middleware (metrics, logging, auth)
│   ├── logger/           # Logging utilities
│   ├── metrics/          # Prometheus metrics definitions
│   ├── models/           # Data models
│   ├── repository/       # Data access layer
│   ├── router/           # Route setup
│   ├── services/         # Business logic
│   └── utils/            # Utility functions
├── monitoring/
│   ├── prometheus/       # Prometheus configuration
│   └── grafana/
│       ├── dashboards/   # Grafana dashboard JSON files
│       └── provisioning/ # Grafana auto-provisioning configs
├── docs/                 # Swagger documentation
├── docker-compose.dev.yaml
├── docker-compose.yaml
├── Dockerfile
└── Dockerfile.dev