Why XyrisPM?
The problem it solves — for each role

XyrisPM is Xyris Digital Solutions' internal project management dashboard. It connects live to Odoo and gives each team member exactly the view they need — nothing more, nothing less.

Before XyrisPM

The GM had to message the PM or wait for a weekly update to know if a project was on track. There was no single place to see all projects at once.

Project Managers tracked tasks in WhatsApp groups, spreadsheets, or memory. There was no visual timeline or board tied to real Odoo projects.

Admin had no way to quickly generate implementation plans or control who could see sensitive project data.

After XyrisPM

GM: Open one link, see all projects live. No need to ask anyone for a status update.
📅
Project Manager: Plan tasks on a visual timeline, move cards on a kanban board, filter by project or blocker.
Admin: Control who gets access, generate full implementation plans in seconds, and see the complete picture.
Logging In
Same credentials you use for Odoo — no new password to remember
User Story"I want to open XyrisPM and get in quickly without setting up a new account."
1
Open the appGo to the XyrisPM link shared by your admin. You'll see the login screen.
2
Enter your Odoo email and passwordUse the same email and password you use to log into Odoo (erp.xyrisdigital.com).
3
Click "Connect to Odoo"The app checks your credentials and your assigned role. If you have access, you'll be taken straight to your dashboard.
Screenshot: Login screen with email/password fields
If you see "Access denied", your account hasn't been assigned a role yet. Contact your admin to get access.

Once logged in, you'll see your name and role badge in the top-right corner. The views available to you depend on your role — the tabs you see are exactly what you have access to.

GM Walkthrough
Portfolio visibility · Read-only · No tasks to manage
User Story"As a GM, I want to check the health of all active projects in one place, so I can ask the right questions in the right meetings — without chasing anyone for updates."

When you log in as GM, you land directly on the GM Portfolio view. This is your only view — it shows everything you need to know about the current state of all Xyris projects.


The Portfolio View

Screenshot: GM Portfolio with stats cards and project table

At the top, you'll see 5 summary cards:

📊
Portfolio — Total number of active projects tagged as "PM" in Odoo.
On Track — How many projects are healthy right now.
At Risk — Projects that need your attention.
💰
Total Budget — Combined budget across all projects (entered manually by the PM/Admin).
📈
Revenue — Total collected revenue across the portfolio.

Below the cards is the Live Portfolio table — one row per project, pulling live data from Odoo every time you open this view.


Reading Project Status

Each project has a Status column. Here's what each means:

On Track At Risk Delayed On Hold Completed

The Position Notes column (last column) gives you the reason — written by the PM or Admin. For example: "Client delayed UAT sign-off" or "Custom dev completed, waiting on data migration."

💡
If you want a refreshed view of the latest data, click the ↺ Refresh button at the top right of the table. The timestamp next to "Live Portfolio" shows when the data was last fetched.

Understanding the Financials

The table shows Budget, Revenue, Costs, and Margin for each project. These numbers are entered manually by the Admin or PM — they're not automatically pulled from Odoo invoices (that's a future phase).

The Margin % column is calculated automatically: (Revenue − Costs) ÷ Revenue.

As a GM, you can read financials but not edit them. If a number looks wrong, ask the Admin to update it.
📅
Project Manager Walkthrough
Timeline · Kanban · Task management · GM View access
User Story"As a PM, I want to plan my project tasks visually and track what's done, in progress, or blocked — so I can stay on top of every project without losing things in WhatsApp."

As a Project Manager, you have access to 3 views: GM View (to read the portfolio), Timeline, and Kanban. Your main workspace is the Timeline and Kanban.


Timeline (Gantt View)

Screenshot: Timeline view with colored task bars per project

The Timeline is your bird's-eye view of all tasks across all projects. Each task appears as a colored bar spanning its start and end date.

What the bar colors mean:

Blue — Regular task, in progress or upcoming.
Green — Task is done.
Orange — Custom development task (at risk).
Red — Task is blocked.

The red vertical line across the timeline is today. Anything to the left of it should be done or in progress.

On the left panel, you can click a task name to open and edit it. The small checkbox next to each task lets you quickly mark it done.

💡
Click a project name in the left sidebar to filter the Timeline to just that project's tasks.

Kanban Board

Screenshot: Kanban board with 4 columns

The Kanban board shows all tasks organized into 4 columns:

1
To Do — Tasks that haven't started yet.
2
In Progress — Currently being worked on.
3
Blocked — Stuck — waiting on a client, a decision, or another task.
4
Done — Completed tasks.

Each card shows the task name, which project it belongs to (color-coded), the type (Config, Custom Dev, Training, Testing), assigned person, and hours logged.

Click any card to open and edit it. To move a task between columns, open it and change the Status field.


