Onboarding

Table of Contents

• Introduction
• Services to Open
• APC
• Team Organization & Project Management
• Rocket Chat
• Repositories
• Developer Resources

Introduction⇧

This section is designed to guide you through your first steps on the project. You’ll find key information and useful resources to help you get started in the best possible conditions.

See the presentation given at the ESUP Days in April 2025.

Feel free to let us know if anything is missing or unclear.

Services to Open⇧

Note: these services need to be opened by our team (manual labor required!).

• Create account in RECIA LDAP
• add to group for RENATER services
• add to group for Nextcloud RECIA
• Send email to explain/provide:
  • RECIA login + password
  • activating RECIA account
  • checking access on RENATER account attributes using the rigth IDP.
  • first access RocketChat
• RocketChat ESUP channels (development and functional).
• BBB ESUP.
• VPN RECIA: required to access the development server via ssh with a key ED25519.
• Team’s Password manager: VaultWarden (invitation sent by email) - Organization + collection access
• GitHub (add account to group).
• Dev-doc.
• Srv-dev.

APC⇧

• In French, APC: Approche Par Compétences.

• In English, CBA: Competency-Based Approach.

• Avenirs-ESR Official site
• ESUP-ORA (CBA Modeling Tool for Teachers)
• CBA Glossary
• FAQ

Team Organization & Project Management⇧

• Project roadmap

[TODO]: This section needs to be finalized, and some details need to be clarified.

• Sprint duration: 3 weeks.
• AMOA Backlog management: AMOA project board on GitHub
• Backlog management: project board on GitHub
• Weekly Meetings: ESUP BBB
• Daily: ESUP BBB
• Chat:
  • Development Channel on RocketChat
  • Functional Channel on RocketChat

RocketChat⇧

When you log on to RocketChat, we strongly advise you to add a front_team or back_team tag (depending on your preference) to your user settings. That way, you’ll be notified along with the whole team whenever you need to be.

To achieve this, click on your avatar on top left corner > under Account, select Preferences > go to En vedette and add the tags you want.

If you need to tag either team, simply write front_team or back_team in your message.

⚠️ Be careful not to put @ before it, as this will prevent the tag from working.

Repositories⇧

• AVENIRS-Project: hosts GitHub projects for project management.
• dev-doc: repository for this documentation (based on GitHub Pages).
• srv-dev: repository for the development environment.
• avenirs-deployment: scripts to deploy the srv-dev for different environments.
• avenirs-portfolio-api: repository for the portfolio domain API.
• avenirs-cofolio-client: repository for the user interface.
• avenirs-workflows: repository for reusable GitHub actions & workflows.
• avenirs-portfolio-security: repository for the security module (RBAC). Needs deep refactoring.

Developer resources⇧

• Dev Handbook: versions, github workflow, tools, etc.
• Architecture: see the simplified architecture overview diagram.
• Progress report: an opinionated overview of the current status as of April 2025.