User Guide Uporabniški priročnik

🆕 What's New in v1.114 — June 2026

This version makes InterventionLogic fully multilingual: the entire interface, the AI generation and the whole project can run in 8 languages (English, Slovenian, German, French, Italian, Spanish, Croatian, Greek). Translation is now smarter, faster and works between any two languages. All changes are backwards-compatible — existing projects automatically benefit.

1. Registration & Login

1.1 Registration

1. Open your browser and navigate to https://interventionlogic.eu
2. Click "Register here" at the bottom of the login form
3. Fill in: First Name, Last Name, E-mail Address, Organisation Name, Password (min. 8 characters — must include uppercase, lowercase, number, symbol), Confirm Password
4. Click "Register"
5. Check your email inbox for a confirmation email and click the activation link
6. Return to https://interventionlogic.eu and log in with your credentials

1.2 Login

1. Enter your E-mail Address and Password
2. Click "Login"
3. If 2FA is enabled, enter the 6-digit verification code from your authenticator app
4. You will be taken to the Home Screen with your project list

1.3 Language Selection

In the top-right corner, click SI or EN to switch the interface and AI generation language. The active language is highlighted in blue. This language also controls which language the AI generates content in.

2. Application Overview

2.1 Main Layout

Area	Position	Purpose
Sidebar	Left	Navigation menu with all project chapters and sub-sections
Editor	Centre	Main workspace for viewing and editing project content
Dashboard	Right	Statistical overview with auto-generated charts (collapsible)

2.2 Sidebar Navigation — Intervention Logic Framework

The sidebar follows the Intervention Logic Framework — the structured cause-and-effect chain from problem to impact that is the backbone of every EU project proposal:

Chapter	Section	Description
Ch.1	Problem Analysis	Core problem, causes, consequences
Ch.2	Project Idea	Title, acronym, aim, state of the art, solution, policies, readiness
Ch.3-4	Objectives	General objectives & specific S.M.A.R.T. objectives
Ch.5	Activities	Work packages, project management, risks, partnership, finance
Ch.6	Expected Results	Outputs, outcomes, impacts, KERs

3. AI Configuration & Settings

3.1 Setting Up Your AI Provider

1. Click the Settings gear icon (⚙) in the top-right corner
2. Select your AI Provider:
   Recommended Gemini (Google) — generous free tier, fast, web search supported
   Alternative OpenRouter — multiple models, web search supported
   Alternative OpenAI — GPT models, paid key, no web search
3. Paste your API Key
4. Select the Primary Model (e.g., gemini-2.5-flash-lite)
5. Optionally select a Secondary Model as fallback NEW
6. Click "Save"

3.2 Getting a Free Gemini API Key

1. Go to https://aistudio.google.com/apikey
2. Sign in with your Google account
3. Click "Create API Key"
4. Copy the key and paste it into InterventionLogic Settings

3.3 Web Search for Evidence NEW

When enabled, the AI will actively search the internet for current data, statistics, citations and sources while generating content. This ensures your proposal contains up-to-date, verifiable information.

1. In Settings, find the "Web Search for Evidence" section
2. Toggle the checkbox to ON
3. Click "Save"

Provider	How Web Search Works
Gemini	Uses Google Search grounding — AI directly queries Google for real-time data
OpenRouter	Uses web plugin — AI searches the web via Exa for current sources
OpenAI	Not supported — use Gemini or OpenRouter for web search

4. Creating a Project

4.1 New Project

1. From the Home screen, click "+ New Project"
2. Enter a Project Title (working title — AI can refine it later)
3. Select Language: EN (English) or SI (Slovenian)
4. Set the Start Date and Duration in months (e.g., 24, 36)
5. Choose Funding Model: Centralized or Decentralized
6. Click "Create"

4.2 Project List Actions

Action	Description
Open	Opens the project in the editor
Duplicate	Creates a complete copy of the project
Delete	Permanently removes the project (with confirmation)
QR Code	Generates a shareable QR code

5. AI Generation Modes

5.1 Section-Level Generation

At the top of each section, you will find three generation buttons:

5.2 Field-Level AI Assistant NEW

Every text field now has a dedicated AI Assistant button (✨ icon) that appears when you hover over the field, in the top-right corner. This opens a contextual popup where you can:

1. See the current field content — the popup shows what's already in the field
2. Enter specific instructions — tell the AI exactly what you want (e.g., "add ISO references", "make it more formal", "expand with examples from Western Balkans")
3. Generate / Regenerate — AI generates content using your instructions, field value, full project context, knowledge base, and all rules
4. Preview the result — review before accepting
5. Accept or Regenerate — accept to replace field content, or regenerate with modified instructions