Adding and Managing Tasks

Screenshot: Task modal with all fields

To add a task, click the + Task button in the top-right corner of the Timeline or Kanban view.

Fill in:

·
Task Name — What needs to be done.
·
Project — Which Odoo project this belongs to.
·
Type — Config, Custom Dev, Training, or Testing.
·
Start & End Date — When it should happen.
·
Est. Hours / Actual Hours — Track effort over time.
·
Assignee — Who's responsible.
·
Status — To Do, In Progress, Blocked, or Done.
·
Notes — Any extra context, blockers, or instructions.
Tasks are saved locally in your browser. They stay between sessions but are specific to this device. If you switch computers, you'll start fresh. Cloud sync for tasks is coming in a future version.
Admin Walkthrough
Full access · User management · Plan Generator · Financials editing
User Story"As an Admin, I want to control who can see what, keep project financials up to date, and generate implementation plans fast — so the team always has the right information."

As Admin, you have access to everything: GM View, Timeline, Kanban, Plan Generator, and the Admin Panel. You're responsible for keeping the system accurate and running.


Managing User Roles

Screenshot: Admin Panel → User Roles table

Go to Admin tab → User Roles. Here you see everyone who has access to XyrisPM and what they can do.

To add a new user:

1
Click "+ Add User"
2
Enter their Odoo email address — must match exactly what they use to log into Odoo.
3
Select their role — GM, Project Manager, or Admin.
4
Click Save — they can now log in immediately.

To remove someone's access, click the Remove button next to their name. They won't be able to log in after that.

Only give the Admin role to people who should be able to add/remove other users and see all financials. When in doubt, use Project Manager.

Editing Project Financials & Status

Screenshot: GM Portfolio table with Edit button → Financials modal

Go to GM View. On each project row, click the Edit button on the right.

You can update:

·
Budget, Revenue, Costs — in EGP. Margin is calculated automatically.
·
Status — On Track, At Risk, Delayed, On Hold, or Completed.
·
Position Notes — A short explanation of why the project is in this position. The GM reads this.

Click Save — the data is stored in Supabase and the GM will see the updated values immediately on their next refresh.


Plan Generator

Screenshot: Plan Generator with modules selected and output
User Story"I need to send a client a project plan quickly. Instead of building it from scratch in Word, I fill in a form and get a full phased plan in seconds."

Go to the Plan Generator tab. Fill in:

1
Client Name & Industry
2
Start Date & Odoo Version
3
Custom Development level — None, Minor, Moderate, or Heavy. This adds extra weeks automatically.
4
Select modules — click each Odoo module in scope (e.g. Sales, Inventory, Accounting). Each one adds its estimated implementation time.
5
Special Requirements — any extras like ETA e-invoicing, data migration, multi-branch, KSA payroll.
6
Click "⚡ Generate Plan"

The plan appears below with a full phase breakdown: Requirements, Configuration, UAT, Go-Live — each with tasks, deliverables, gate conditions, and estimated hours. Click Copy to paste it into a proposal or email.

Quick Reference
Status meanings, role comparison, common questions

Project Status Guide

On Track At Risk Delayed On Hold Completed
StatusWhat it meansWho should act
On TrackEverything going as plannedNo action needed
At RiskSomething could cause a delay if not addressed soonPM to update notes, GM to follow up
DelayedProject is behind the original timelinePM to explain in Position Notes, GM to discuss
On HoldPaused — client-side or internal decisionAdmin to update when it resumes
CompletedProject fully delivered and closedAdmin to mark as complete

Who Can Do What

FeatureGMProject ManagerAdmin
View GM Portfolio
See financials (Budget/Revenue/Costs)
Edit financials & status
Timeline (Gantt)
Kanban board
Add / edit tasks
Plan Generator
Add / remove users

Common Questions

The projects in the sidebar look wrong — I see too many or too few.

XyrisPM only shows projects that have the "PM" tag in Odoo. If a project is missing, ask the Admin to add the PM tag to it in Odoo. If an old/cancelled project is showing, remove the PM tag from it in Odoo.

I added a task but it disappeared when I came back.

Tasks are stored in your browser's local storage. Clearing your browser data will delete them. Also, tasks are device-specific — they won't appear on another computer. Cloud sync is coming in a future version.

The financials show "—" for all projects.

Financials are entered manually. Ask the Admin to fill in the Budget, Revenue, and Costs for each project in the GM View → Edit button.

I can't log in even though my Odoo password is correct.

Your Odoo credentials are correct but your account hasn't been added to XyrisPM yet. Contact the Admin with your email address to be given a role.


XyrisPM · by Ali Essam Abdrabou · A.E.A. · Xyris Digital Solutions