Skip to content

Feature/doc enhancement#28

Merged
Zalfsten merged 29 commits into
mainfrom
feature/doc_enhancement
Apr 8, 2026
Merged

Feature/doc enhancement#28
Zalfsten merged 29 commits into
mainfrom
feature/doc_enhancement

Conversation

@Zalfsten
Copy link
Copy Markdown
Contributor

@Zalfsten Zalfsten commented Apr 8, 2026

No description provided.

Zalfsten added 13 commits April 1, 2026 16:35
…ates

- Added demo Docker Compose files for local testing with mock API
- Updated README and AGENTS.md for clarity on demo usage
- Introduced start-demo.sh and start-dev.sh scripts for easier environment setup
- Modified configuration files for demo and development modes
- Added demo SQL initialization script and mock API implementation
- Updated .gitignore to exclude demo output directory
…ship management; update dependencies in pyproject.toml and uv.lock
…and updating start-demo.sh for improved container management and cleanup
… example configurations, and improved environment setup for better usability
…or handling; clarify function docstrings for better understanding and maintainability.
… functionality and updating architecture rules documentation for clarity and structure
@gitguardian
Copy link
Copy Markdown

gitguardian Bot commented Apr 8, 2026

⚠️ GitGuardian has uncovered 2 secrets following the scan of your pull request.

Please consider investigating the findings and remediating the incidents. Failure to do so may lead to compromising the associated services or software components.

🔎 Detected hardcoded secrets in your pull request
GitGuardian id GitGuardian status Secret Commit Filename
26698938 Triggered Generic Password 6bb3825 dev_environment/start-demo.sh View secret
26698938 Triggered Generic Password e1df71c dev_environment/compose.demo.yaml View secret
🛠 Guidelines to remediate hardcoded secrets
  1. Understand the implications of revoking this secret by investigating where it is used in your code.
  2. Replace and store your secrets safely. Learn here the best practices.
  3. Revoke and rotate these secrets.
  4. If possible, rewrite git history. Rewriting git history is not a trivial act. You might completely break other contributing developers' workflow and you risk accidentally deleting legitimate data.

To avoid such incidents in the future consider


🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.

Comment thread dev_environment/demo_api_main.py Dismissed
Comment thread dev_environment/demo_api_main.py Dismissed
Comment thread dev_environment/demo_api_main.py Dismissed
Comment thread dev_environment/demo_api_main.py Dismissed
Comment thread dev_environment/demo_api_main.py Fixed
Comment thread dev_environment/demo_api_main.py Fixed
Comment thread dev_environment/demo_api_main.py Dismissed
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a local demo environment for the SQL-to-ARC converter, including a mock API, sample data, and updated startup scripts. It also features a significant documentation overhaul, translating architectural designs to English and establishing formal architecture rules, while adding extensive docstrings to the core processing logic. Feedback identifies a path traversal vulnerability in the mock API, synchronization and efficiency issues in the Docker Compose configuration, and minor encoding artifacts in the documentation.

Comment thread dev_environment/demo_api_main.py Outdated
Comment thread AGENTS.md Outdated
Comment thread dev_environment/compose.demo.yaml Outdated
Comment thread dev_environment/compose.demo.yaml Outdated
Zalfsten and others added 3 commits April 8, 2026 14:54
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Comment thread dev_environment/demo_api_main.py Fixed
Comment thread dev_environment/demo_api_main.py Fixed
Zalfsten and others added 4 commits April 8, 2026 13:00
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Comment thread dev_environment/demo_api_main.py Fixed
Zalfsten and others added 3 commits April 8, 2026 15:05
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Comment thread dev_environment/demo_api_main.py Fixed
Comment thread dev_environment/demo_api_main.py Fixed
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
Zalfsten and others added 3 commits April 8, 2026 15:15
…ed in path expression'

Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com>
@Zalfsten
Copy link
Copy Markdown
Contributor Author

Zalfsten commented Apr 8, 2026

/gemini review

Comment thread dev_environment/demo_api_main.py Fixed
Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a comprehensive local demo environment, including a mock Middleware API, sample SQL data, and dedicated Docker Compose configurations. It also renames several development scripts and configuration files for clarity, adds architectural documentation and binding rules, and significantly expands the project's READMEs. In the code, extensive documentation and comments were added to the database and processor modules to explain the orchestration and backpressure logic. A review comment suggests upgrading the log level for missing database views from a warning to an error to prevent silent configuration failures in production.

Comment thread middleware/sql_to_arc/src/middleware/sql_to_arc/database.py
@Zalfsten Zalfsten merged commit 2dbad32 into main Apr 8, 2026
8 checks passed
@Zalfsten Zalfsten deleted the feature/doc_enhancement branch April 8, 2026 14:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants