feat: enhance chat service with documentation indexing and improved Docker configuration
Some checks failed
CI/CD Pipeline / Generate Documentation (push) Failing after 7m41s
CI/CD Pipeline / Lint Code (push) Failing after 7m44s
CI/CD Pipeline / Run Tests (push) Has been skipped
CI/CD Pipeline / Security Scanning (push) Has been skipped
CI/CD Pipeline / Build and Push Docker Images (api) (push) Has been skipped
CI/CD Pipeline / Build and Push Docker Images (chat) (push) Has been skipped
CI/CD Pipeline / Build and Push Docker Images (frontend) (push) Has been skipped
CI/CD Pipeline / Build and Push Docker Images (worker) (push) Has been skipped
CI/CD Pipeline / Deploy to Staging (push) Has been skipped
CI/CD Pipeline / Deploy to Production (push) Has been skipped

This commit is contained in:
2025-10-20 19:15:32 +02:00
parent 6f5deb0879
commit 27dd9e00b6
14 changed files with 784 additions and 94 deletions

View File

@@ -19,15 +19,11 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Essential Commands
### Development Environment Setup
**NOTE for Fedora Users**: Replace `docker-compose` with `podman-compose` in all commands below. Podman is the default container engine on Fedora and is Docker-compatible.
```bash
# Install dependencies
poetry install
# Start Docker development stack (6 services: MongoDB, Redis, API, Chat, Worker, Frontend)
# On Fedora: use 'podman-compose' instead of 'docker-compose'
cd deploy/docker
docker-compose -f docker-compose.dev.yml up --build -d
@@ -85,10 +81,10 @@ poetry run docs-chat
### Database Operations
```bash
# Access MongoDB shell in Docker (use 'podman' instead of 'docker' on Fedora)
# Access MongoDB shell in Docker
docker exec -it datacenter-docs-mongodb-dev mongosh -u admin -p admin123
# Access Redis CLI (use 'podman' instead of 'docker' on Fedora)
# Access Redis CLI
docker exec -it datacenter-docs-redis-dev redis-cli
# Check database connectivity
@@ -324,8 +320,6 @@ except SpecificException as e:
**Primary development environment**: Docker Compose
**Fedora Users**: Use `podman-compose` instead of `docker-compose` and `podman` instead of `docker` for all commands. Podman is the default container engine on Fedora and is Docker-compatible.
**Services in `deploy/docker/docker-compose.dev.yml`**:
- `mongodb`: MongoDB 7 (port 27017)
- `redis`: Redis 7 (port 6379)
@@ -336,8 +330,8 @@ except SpecificException as e:
**Development cycle**:
1. Edit code in `src/`
2. Rebuild and restart affected service: `docker-compose -f docker-compose.dev.yml up --build -d api` (use `podman-compose` on Fedora)
3. Check logs: `docker-compose -f docker-compose.dev.yml logs -f api` (use `podman-compose` on Fedora)
2. Rebuild and restart affected service: `docker-compose -f docker-compose.dev.yml up --build -d api`
3. Check logs: `docker-compose -f docker-compose.dev.yml logs -f api`
4. Test: Access http://localhost:8000/api/docs
**Volume mounts**: Source code is mounted, so changes are reflected (except for dependency changes which need rebuild).