5.3 Evidence-Based Content & Citations NEW

InterventionLogic enforces strict academic rigor in all generated content:

Rule	Description
Mandatory empirical data	Every analytical paragraph must contain at least one verified data point with source attribution
APA-style citations	Author surnames, publication year, at least 30% author-named citations
Zero-hallucination policy	AI is forbidden from fabricating sources, URLs, authors, or statistics
Source hierarchy	Local/regional data first, then Eurostat, OECD, EC, scientific publications

Real-time Collaboration NEW

InterventionLogic supports full real-time multi-user collaboration. Multiple team members can work on the same project simultaneously — you see each other's presence, cursors, and edits live.

Who is Online — Presence Avatars

Colored avatar circles appear next to each section header showing which team members are currently working in that section. Each user gets a unique color that stays consistent throughout the session.

Indicator	Where	What it shows
Colored dot + initials	Section header	User currently viewing or editing that section
Sidebar panel "Active now"	Left sidebar	All online users + the exact field each is editing
Field indicator	Inside text field	Colored bar shows another user is editing this field
Remote cursor	Inside text field	Live cursor position of another user (100ms update)

Live Co-editing

Text fields use Supabase Realtime broadcast — changes are synchronized across all connected users as you type. You can see exactly where in the text another user's cursor is positioned.

Inviting Collaborators

You can invite colleagues to collaborate on a specific project or to join your organisation.

1. Open a project and click the Share / Invite button in the top toolbar
2. Enter the collaborator's e-mail address
3. Choose the permission level: Editor (can edit) or Viewer (read-only)
4. Click "Send Invitation"
5. The invitee receives an email with a link to join. If they do not have an account, they will be prompted to register first.

Manage pending invitations via the Pending Invitations panel (accessible from the share button). You can cancel any unsent invitation at any time.

6. Problem Analysis

This is the foundation of your entire project. Every cause must later be addressed by an activity, and every consequence must connect to an impact.

6.1 Core Problem

Enter a concise Title and a detailed Description with quantitative evidence. Even a few sentences are enough — AI will expand and enrich with citations from real sources (Eurostat, OECD, European Commission, etc.).

6.2 Causes (minimum 4)

Click "+ Add Cause" or let AI generate them. Ordered from root/structural causes first to proximate causes second.

6.3 Consequences (minimum 4)

Click "+ Add Consequence" or let AI generate them. Show the escalation chain: local → regional → national → EU-level.

6.4 Inline Visualizations

After generation, a "Generate visualizations" button appears below descriptions with empirical data. Creates charts (bar, gauge, donut) that visualize statistics mentioned in the text.

7. Project Idea

This chapter translates the problem analysis into a proposed intervention.

7.1 Project Title & Acronym

Title: Concise noun phrase (30–200 characters). No acronym, no verb. Acronym: 3–8 uppercase letters (e.g., GREENTRANS, DIGI-CRAFT).

7.2 Main Aim

One sentence starting with an infinitive verb capturing the project's core purpose.

7.3 State of the Art

AI references at least 3 real EU projects/studies, describing synergies and capitalisation.

7.4 Proposed Solution

Introductory overview, phase-by-phase breakdown, and mandatory DNSH compliance statement.

7.5 EU Policies

At least 3 relevant EU policies with verifiable references.

7.6 Readiness Levels

Level	Full Name	Measures
TRL	Technology Readiness Level	Technology maturity
SRL	Societal Readiness Level	Social acceptance
ORL	Organisational Readiness Level	Institutional capacity
LRL	Legislative Readiness Level	Regulatory alignment

8. Objectives

8.1 General Objectives (3–5)

Each starts with an infinitive verb, connects to broader EU goals. Title, description, KPI indicator.

8.2 Specific Objectives (5–7)

Follow S.M.A.R.T.: Specific, Measurable, Achievable, Relevant, Time-bound. Each has a measurable KPI with targets, baselines, timeframes.

9. Activities (Work Packages)

The most complex section. AI generates the full work plan in two phases.

9.1 Work Package Structure

Position	WP Type	Duration
WP1	Foundational / Analytical (incl. Capitalisation)	Specific phase
WP2–WP(N-2)	Content / Thematic WPs	Sequential with overlaps
WP(N-1)	Dissemination, Communication & Exploitation	Full duration
WP(N)	Project Management & Coordination	Full duration

9.2 Each WP Contains

Tasks (2–5) with dependencies (FS, SS, FF, SF). Milestones (1–2). Deliverables (1–3) with binary verifiable indicators.

9.3 Two-Phase Generation

