1 Commits

Author SHA1 Message Date
ilia
7924c3bdc7 Add comprehensive Ansible technical reference
Some checks failed
CI / lint-and-test (push) Has been cancelled
CI / security-scan (push) Has been cancelled
CI / dependency-scan (push) Has been cancelled
CI / docker-build-test (push) Has been cancelled
CI / workflow-summary (push) Has been cancelled
NEW: Complete technical documentation for Ansible role implementation

📄 ANSIBLE_TECHNICAL_REFERENCE.md
====================================

INSTALLATION:
 Uses pyproject.toml (pip install -e .)
 NOT requirements.txt
 Python 3.11+ required

MIGRATIONS:
 Command: alembic upgrade head
 Run from project root (where alembic.ini is)
 Reads DATABASE_URL from .env
 Idempotent (safe to re-run)

SCRIPT PATHS (all in scripts/):
================================
Data Ingestion:
- fetch_congressional_trades.py
- enrich_securities.py
- fetch_sample_prices.py
- ingest_from_fixtures.py
- add_custom_trades.py
- scrape_alternative_sources.py

Analytics:
- analyze_official.py
- calculate_all_returns.py
- generate_trading_report.py

Monitoring:
- monitor_market.py
- analyze_disclosure_timing.py
- generate_pattern_report.py

Reporting:
- send_daily_report.py
- send_weekly_report.py
- health_check.py

Automation (Shell):
- automated_daily_run.sh  (for cron)
- automated_weekly_run.sh  (for cron)
- setup_cron.sh
- setup_automation.sh

COMPLETE DEPLOYMENT SEQUENCE:
=============================
Phase 1: System prep (user, packages, PostgreSQL)
Phase 2: App deployment (clone, venv, install, migrate)
Phase 3: Automation (logs, cron jobs)
Phase 4: Verification (health check, tests)

ANSIBLE TASK CHECKLIST:
=======================
 Full task examples for tasks/main.yml
 .env template (templates/env.j2)
 Variable reference (minimal vs full)
 Update procedure
 Testing commands
 Common issues & solutions

This doc has EVERYTHING needed to write the Ansible role!
2025-12-24 22:30:38 -05:00