# My Company — Social Hub Module

Odoo 17 module that provides a Facebook-style company culture hub as a first-class application.

## Features (v1)

| Area | What it does |
|------|----------------|
| **Centre feed** | Posts, images, comments, kudos, and pinned announcements |
| **Left panel** | Installed Odoo applications — click to leave the hub and open that app |
| **Right panel** | Colleagues with online status + one-click Discuss chat |
| **Startup page** | Per-user “Start with My Company” or company-wide default for new users |
| **Reminders** | Weekly cron nudge for users who have not posted recently |

## Install

1. Ensure `hr` is installed (used for departments/teams on announcements).
2. Update the app list and install **My Company** from Apps.
3. Open **My Company** from the app switcher.

## Set as startup page

**Per user:** Settings → Users → *Preferences* → **Set My Company as startup page**

**Company default:** Settings → My Company → enable **Default startup page for new users**

This sets the Odoo **Home Action** (`action_id` on `res.users`) to the hub client action.

## Layout

Facebook-style three-column hub:

| Column | Width | Content |
|--------|-------|---------|
| Left | ~20% | Your profile + Odoo applications |
| Centre | ~60% | Feed search, composer, social posts |
| Right | ~20% | Birthdays + contacts (click to chat) |

Uses native Odoo/Bootstrap colours (inherits light/dark from your system theme). Layout only is custom.

**Resizable columns:** drag the thin dividers between the apps / feed / contacts panels to adjust widths. Your layout is saved in the browser automatically.

```
my_company/
├── models/mycompany_post.py   # Feed, kudos, hub RPC API
├── models/res_users.py        # Startup page + open chat helper
├── static/src/js/             # OWL three-panel client action
└── views/                     # Menus, settings, admin post list
```

Posts inherit `mail.thread` — comments and notifications use standard Odoo mail.

## Roadmap (not in v1)

- @mention autocomplete in composer
- Rich reactions / likes on posts
- Tagging Odoo records (projects, tasks) in posts
- Embedded Discuss panel (instead of navigate-to-chat)
- Manager moderation queue
- Digest email of weekly highlights