{"id":51466364,"url":"https://github.com/undertakehq/evaluator","last_synced_at":"2026-07-06T11:32:03.701Z","repository":{"id":301234585,"uuid":"554255227","full_name":"undertakehq/evaluator","owner":"undertakehq","description":"Stock Asset Evaluator app","archived":false,"fork":false,"pushed_at":"2025-10-29T02:18:08.000Z","size":55,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-29T04:11:13.622Z","etag":null,"topics":["gplv3","hacktoberfest","hacktoberfest-accepted","hacktoberfest2025","rails","ruby","stock-market"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/undertakehq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-10-19T14:02:59.000Z","updated_at":"2025-10-29T02:18:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"65fbf183-2d88-455a-aeb4-85a50c7078d1","html_url":"https://github.com/undertakehq/evaluator","commit_stats":null,"previous_names":["undertakehq/evaluator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/undertakehq/evaluator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undertakehq%2Fevaluator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undertakehq%2Fevaluator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undertakehq%2Fevaluator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undertakehq%2Fevaluator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/undertakehq","download_url":"https://codeload.github.com/undertakehq/evaluator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/undertakehq%2Fevaluator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35189713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-06T02:00:07.184Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gplv3","hacktoberfest","hacktoberfest-accepted","hacktoberfest2025","rails","ruby","stock-market"],"created_at":"2026-07-06T11:32:03.607Z","updated_at":"2026-07-06T11:32:03.689Z","avatar_url":"https://github.com/undertakehq.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stock Market Asset Evaluator\n\nThis Rails application powers effort to evaluate stock market assets. The initial scope targets Brazilian Real Estate Investment Funds (FIIs), delivering insights comparable to U.S. REIT analysis by aggregating and processing open financial data.\n\n## Project Objectives\n- Collect and normalize open datasets relevant to FIIs (e.g., fund reports, exchange filings).\n- Compute actionable indicators that highlight portfolio quality, income stability, and market positioning.\n- Surface comparisons and alerts that help investors monitor multiple FIIs with minimal manual effort.\n\n## Current Status \u0026 Roadmap\n- ✅ Rails 8 foundation with PostgreSQL and RSpec test stack.\n- 🚧 Data ingestion pipelines for FIIs from public sources.\n- 🚀 Next up: expose evaluation metrics via API endpoints and dashboard views.\n\n## Getting Started\n1. Ensure Ruby 3.3.4, Bundler, and PostgreSQL are available locally (or run Postgres via `docker-compose up db`). Rails 8.0.1 is pinned in the Gemfile.\n2. Install dependencies and prepare the database:\n   ```sh\n   bin/setup\n   ```\n3. Start the application:\n   ```sh\n   bin/rails server\n   ```\n4. Visit `http://localhost:3000` to confirm the app boots.\n\n## Key Commands\n- `bin/rails db:prepare` – synchronize the database schema for development or test.\n- `bundle exec rspec` – execute the test suite.\n- `bin/rails console` – open an interactive console for debugging calculations.\n- `bin/rails log:clear tmp:clear` – remove noise before capturing logs for investigation.\n\n## Directory Layout\n- `app/` – Rails MVC code, plus jobs, mailers, channels, and front-end assets.\n- `lib/` – shared modules that support data ingestion and evaluation logic.\n- `spec/` – RSpec test suite mirroring the application structure.\n- `config/` – environment configuration, credentials, and routing.\n- `db/` – migrations and seeds; persistent Postgres volume configuration in `docker-compose.yaml`.\n\n## Contributing\nKeep changes focused on expanding the evaluator’s coverage and accuracy. Document new data sources or metrics in the README (or dedicated `docs/` notes) so future contributors understand their intent. Run `bundle exec rspec` before opening a pull request and highlight migrations, configs, or external dependencies in the PR description.\n\n### Versioning \u0026 Commit Messages\n- Tag releases using [Semantic Versioning](https://semver.org/) (`MAJOR.MINOR.PATCH`), and increment versions according to the impact of your changes.\n- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit messages. Examples:\n  - `feat: add fii cashflow parser`\n  - `fix: correct dividend yield rounding`\n  - `chore(release): 1.2.0`\n- Reference issues in commit messages where relevant, e.g., `feat: integrate infomoney source (#42)`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundertakehq%2Fevaluator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fundertakehq%2Fevaluator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fundertakehq%2Fevaluator/lists"}