FIN Board

💡 Password

The production password is located in Dashlane under "FIN Daily Board".

This is the daily board for the FIN frontend team. It is used to track tasks, progress, and blockers for team members.

Features

What it shows, including the data source:

• 📉 Burndown Charts - Paste or upload sprint burndown screenshots (stored locally)
• 🧩 Kanban Board - Live sprint issues from Constellation Jira
• 📦 Version Calendar - Upcoming FIN releases from Jira
• 💪 Team Actions - Next steps committed by the team from Notion

Prerequisites

• mise (for managing devtools)
• A Jira session cookie (for accessing Constellation Jira)
• Notion API token and database ID (optional, can use mock data)

Setup

1. Install mise (optional, if not already installed)

Go to mise Getting Started and follow the installation instructions for your OS.

2. Clone the repository

git clone https://github.com/bamlab/fin-board.git
cd fin-board

3. Install dependencies

mise install

4. Configure environment variables

Copy the example environment file:

cp .env.example .env.local

Edit .env.local and set your values:

# Notion Configuration (optional - can use mock data)
VITE_NOTION_API_TOKEN=your_notion_integration_token
VITE_NOTION_ACTIONS_DB_ID=your_notion_database_id
VITE_USE_NOTION_MOCK=false  # Set to true to use mock data

# Note: Jira cookie is set in the UI, not here

To get a Notion API token:

1. Go to https://www.notion.so/my-integrations
2. Create a new integration
3. Copy the Internal Integration Token

5. Run the development server

npm run dev

The board will be available at http://localhost:5173

6. Set your Jira cookie

On first load, you'll be prompted to enter your Jira session cookie. To get it:

1. Open https://jira.constellation.soprasteria.com in your browser
2. Log in if needed
3. Open browser DevTools (F12)
4. Go to Application/Storage → Cookies
5. Find cookies containing atlassian, JSESSIONID, or cloud_session
6. Copy the entire cookie string
7. Paste it into the FIN Board UI

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint

Tech Stack

• React 19 - UI framework
• TypeScript - Type safety
• Vite - Build tool and dev server
• TanStack Query - Data fetching and caching
• Jotai - State management
• Tailwind CSS - Styling

Project Structure

src/
├── components/     # React components
├── config/         # Configuration files
├── domain/         # Business logic and types
├── hooks/          # Custom React hooks
├── infra/          # API calls and DTOs
├── pages/          # Page components
└── store/          # Jotai atoms

Contributing

1. Create a feature branch
2. Make your changes
3. Ensure npm run lint passes
4. Submit a pull request

License

Internal BAM project