Amathus reads Cyprus RSS news feeds in Turkish, Greek, and English, transforms them into a common feed format, and exposes them behind a Web API with a cross-platform Flutter client (Web, iOS, Android, macOS).
- Backend (
Amathus/): Written in C# 14 / ASP.NET Core (.NET 10.0) and deployed as 3 Cloud Run microservices (amathus-reader,amathus-converter,amathus-web) on Google Cloud (events-atamel). - Frontend (
AmathusClient/): Written in Flutter 3.41 / Dart 3.11 (Material 3) and deployed as a Cloud Run web application (amathus-client).
Amathus.Reader(amathus-reader): Invoked every hour (0 * * * *) by Cloud Scheduler (amathus-reader-job). Fetches the 34 active RSS feeds configured inAmathus/Shared/amathussources.jsonin parallel and uploads raw XML feeds to Cloud Storage (gs://amathus-events-atamel-bucket).Amathus.Converter(amathus-converter): Triggered by Pub/Sub push notifications (amathus-events-atamel-topic) on Cloud StorageOBJECT_FINALIZEevents. Parses and cleans the raw feeds into normalizedFeed/FeedItemdocuments, stores them in Firestore (feedscollection), and analyzes all feeds to generate the dailyNewsOverview(top stories with narratives in English, Turkish, and Greek plus links to reporting newspapers) in Firestore (overviewscollection).Amathus.Web(amathus-web): Public REST API serving/api/v1/overview,/api/v1/feeds,/api/v1/feeditems,/api/v1/feeditems/{id},/api/v1/translate(powered by Google Cloud Translation API V2translate.googleapis.com), and/api/v1/imageproxy?url=...(CORS-enabled image proxy for Flutter Web).AmathusClient(amathus-client): Flutter client for Web, iOS, Android, and macOS.
From the Amathus directory:
dotnet test Amathus.slnIn Development mode (appsettings.Development.json), Amathus.Web uses InMemory storage and automatically runs a background FeedReaderService that fetches and converts all 34 RSS feeds on startup without requiring Google Cloud credentials:
cd Amathus/Amathus.Web
dotnet run --environment Development --urls http://localhost:5002Test the local API endpoints:
curl http://localhost:5002/api/v1/feeds
curl "http://localhost:5002/api/v1/feeditems?limit=10"
curl http://localhost:5002/api/v1/feeditems/kibrisgazetesiFrom the Amathus folder:
docker build -t amathus-web -f Amathus.Web/Dockerfile .
docker run -p 8080:8080 amathus-webMake sure gcloud is authenticated and inside the Amathus folder (scripts/config defaults to PROJECT_ID=events-atamel and REGION=europe-west1).
./scripts/enable./scripts/build reader
./scripts/deploy reader publicSet up the Cloud Storage bucket (gs://amathus-events-atamel-bucket) and Cloud Scheduler job (amathus-reader-job):
./scripts/setup_reader./scripts/build converter
./scripts/deploy converter publicSet up the Pub/Sub topic (amathus-events-atamel-topic), Cloud Storage bucket notification, and push subscription (amathus-events-atamel-topic-subscription):
./scripts/setup_converter./scripts/build web
./scripts/deploy web publicRun the automated test script to trigger amathus-reader, test amathus-converter, and verify amathus-web endpoints:
./scripts/test_servicesSee AmathusClient/README.md for local development, testing, and Cloud Run web deployment instructions.