1. Phase 1 — Scaffold: WP titles and date ranges
2. Phase 2 — Detail: Each WP with tasks, milestones, deliverables, cross-WP dependencies

Takes 1–3 minutes for 6–10 WPs — this is normal.

10. Project Management

10.1 Management Description

AI generates a comprehensive narrative (500+ words) covering: governance structure, decision-making, quality assurance (Gender Equality Plans, AI Act/GDPR), risk management, communication tools, conflict resolution, FAIR data management.

10.2 Organigram Labels

Role	EU Abbr.	Label
Coordinator	PK	"Project Coordinator (PK)"
Steering Committee	UO	"Steering Committee (UO)"
Advisory Board	SO	"Advisory Board (SO)"
WP Leaders	VDS	"WP Leaders (VDS)"

11. Risk Register

AI generates 8–12 risks across four categories:

Category	Examples
Technical	Technology failures, integration issues, data quality
Social	Stakeholder resistance, low engagement, cultural barriers
Economic	Budget overruns, market changes, partner instability
Environmental	Climate events, regulatory changes, environmental compliance

Each risk: auto-generated ID, category, title, description, likelihood, impact, mitigation strategy.

12. Expected Results & KERs

12.1 Outputs (5–8)

Direct, tangible deliverables with result-oriented titles and binary verifiable indicators.

12.2 Outcomes (4–6)

Medium-term changes with measurable indicators, targets, and measurement methods.

12.3 Impacts (3–5)

Long-term strategic shifts in Key Impact Pathways: Scientific, Societal, Economic.

12.4 Key Exploitable Results (4–6)

Assets with exploitation strategies covering 3 sustainability pillars: Financial, Institutional, Political/Regulatory.

References (Chapter 7) NEW

The References chapter is the seventh and final content step. It provides a full academic citation management system — citations are automatically extracted from the AI-generated content and can be manually enriched, verified, and re-ordered.

How References Are Generated

When AI generates analytical content (Problem Analysis, Project Idea, State of the Art, Objectives, Expected Results), it embeds inline citation markers [1], [2] etc. in the text. The References engine then:

1. Extracts all embedded citations from all sections
2. Looks up each citation via CrossRef DOI lookup, OpenAlex, and Google Scholar
3. Verifies that authors, titles and years are real (hallucination filter)
4. Populates the References chapter with verified, formatted entries
5. Marks unverifiable citations so you can review or remove them

Citation Types

Type	Required Fields
Journal Article	Authors, Title, Journal, Year, Volume, Issue, DOI
Book	Authors, Title, Publisher, Year, ISBN
Conference Paper	Authors, Title, Conference Name, Year, Pages, DOI
Report	Authors/Organisation, Title, Publisher, Year, URL
Website	Title, Organisation, URL, Access Date
Thesis	Author, Title, University, Year, Type
Other	Free-form entry

Managing References

Action	How
Add manually	Click "+ Add Reference" and select the citation type
Edit fields	Click any reference to expand it and edit fields inline
Verify URL	Click the verification icon to check if the source URL is live
Reorder	Drag references to change their numbering (affects inline markers)
Delete	Click the × button — the inline marker in the text is automatically updated
Regenerate	AI re-extracts and re-verifies all citations from the current content

13. Partnership (Consortium)

Field	Description
Code	CO (coordinator), P2, P3, P4, etc.
Name	Organisation TYPE description — never real names
Partner Type	Dropdown: faculty, researchInstitute, sme, publicAgency, ngo, etc.
Expertise	What this partner brings and which WPs they contribute to
PM Rate	Person-month cost rate in EUR (2,500–7,000)

Click Regenerate for a balanced consortium. Click "+ Add Partner" to add manually.

14. Finance (Budget Allocation)

14.1 Cost Category Configuration NEW

Before generating allocations, configure which cost categories are active for your project. This two-panel modal controls what the AI budgets and what columns appear in the breakdown table.

1. Click "⚙ Cost Category Configuration" at the top of the Finance section
2. Left panel — Direct cost categories: Enable/disable which categories apply to your project
3. Right panel — Indirect costs: Set the flat-rate percentage and choose which direct categories it applies to
4. Optionally set custom labels for categories (e.g. rename "Materials" to "Consumables")
5. Click "Save" — your configuration is remembered for all future AI generations

Cost Categories by Funding Model

Indirect Cost (Flat Rate) Settings

Configure how overhead/indirect costs are calculated in the right panel of the Cost Configuration modal:

Setting	Description
Flat rate %	Percentage applied to selected direct costs (e.g. 7%, 15%, 25%)
Base categories	Which direct cost categories the % is applied to (checkboxes)
Result	Indirect cost = Sum of selected base × flat rate %. Auto-calculated in every row of the breakdown table.

