How naghi20/aqari-ai works
AQARI AI is a serverless real-estate listing assistant. In the implemented baseline, an agent’s property payload is validated, converted into a privacy-filtered AI context, and stored as a draft in DynamoDB; a separate Lambda handler reports health. The README describes a broader MVP and roadmap: private photo storage, Bedrock-generated listing and social content, human approval, and manual Joomla export. Those future capabilities are shown as planned, not as implemented flows. Arrows for the current create path are supported by excerpts; planned integrations are dashed because their runtime wiring is not present in the sampled source.
Main entry points: create_property.py Create draft · validation_service.py Verified context · aqari_ai Draft content package · dynamodb_service.py Draft persistence
Components 16
Request handlers
- API Gateway
- Create draft
backend/src/aqari_ai/handlers/create_property.py - Health check
backend/src/aqari_ai/handlers/health.py
Property domain
- Property draft model
backend/src/aqari_ai/models/property.py - Verified context
backend/src/aqari_ai/services/validation_service.py
Draft storage
- Draft persistence
backend/src/aqari_ai/services/dynamodb_service.py - DynamoDB
Planned listing workflow
- Private photos
backend/src/aqari_ai - Amazon S3
- Listing generation
backend/src/aqari_ai/prompts/listing_generation_v1.txt - Amazon Bedrock
- Draft content package
backend/src/aqari_ai - Human review
- Joomla export
backend/src/aqari_ai - Social drafts
backend/src/aqari_ai
Other components
- Authorized agent
Connections 15
- Authorized agent → API Gateway: submits facts
README.md - API Gateway → Create draft: routes request
README.md - Create draft → Property draft model: validates payload
backend/src/aqari_ai/handlers/create_property.py - Create draft → Verified context: builds context
backend/src/aqari_ai/handlers/create_property.py - Verified context → Property draft model: reads fields
backend/src/aqari_ai/services/validation_service.py - Create draft → Draft persistence: writes draft
backend/src/aqari_ai/handlers/create_property.py - Draft persistence → DynamoDB: stores item
backend/src/aqari_ai/services/dynamodb_service.py - Authorized agent → Health check: checks service
README.md - Private photos → Amazon S3: stores originals
README.md - Verified context → Listing generation: supplies verified facts
README.md - Listing generation → Amazon Bedrock: generates text
README.md - Amazon Bedrock → Draft content package: returns drafts
README.md - Draft content package → Human review: requires approval
README.md - Human review → Joomla export: approves export
README.md - Draft content package → Social drafts: produces drafts
README.md