APPS
Viindoo AI - Workflow & Heartbeat Routines 17.0

Viindoo AI - Workflow & Heartbeat Routines

by Viindoo Technology JSC

4.9

$ 490.53 $ 490.53

v 17.0 0

Lines of Code	1440
Technical name	viin_ai_workflow
License	OPL-1
Website	https://viindoo.com/apps/app/17.0/viin_ai_workflow
Read description for
Required Apps	Discuss (mail) Employees (hr)
Included Dependencies	Approvals Viindoo AI - Assistants & Automation Viindoo AI Viindoo AI - Knowledge Retrieval (RAG) Viindoo AI - Operating Layer Viindoo AI - Approval Adapter Viindoo Base OmniApproval™: One platform. Every approval. Advanced HR Management API Request Logger Safe IR Metadata Proxies
Extensions	Viindoo AI - Pulse Cost Gate Viindoo AI - Workflow Automation Bridge

Description
License

Viindoo AI - Workflow & Heartbeat Routines (P-OPS-3, base)

The Community-functional base of the P-OPS-3 operating-layer adapter. It ships the recurring heartbeat routines that let the AI operate a controlled cadence ("AI điều hành doanh nghiệp, không chỉ chat") instead of only reacting to chat.

Key model

AI Work Routine (viin.ai.work.routine) - the heartbeat carrier. One record per built-in routine. Each routine scans a target model with a safe_eval domain on a cadence, runs an analytical agent, and (where a side-effect is warranted) creates a governed viin.ai.action.proposal.

Shipped routines (config data, `noupdate="1"`)

ar_overdue_review_daily - overdue unpaid customer invoices (daily).
stock_anomaly_daily - negative on-hand quantity at internal locations (daily).
cashflow_summary_weekly - net in/out window digest (weekly, digest-only).
dunning_weekly - overdue AR, side-effecting: drafts a governed proposal routed through approval (weekly, generic - VN-specific wording is a future localization concern).

Scheduled Agent UI (Phase 7.2)

Prompt template (messages_template) - an admin-authored prompt rendered via the sandboxed mail.render.mixin inline_template engine (never raw Jinja/eval); empty is byte-identical to the hard-coded default.
Cron-builder UX - a read-only next_run_preview and a generic "Run Now" button (action_run_now) over the single shared heartbeat cron - no per-routine ir.cron is ever created.
Cost-cap gate - a scheduled run never bypasses the run principal's daily cost cap; over-cap is a graceful skip, not a failure.
Failure alerting - consecutive_failure_count / last_error and a throttled bus.bus alert to base.group_system once viin_ai_workflow.routine_failure_alert_threshold consecutive failures are reached.
Generic proposal mode (proposal_mode) - a data-driven, per-routine switch between digest-only and side-effecting (drafts a governed proposal), with zero per-routine Python override required.

Routine runner discipline

The routine ir.cron relies on the ir.cron row lock for non-concurrency (NO manual cr.commit); each routine runs inside its own cr.savepoint() so one routine's failure never poisons the others. Each routine runs with_company(routine.company_id) so company-scoped provider / BYOK key resolution is correct in a multi-company database.

Community vs Enterprise

This base module runs everywhere. The Enterprise-only workflow.instance orchestration (multi-step / retry / escalation) lives in the separate auto_install bridge viin_ai_workflow_automation; nothing here references any workflow.* symbol, so the base installs cleanly on Community.

Supported Editions

Community Edition
Enterprise Edition

This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file).

You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one).

It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software.

The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.