14.2 AI-Generated Allocations

Click "🤖 Generate Partner Allocations with AI" to let the AI distribute partners across all tasks with realistic hours, person-months, and costs that follow EU budget rules. The AI applies task-type-specific rules (e.g. Labour ≥ 60% of direct costs) and respects your cost category configuration.

1. Complete Cost Category Configuration first (step 14.1 above)
2. Click "🤖 Generate Partner Allocations with AI"
3. Review results in the table below and adjust manually if needed

14.3 EU Budget Rules

Total Budget	Max % for Project Management WP
up to 500,000 EUR	15%
500,001 – 1,000,000	10%
1,000,001 – 3,000,000	10%
3,000,001 – 5,000,000	7%
over 5,000,000	5–7%

Dissemination WP ≈ 15%. Remaining budget distributed proportionally across content WPs. All values can be manually adjusted after generation.

14.4 Per-Task Cost Breakdown Table NEW

Below the summary charts is a spreadsheet-style editable table — the most powerful way to manage your budget. It shows every partner allocation per task, grouped by Work Package.

Per-Task Cost Breakdown Table — editable inline with partner allocations

Column	Colour	Editable	Description
Partner	—	—	Partner code badge. Hover to show × remove button.
Hours	Sky blue	✅ Yes	Person-hours. Changing recalculates PM and Labour amount.
PM	Sky blue	✅ Yes	Person-months (1 PM = 143 h). Recalculates Hours and Labour.
Labour	Sky blue	✅ Yes	Labour cost = Hours × (PM Rate / 143). Recalculates Hours and PM.
Other categories	Indigo	✅ Yes	Travel, Materials, Equipment, etc. Edit inline.
Indirect	Amber	❌ Auto	Calculated automatically from Indirect Cost Settings %.
Total	—	❌ Auto	Direct + Indirect costs.

14.5 Adding and Removing Partners per Task NEW

You can directly manage which partners work on each task inside the cost breakdown table — without regenerating everything with AI.

Adding a Partner

1. Scroll to the task you want in the breakdown table
2. At the bottom of the task's rows, click the green "+ Add partner" button
3. A dropdown appears listing only partners not yet assigned to that task
4. Select a partner — they are immediately added with Hours = 0, PM = 0
5. Enter their hours, PM, or labour amount in the newly appeared row

Removing a Partner

1. Hover your mouse over the partner row you want to remove
2. A red ✕ button appears to the left of the partner badge
3. Click ✕ — the allocation is immediately removed

14.6 Filters

Use the Work Package and Partner dropdown filters at the top of the table to narrow the view. Useful for large projects with many WPs and partners.

15. Dashboard Panel

Click the Dashboard icon on the right side for a real-time visual overview. Auto-updates as you work.

Chart	Shows
Project Completion	Percentage of sections filled
Problem Tree	Causes → Core Problem → Consequences
Objectives Hierarchy	General → Specific objectives
Partner Distribution	Donut chart of partner types
Budget per WP/Partner	Bar charts of costs
Person-Months/Hours	Resource distribution

16. Gantt Chart, PERT Chart & Organigram

Found in the Activities chapter, the three visualization tabs give you a complete view of your project schedule and structure. Gantt and PERT are fully interactive — dates and dependencies can be edited directly on the diagram.

16.1 Gantt Chart — Drag & Drop Editing NEW

The Gantt chart is a fully interactive SVG timeline. Work packages are shown as section headers (dark bars), tasks as coloured bars, and milestones as black diamonds. Dependency arrows connect related tasks.

① Zoom selector  ② Full Project view  ③ Drag task bar  ④ Milestone

Action	How to do it	What changes
Move task	Click and drag the bar horizontally	Start Date and End Date both shift by the same number of days
Resize task	Drag the right edge of the bar (cursor changes to ⟺)	End Date only — start date stays fixed
Move milestone	Click and drag the diamond	Milestone date shifts
Navigate to task	Click the bar or diamond without dragging	Scrolls the Activities panel to that task and briefly highlights it

16.2 PERT Chart — Interactive Dependencies NEW

The PERT chart shows tasks as rectangular nodes connected by dependency arrows. You can navigate to any task by clicking its node, and in Connect Mode you can add or remove dependencies directly on the diagram.

① Connect Mode  ② Full Project  ③ Task nodes  ④ Legend

Click to navigate to a task

1. Make sure Connect Mode is OFF (button not amber)
2. Click any task node on the PERT diagram
3. The Activities panel scrolls to that task and briefly highlights it with a blue border

Adding a Dependency (Connect Mode)

