Flatten repo structure: move crawler/ to root, remove vqa/ and immoweb/
The crawler subdirectory was the only active project. Moving it to the repo root simplifies paths and removes the unnecessary nesting. The vqa/ and immoweb/ directories were legacy/unused and have been removed. Updated .drone.yml, .gitignore, .claude/ docs, and skills to reflect the new flat structure.
This commit is contained in:
parent
e2247be700
commit
eafbc1ac52
221 changed files with 70 additions and 146140 deletions
|
|
@ -12,7 +12,7 @@ date: 2026-02-06
|
|||
|
||||
# Dev Environment Management
|
||||
|
||||
Docker Compose orchestrates the dev environment locally from `crawler/`. All project
|
||||
Docker Compose orchestrates the dev environment locally. All project
|
||||
commands (pytest, alembic, mypy, python, etc.) must run inside the `app` container
|
||||
via `docker compose exec app <command>`. Only docker/kubectl commands run on the host.
|
||||
|
||||
|
|
@ -20,85 +20,85 @@ via `docker compose exec app <command>`. Only docker/kubectl commands run on the
|
|||
|
||||
```bash
|
||||
# Start all services (Redis, MySQL, API, Celery worker, Celery beat)
|
||||
cd crawler && docker compose up
|
||||
docker compose up
|
||||
|
||||
# Start in detached mode (background)
|
||||
cd crawler && docker compose up -d
|
||||
docker compose up -d
|
||||
|
||||
# Rebuild images and start (after Dockerfile or dependency changes)
|
||||
cd crawler && docker compose up --build
|
||||
docker compose up --build
|
||||
|
||||
# Or use the start.sh helper
|
||||
cd crawler && ./start.sh # foreground
|
||||
cd crawler && ./start.sh --build # rebuild first
|
||||
./start.sh # foreground
|
||||
./start.sh --build # rebuild first
|
||||
```
|
||||
|
||||
## Stopping the Dev Environment
|
||||
|
||||
```bash
|
||||
cd crawler && docker compose down
|
||||
docker compose down
|
||||
|
||||
# Also remove volumes (fresh database, fresh Redis)
|
||||
cd crawler && docker compose down -v
|
||||
docker compose down -v
|
||||
|
||||
# Or use the helper
|
||||
cd crawler && ./start.sh --down
|
||||
./start.sh --down
|
||||
```
|
||||
|
||||
## Checking Status
|
||||
|
||||
```bash
|
||||
# List running containers
|
||||
cd crawler && docker compose ps
|
||||
docker compose ps
|
||||
|
||||
# Check health status
|
||||
cd crawler && docker compose ps --format "table {{.Name}}\t{{.Status}}"
|
||||
docker compose ps --format "table {{.Name}}\t{{.Status}}"
|
||||
```
|
||||
|
||||
## Viewing Logs
|
||||
|
||||
```bash
|
||||
# Follow all service logs
|
||||
cd crawler && docker compose logs -f
|
||||
docker compose logs -f
|
||||
|
||||
# Follow specific service logs
|
||||
cd crawler && docker compose logs -f app
|
||||
cd crawler && docker compose logs -f celery
|
||||
cd crawler && docker compose logs -f celery-beat
|
||||
cd crawler && docker compose logs -f mysql
|
||||
cd crawler && docker compose logs -f redis
|
||||
docker compose logs -f app
|
||||
docker compose logs -f celery
|
||||
docker compose logs -f celery-beat
|
||||
docker compose logs -f mysql
|
||||
docker compose logs -f redis
|
||||
|
||||
# Or use the helper
|
||||
cd crawler && ./start.sh --logs
|
||||
./start.sh --logs
|
||||
```
|
||||
|
||||
## Restarting Individual Services
|
||||
|
||||
```bash
|
||||
# Restart just the API (e.g., after config change)
|
||||
cd crawler && docker compose restart app
|
||||
docker compose restart app
|
||||
|
||||
# Restart Celery worker
|
||||
cd crawler && docker compose restart celery
|
||||
docker compose restart celery
|
||||
|
||||
# Rebuild and restart a single service
|
||||
cd crawler && docker compose up --build app
|
||||
docker compose up --build app
|
||||
```
|
||||
|
||||
## Running Database Migrations
|
||||
|
||||
```bash
|
||||
# Apply pending migrations
|
||||
cd crawler && docker compose exec app alembic upgrade head
|
||||
docker compose exec app alembic upgrade head
|
||||
|
||||
# Create a new migration
|
||||
cd crawler && docker compose exec app alembic revision -m "description"
|
||||
docker compose exec app alembic revision -m "description"
|
||||
```
|
||||
|
||||
## Running Tests Inside Container
|
||||
|
||||
```bash
|
||||
cd crawler && docker compose exec app pytest tests/ -v --cov=. --cov-report=term-missing
|
||||
docker compose exec app pytest tests/ -v --cov=. --cov-report=term-missing
|
||||
```
|
||||
|
||||
## Running Any Command Inside Container
|
||||
|
|
@ -107,14 +107,14 @@ All project commands must be run inside the `app` container:
|
|||
|
||||
```bash
|
||||
# General pattern
|
||||
cd crawler && docker compose exec app <command>
|
||||
docker compose exec app <command>
|
||||
|
||||
# Examples
|
||||
cd crawler && docker compose exec app python main.py dump-listings --type rent
|
||||
cd crawler && docker compose exec app mypy .
|
||||
cd crawler && docker compose exec app ruff check .
|
||||
cd crawler && docker compose exec app poetry install
|
||||
cd crawler && docker compose exec app bash # interactive shell
|
||||
docker compose exec app python main.py dump-listings --type rent
|
||||
docker compose exec app mypy .
|
||||
docker compose exec app ruff check .
|
||||
docker compose exec app poetry install
|
||||
docker compose exec app bash # interactive shell
|
||||
```
|
||||
|
||||
## Services and Ports
|
||||
|
|
@ -130,7 +130,7 @@ cd crawler && docker compose exec app bash # interactive shell
|
|||
## Environment Variables
|
||||
|
||||
Key env vars are set in `docker-compose.yml`. To override locally, create a `.env` file
|
||||
in `crawler/` (see `.env.sample`). Key overrides:
|
||||
(see `.env.sample`). Key overrides:
|
||||
|
||||
- `ROUTING_API_KEY` - Google Maps API key (passed from host env)
|
||||
- `SCRAPE_SCHEDULES` - JSON array of periodic scrape configs (passed from host env)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue