How hugs-4-bugs/aq-os works
AcquisitionOS is documented as an AI market-intelligence platform for finding, qualifying, contacting, and closing business prospects. Its core workflow runs from discovery through lead scoring and audit, outreach and communication, pipeline and deal management, then proposals and revenue; analytics and real-time intelligence span those stages. The tree does not include the documented Next.js application source, so those capabilities are represented as documented subsystems rather than attributed to unsampled files. The sampled Python backend shows a separate FastAPI entry point and Celery task infrastructure; several task implementations are explicitly foundations or placeholders.
Main entry points: celery_app.py Task scheduler · realtime_tasks.py Realtime tasks · notification_tasks.py Notifications and reminders · main.py FastAPI entry
Components 21
Lead acquisition
- AcquisitionOS
- Business discovery
- Lead records
- Scoring and audit
Sales and revenue
- Deal pipeline
- Deal management
- Proposal generation
Intelligence and engagement
- Outreach generation
- Communication channels
- Sales assistant
- Market analytics
- Notifications and reminders
backend/app/tasks/notification_tasks.py
Python backend
- FastAPI entry
backend/app/main.py - Async database access
backend/app/database.py - Redis utilities
backend/app/redis_client.py - Task scheduler
backend/app/celery_app.py - Email tasks
backend/app/tasks/email_tasks.py - Realtime tasks
backend/app/tasks/realtime_tasks.py - Payment recovery
backend/app/tasks/payment_recovery_tasks.py - Workflow tasks
backend/app/tasks/workflow_tasks.py
Other components
- Sales team
Connections 23
- Sales team → AcquisitionOS: uses
- AcquisitionOS → Business discovery: discovers businesses
- Business discovery → Lead records: creates leads
- Lead records → Scoring and audit: is scored and audited
- Lead records → Outreach generation: is selected for
- Outreach generation → Communication channels: generates messages for
- Communication channels → Deal pipeline: is tracked by
- Deal pipeline → Deal management: tracks stages to
- Deal management → Proposal generation: generates
- Lead records → Market analytics: informs
- Deal pipeline → Market analytics: informs
- Deal management → Market analytics: informs
- AcquisitionOS → Sales assistant: provides
- AcquisitionOS → Notifications and reminders: provides
- FastAPI entry → Async database access: checks health
backend/app/main.py - FastAPI entry → Redis utilities: checks health
backend/app/main.py - Task scheduler → Email tasks: routes tasks
backend/app/celery_app.py - Task scheduler → Notifications and reminders: routes tasks
backend/app/celery_app.py - Task scheduler → Realtime tasks: routes and schedules
backend/app/celery_app.py - Task scheduler → Payment recovery: routes tasks
backend/app/celery_app.py - Task scheduler → Workflow tasks: routes and schedules
backend/app/celery_app.py - Realtime tasks → Email tasks: delegates email
backend/app/tasks/realtime_tasks.py - Realtime tasks → Notifications and reminders: delegates push
backend/app/tasks/realtime_tasks.py