1. Click the "🔗 Connect Mode" button in the PERT toolbar — it turns amber
2. An amber hint bar appears at the top: "Click a SOURCE task"
3. Click the predecessor (source) task node — it highlights with a yellow border and the hint changes to "Now click the TARGET"
4. Click the successor (target) task node
5. A popup appears — choose the dependency type:
   FS Finish-to-Start — most common: target starts after source finishes
   SS Start-to-Start — both start at the same time
   FF Finish-to-Finish — both finish at the same time
   SF Start-to-Finish — target finishes when source starts
6. The dependency is immediately saved and an arrow appears on the chart

Removing a Dependency

1. You do not need Connect Mode to delete a dependency
2. Hover your mouse over any dependency arrow on the chart
3. A red ✕ button appears at the midpoint of the arrow
4. Click ✕ — the dependency is immediately removed

16.3 Organigram

The organisational chart shows the consortium governance structure: Coordinator → Steering Committee → Advisory Board → WP Leaders → Partners. Generated automatically from Partnership data. Read-only — edit via the Partnership section.

① Coordinator & Steering Committee  ② WP Leaders (auto-generated from Activities)

17. Export & Print

17.1 DOCX Export

Click Export/Download → DOCX → professional Word document with all chapters, tables, headings.

17.2 Print Layout

Use Ctrl+P (or Cmd+P) for print-optimized layout with proper page breaks.

17.3 Project Summary

Click "Summary" for an AI-powered executive summary (max 800 words).

17.4 Finance Export to Excel (.xlsx) NEW

When you are in the Finance (Budget) section, a dedicated Excel export button appears in the top toolbar. Click it to download a structured .xlsx spreadsheet containing:

• All cost categories (Direct AI Costs, Staff, Travel, Equipment, etc.)
• Per-partner breakdowns with person-months and cost totals
• Flat-rate and overhead calculations
• EU budget compliance summary

18. Administration Panel

Available to organisation administrators only.

Feature	Description
User Management	View and manage users within your organisation
Knowledge Base	Upload PDFs/Word files as mandatory AI context
AI Instructions Override	Customize AI rules for any section
Global Instructions	Organisation-wide generation preferences
2FA Management	Configure Two-Factor Authentication
Changelog	View application version history with filtering
Logo & Branding NEW	Upload organisation logo and set custom app name — instantly visible to all users everywhere

18.1 Knowledge Base

1. Go to Admin Panel → Knowledge Base
2. Click "Upload Document"
3. Select a PDF or Word file (call text, programme guide, policy document)
4. The system extracts and stores text content
5. AI will automatically consider these documents when generating content

18.2 AI Instructions Override

Administrators can override: quality gates, task instructions, global rules, academic rigor, humanization rules. Click "Reset to defaults" to restore originals.

18.3 API Cost Tracking NEW

Every AI generation call is logged with token usage and cost. Administrators can monitor API spending per project and per section.

Tracked Item	Detail
Input tokens	Tokens sent to the model (prompt + context + knowledge base)
Output tokens	Tokens generated by the model (the response)
Cost (USD)	Calculated per model pricing table (Gemini, OpenAI, OpenRouter rates)
Per-chapter log	Stored in project data under _usage — visible in Admin Panel

19. Tips & Troubleshooting

19.1 Recommended Workflow

19.2 Common Issues

Issue	Solution
Missing API key	Go to Settings (⚙) and enter your API key
Rate limit error	Wait 1–2 minutes and try again; switch to secondary model if available
Generation takes long	Activities take 1–3 min for 6–10 WPs — normal
Charts not appearing	Click "Generate visualizations" after content generation
Cannot login	Check email for confirmation link; password requires 8+ chars with symbol, number, upper & lowercase
Web search not working	Ensure checkbox is ON in Settings; only Gemini & OpenRouter support web search
AI Assistant hidden	Hover over any text field — ✨ button appears top-right of the field
References show orange flags	Citation could not be verified — check the DOI/URL manually or remove it before submitting
Collaborator edits overwrite mine	Last save wins — coordinate via the "Active now" sidebar panel to avoid editing the same field simultaneously
Logo not showing	SuperAdmin must upload logo in Admin Panel → Organisation Settings; no fallback logo exists
Finance table empty after AI	Configure Cost Categories first (⚙ button) before running AI allocation

19.3 Keyboard Shortcuts

Shortcut	Action
Ctrl + P	Print / Print-optimized layout
Ctrl + Enter	Generate in AI Assistant popup NEW
Esc	Close modals and popups
Tab	Move between form fields

19.4 Supported Browsers

Google Chrome (recommended), Mozilla Firefox, Microsoft Edge, Safari.