fjord_boot_camp 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 688db9e7dcb6975c8ab319f5ce4656d13469b5f3795206143a7bb3b476cdb366
+  data.tar.gz: 50ea78d5d21b11c0637ce3b0cc09953ce0f5e83691a8e6a74c7798e0a80c75a4
+SHA512:
+  metadata.gz: 4a9755de8cdfddb5c6ea3762d258f6585c8b3b07dfec900d9662d48ee00842d6cb415939f107af10b11e648b2994ade472f4574c6d8b0bb8a8c705d7c3f28a28
+  data.tar.gz: 6ee790658dee29968e261e0570521de25b98c7ec5ec3dfbe82bddef3b18502cd8bfd70f9045581d26ba4a61e8a03d56c8b0baa4feb08b68db845b909a7f4c3d4

data/.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3', '3.4']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake test
+
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - name: Run RuboCop
+        run: bundle exec rubocop

data/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3', '3.4']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake test
+
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - name: Run RuboCop
+        run: bundle exec rubocop
+
+  release:
+    needs: [test, rubocop]
+    runs-on: ubuntu-latest
+    environment: release
+
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "3.4.4"

data/.rubocop.yml

@@ -0,0 +1,49 @@
+plugins:
+  - rubocop-minitest
+
+AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  SuggestExtensions: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/FrozenStringLiteralComment:
+  Enabled: true
+
+Style/SafeNavigationChainLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 50
+
+Metrics/AbcSize:
+  Max: 50
+
+Metrics/ClassLength:
+  Max: 300
+
+Metrics/CyclomaticComplexity:
+  Max: 25
+
+Metrics/PerceivedComplexity:
+  Max: 25
+
+Metrics/BlockLength:
+  Max: 50
+
+Layout/LineLength:
+  Max: 180
+
+Naming/MethodParameterName:
+  MinNameLength: 1
+
+Naming/VariableNumber:
+  Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false
+
+Minitest/MultipleAssertions:
+  Max: 10

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,85 @@
+PATH
+  remote: .
+  specs:
+    fjord_boot_camp (0.1.0)
+      faraday (>= 1.0, < 3.0)
+      thor (~> 1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.8.9)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.0.1)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    faraday (2.14.1)
+      faraday-net_http (>= 2.0, < 3.5)
+      json
+      logger
+    faraday-net_http (3.4.2)
+      net-http (~> 0.5)
+    hashdiff (1.2.1)
+    json (2.19.2)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    minitest (5.27.0)
+    net-http (0.9.1)
+      uri (>= 0.11.1)
+    parallel (1.27.0)
+    parser (3.3.10.2)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    regexp_parser (2.11.3)
+    rexml (3.4.4)
+    rubocop (1.86.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-minitest (0.39.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.38.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    thor (1.5.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    uri (1.1.1)
+    webmock (3.26.2)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+  x86_64-darwin-25
+
+DEPENDENCIES
+  fjord_boot_camp!
+  minitest (~> 5.0)
+  rake (~> 13.0)
+  rubocop (~> 1.0)
+  rubocop-minitest (~> 0.36)
+  webmock (~> 3.0)
+
+BUNDLED WITH
+   2.6.7

data/README.md

@@ -0,0 +1,90 @@
+# fjord_boot_camp
+
+FJORD BOOT CAMP API の Ruby クライアント。ライブラリとしても CLI としても使える。
+
+## インストール
+
+```ruby
+gem install fjord_boot_camp
+```
+
+または Gemfile に追加:
+
+```ruby
+gem "fjord_boot_camp"
+```
+
+## セットアップ
+
+環境変数を設定:
+
+```bash
+export BOOTCAMP_URL="https://bootcamp.fjord.jp"
+export BOOTCAMP_ACCESS_TOKEN="your-oauth-token"
+```
+
+## CLI で使う
+
+```bash
+# 最近の日報
+fjord_boot_camp reports recent
+
+# 日報一覧（JSON出力）
+fjord_boot_camp reports list --format json --limit 10
+
+# 日報詳細
+fjord_boot_camp reports show 12345
+
+# ユーザー一覧
+fjord_boot_camp users list --target trainee
+
+# 研修生の週次進捗レポート
+fjord_boot_camp progress
+fjord_boot_camp progress --week-start 2026-03-16
+fjord_boot_camp progress --company-id 1
+
+# JSON出力（AIエージェント向き）
+fjord_boot_camp progress --format json
+```
+
+## ライブラリとして使う
+
+```ruby
+require "fjord_boot_camp"
+
+FjordBootCamp.configure do |config|
+  config.base_url = "https://bootcamp.fjord.jp"
+  config.access_token = "your-oauth-token"
+end
+
+client = FjordBootCamp.client
+
+# 日報
+reports = client.reports.list(limit: 10)
+report = client.reports.find(12345)
+recent = client.reports.recent
+
+# ユーザー
+trainees = client.users.trainees
+user = client.users.find(1)
+
+# プラクティス
+practices = client.practices.list
+
+# 研修生進捗
+progress = client.trainee_progresses.list
+progress = client.trainee_progresses.list(week_start: "2026-03-16", company_id: 1)
+```
+
+## 開発
+
+```bash
+git clone https://github.com/fjordllc/fjord_boot_camp.git
+cd fjord_boot_camp
+bin/setup
+bin/console
+```
+
+## License
+
+MIT

data/Rakefile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'fjord_boot_camp'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/fjord_boot_camp

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'fjord_boot_camp'
+require 'fjord_boot_camp/cli'
+
+FjordBootCamp::CLI.start(ARGV)

data/fjord_boot_camp.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fjord_boot_camp/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'fjord_boot_camp'
+  spec.version       = FjordBootCamp::VERSION
+  spec.authors       = ['komagata']
+  spec.email         = ['komagata@gmail.com']
+
+  spec.summary       = 'Ruby client for FJORD BOOT CAMP API'
+  spec.description   = 'A Ruby gem to interact with the FJORD BOOT CAMP API. Provides both a library and CLI for accessing reports, users, practices, and trainee progress data.'
+  spec.homepage      = 'https://github.com/fjordllc/fjord_boot_camp'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.1.0'
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/fjordllc/fjord_boot_camp'
+  spec.metadata['rubygems_mfa_required'] = 'true'
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = ['fjord_boot_camp']
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'faraday', '>= 1.0', '< 3.0'
+  spec.add_dependency 'thor', '~> 1.0'
+
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rubocop', '~> 1.0'
+  spec.add_development_dependency 'rubocop-minitest', '~> 0.36'
+  spec.add_development_dependency 'webmock', '~> 3.0'
+end

data/lib/fjord_boot_camp/cli.rb

@@ -0,0 +1,220 @@
+# frozen_string_literal: true
+
+require 'thor'
+require 'json'
+
+module FjordBootCamp
+  class CLI < Thor
+    class_option :url, type: :string, desc: 'Base URL (default: $BOOTCAMP_URL or https://bootcamp.fjord.jp)'
+    class_option :token, type: :string, desc: 'Access token (default: $BOOTCAMP_ACCESS_TOKEN)'
+    class_option :format, type: :string, default: 'text', enum: %w[text json], desc: 'Output format'
+
+    desc 'reports [list|show ID]', '日報を取得'
+    option :user_id, type: :numeric, desc: 'ユーザーIDで絞り込み'
+    option :limit, type: :numeric, desc: '取得件数'
+    option :page, type: :numeric, desc: 'ページ番号'
+    def reports(subcommand = 'list', id = nil)
+      case subcommand
+      when 'list'
+        data = client.reports.list(
+          user_id: options[:user_id],
+          limit: options[:limit],
+          page: options[:page]
+        )
+        if json_output?
+          puts JSON.pretty_generate(data)
+        else
+          print_reports(data['reports'] || data)
+        end
+      when 'show'
+        abort 'Usage: fjord_boot_camp reports show ID' unless id
+        data = client.reports.find(id)
+        json_output? ? puts(JSON.pretty_generate(data)) : print_report_detail(data)
+      when 'recent'
+        data = client.reports.recent
+        if json_output?
+          puts JSON.pretty_generate(data)
+        else
+          print_reports(data['reports'] || data)
+        end
+      else
+        abort "Unknown subcommand: #{subcommand}. Use: list, show, recent"
+      end
+    end
+
+    desc 'users [list|show ID]', 'ユーザーを取得'
+    option :target, type: :string, desc: 'フィルタ (student, trainee, mentor, adviser, graduate等)'
+    option :page, type: :numeric, desc: 'ページ番号'
+    def users(subcommand = 'list', id = nil)
+      case subcommand
+      when 'list'
+        data = client.users.list(target: options[:target], page: options[:page])
+        if json_output?
+          puts JSON.pretty_generate(data)
+        else
+          print_users(data['users'] || data)
+        end
+      when 'show'
+        abort 'Usage: fjord_boot_camp users show ID' unless id
+        data = client.users.find(id)
+        json_output? ? puts(JSON.pretty_generate(data)) : print_user_detail(data)
+      when 'trainees'
+        data = client.users.trainees
+        json_output? ? puts(JSON.pretty_generate(data)) : print_users(data['users'] || data)
+      else
+        abort "Unknown subcommand: #{subcommand}. Use: list, show, trainees"
+      end
+    end
+
+    desc 'practices [list|show ID]', 'プラクティスを取得'
+    def practices(subcommand = 'list', id = nil)
+      case subcommand
+      when 'list'
+        data = client.practices.list
+        json_output? ? puts(JSON.pretty_generate(data)) : print_practices(data['practices'] || data)
+      when 'show'
+        abort 'Usage: fjord_boot_camp practices show ID' unless id
+        data = client.practices.find(id)
+        puts JSON.pretty_generate(data)
+      else
+        abort "Unknown subcommand: #{subcommand}. Use: list, show"
+      end
+    end
+
+    desc 'progress', '研修生の週次進捗レポート'
+    option :week_start, type: :string, desc: '対象週の開始日 (例: 2026-03-23)'
+    option :company_id, type: :numeric, desc: '企業IDで絞り込み'
+    def progress
+      data = client.trainee_progresses.list(
+        week_start: options[:week_start],
+        company_id: options[:company_id]
+      )
+      json_output? ? puts(JSON.pretty_generate(data)) : print_progress_report(data)
+    end
+
+    desc 'version', 'バージョンを表示'
+    def version
+      puts "fjord_boot_camp #{FjordBootCamp::VERSION}"
+    end
+
+    private
+
+    def client
+      config = FjordBootCamp::Configuration.new
+      config.base_url = options[:url] if options[:url]
+      config.access_token = options[:token] if options[:token]
+      FjordBootCamp::Client.new(config)
+    end
+
+    def json_output?
+      options[:format] == 'json'
+    end
+
+    def print_reports(reports)
+      reports.each do |r|
+        emoji = { 'positive' => '😄', 'neutral' => '😐', 'negative' => '😢' }[r['emotion']] || '📝'
+        wip = r['wip'] ? ' [WIP]' : ''
+        user = r.dig('user', 'longName') || r.dig('user', 'login_name') || ''
+        puts "#{emoji} #{r['reportedOn']} #{r['title']}#{wip} (#{user})"
+        puts "   #{r['url']}" if r['url']
+      end
+    end
+
+    def print_report_detail(r)
+      puts '=' * 60
+      puts "📝 #{r['title']}"
+      puts "   日付: #{r['reportedOn']}"
+      puts "   URL: #{r['url']}"
+      user = r['user']
+      puts "   著者: #{user['longName'] || user['login_name']}" if user
+      puts '-' * 60
+      puts r['description'] if r['description']
+      if r['comments']&.any?
+        puts
+        puts "💬 コメント (#{r['comments'].size}件)"
+        r['comments'].each do |c|
+          author = c.dig('user', 'longName') || c.dig('user', 'login_name') || '?'
+          puts "  #{author}: #{c['description']&.lines&.first&.strip}"
+        end
+      end
+      puts '=' * 60
+    end
+
+    def print_users(users)
+      users.each do |u|
+        role = u['primaryRole'] || u['roles']&.first || ''
+        company = u.dig('company', 'url') ? " (#{u.dig('company', 'url')})" : ''
+        puts "👤 #{u['longName'] || u['login_name']} [#{role}]#{company}"
+      end
+    end
+
+    def print_user_detail(u)
+      puts "👤 #{u['longName'] || u['login_name']}"
+      puts "   ログイン名: #{u['login_name']}"
+      puts "   ロール: #{u['roles']&.join(', ')}"
+    end
+
+    def print_practices(practices)
+      practices.each do |p|
+        puts "📚 #{p['id']}: #{p['title']}"
+      end
+    end
+
+    def print_progress_report(data)
+      puts '=' * 60
+      puts "📊 研修生週次レポート #{data['weekStart']} 〜 #{data['weekEnd']}"
+      puts '=' * 60
+      puts
+
+      (data['trainees'] || []).each do |t|
+        activity = t['weeklyActivity'] || {}
+        current = t['currentPractice'] || {}
+        overall = t['overallProgress'] || {}
+        company = t.dig('company', 'name') || '所属なし'
+        course = t.dig('course', 'title') || ''
+
+        report_count = activity['reportCount'] || 0
+        weekdays = activity['weekdays'] || 5
+        percentage = overall['completedPercentage'] || 0
+
+        # ステータス判定
+        status = if report_count >= 4
+                   '✅'
+                 elsif report_count >= 2
+                   '⚠️'
+                 else
+                   '🔴'
+                 end
+
+        puts "■ #{t['longName']}（#{company}）- #{course} [#{percentage}%]"
+        puts "  日報: #{report_count}/#{weekdays}日 #{status}"
+
+        # 今週の変化
+        changes = activity['practiceChanges'] || []
+        changes.each do |c|
+          case c['status']
+          when 'complete'
+            puts "  今週: 「#{c['practiceTitle']}」完了 🎉"
+          when 'submitted'
+            puts "  今週: 「#{c['practiceTitle']}」提出"
+          when 'started'
+            puts "  今週: 「#{c['practiceTitle']}」着手"
+          end
+        end
+
+        # 現在のプラクティス
+        if current['title']
+          days = current['daysOnPractice'] || 0
+          slow = if days >= 14
+                   ' 🐢'
+                 else
+                   days >= 7 ? ' ⏳' : ''
+                 end
+          puts "  現在: 「#{current['title']}」（#{days}日目#{slow}）"
+        end
+
+        puts
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/client.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+
+module FjordBootCamp
+  class Client
+    attr_reader :configuration
+
+    def initialize(configuration = nil)
+      @configuration = configuration || FjordBootCamp.configuration || Configuration.new
+    end
+
+    def reports
+      Resources::Reports.new(self)
+    end
+
+    def users
+      Resources::Users.new(self)
+    end
+
+    def practices
+      Resources::Practices.new(self)
+    end
+
+    def trainee_progresses
+      Resources::TraineeProgresses.new(self)
+    end
+
+    def get(path, params = {})
+      response = connection.get(path, params)
+      handle_response(response)
+    end
+
+    private
+
+    def connection
+      @connection ||= Faraday.new(url: configuration.base_url) do |f|
+        f.headers['Authorization'] = "Bearer #{configuration.access_token}" if configuration.access_token
+        f.headers['Accept'] = 'application/json'
+        f.adapter Faraday.default_adapter
+      end
+    end
+
+    def handle_response(response)
+      case response.status
+      when 200..299
+        JSON.parse(response.body)
+      when 401
+        raise AuthenticationError, 'Authentication failed. Check your access token.'
+      when 404
+        raise NotFoundError, "Resource not found: #{response.env.url.path}"
+      else
+        raise ApiError, "API error (#{response.status}): #{response.body}"
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/configuration.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FjordBootCamp
+  class Configuration
+    attr_accessor :base_url, :access_token
+
+    def initialize
+      @base_url = ENV.fetch('BOOTCAMP_URL', 'https://bootcamp.fjord.jp')
+      @access_token = ENV.fetch('BOOTCAMP_ACCESS_TOKEN', nil)
+    end
+  end
+end

data/lib/fjord_boot_camp/resources/base.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module FjordBootCamp
+  module Resources
+    class Base
+      attr_reader :client
+
+      def initialize(client)
+        @client = client
+      end
+
+      private
+
+      def get(path, params = {})
+        client.get(path, params)
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/resources/practices.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module FjordBootCamp
+  module Resources
+    class Practices < Base
+      # プラクティス一覧を取得
+      def list
+        get('/api/practices')
+      end
+
+      # プラクティス詳細を取得
+      # @param id [Integer] プラクティスID
+      def find(id)
+        get("/api/practices/#{id}")
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/resources/reports.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module FjordBootCamp
+  module Resources
+    class Reports < Base
+      # 日報一覧を取得
+      # @param user_id [Integer, nil] ユーザーIDで絞り込み
+      # @param practice_id [Integer, nil] プラクティスIDで絞り込み
+      # @param company_id [Integer, nil] 企業IDで絞り込み
+      # @param limit [Integer, nil] 取得件数
+      # @param page [Integer, nil] ページ番号
+      def list(user_id: nil, practice_id: nil, company_id: nil, limit: nil, page: nil)
+        params = {}
+        params[:user_id] = user_id if user_id
+        params[:practice_id] = practice_id if practice_id
+        params[:company_id] = company_id if company_id
+        params[:limit] = limit if limit
+        params[:page] = page if page
+        get('/api/reports', params)
+      end
+
+      # 日報詳細を取得（コメント・プラクティス付き）
+      # @param id [Integer] 日報ID
+      def find(id)
+        get("/api/reports/#{id}")
+      end
+
+      # 最近の日報を取得（直近20件）
+      def recent
+        get('/api/reports/recents')
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/resources/trainee_progresses.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module FjordBootCamp
+  module Resources
+    class TraineeProgresses < Base
+      # 研修生の週次進捗を取得
+      # @param week_start [String, nil] 対象週の開始日 (例: "2026-03-23")。省略時は今週
+      # @param company_id [Integer, nil] 企業IDで絞り込み
+      def list(week_start: nil, company_id: nil)
+        params = {}
+        params[:week_start] = week_start if week_start
+        params[:company_id] = company_id if company_id
+        get('/api/trainee_progresses', params)
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/resources/users.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module FjordBootCamp
+  module Resources
+    class Users < Base
+      # ユーザー一覧を取得
+      # @param target [String, nil] フィルタ (student, trainee, student_and_trainee, mentor, adviser, graduate等)
+      # @param company_id [Integer, nil] 企業IDで絞り込み
+      # @param tag [String, nil] タグで絞り込み
+      # @param page [Integer, nil] ページ番号
+      def list(target: nil, company_id: nil, tag: nil, page: nil)
+        params = {}
+        params[:target] = target if target
+        params[:company_id] = company_id if company_id
+        params[:tag] = tag if tag
+        params[:page] = page if page
+        get('/api/users', params)
+      end
+
+      # ユーザー詳細を取得
+      # @param id [Integer] ユーザーID
+      def find(id)
+        get("/api/users/#{id}")
+      end
+
+      # 研修生一覧を取得
+      def trainees
+        list(target: 'trainee')
+      end
+
+      # メンター一覧を取得
+      def mentors
+        list(target: 'mentor')
+      end
+    end
+  end
+end

data/lib/fjord_boot_camp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FjordBootCamp
+  VERSION = '0.1.0'
+end

data/lib/fjord_boot_camp.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'fjord_boot_camp/version'
+require 'fjord_boot_camp/configuration'
+require 'fjord_boot_camp/client'
+require 'fjord_boot_camp/resources/reports'
+require 'fjord_boot_camp/resources/users'
+require 'fjord_boot_camp/resources/practices'
+require 'fjord_boot_camp/resources/trainee_progresses'
+
+module FjordBootCamp
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class NotFoundError < Error; end
+  class ApiError < Error; end
+
+  class << self
+    attr_accessor :configuration
+
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration)
+    end
+
+    def client
+      @client = nil if @client&.configuration != configuration
+      @client ||= Client.new(configuration)
+    end
+
+    def reset!
+      @client = nil
+      self.configuration = nil
+    end
+  end
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: fjord_boot_camp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- komagata
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.36'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.36'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: A Ruby gem to interact with the FJORD BOOT CAMP API. Provides both a
+  library and CLI for accessing reports, users, practices, and trainee progress data.
+email:
+- komagata@gmail.com
+executables:
+- fjord_boot_camp
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
+- ".gitignore"
+- ".mise.toml"
+- ".rubocop.yml"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/fjord_boot_camp
+- fjord_boot_camp.gemspec
+- lib/fjord_boot_camp.rb
+- lib/fjord_boot_camp/cli.rb
+- lib/fjord_boot_camp/client.rb
+- lib/fjord_boot_camp/configuration.rb
+- lib/fjord_boot_camp/resources/base.rb
+- lib/fjord_boot_camp/resources/practices.rb
+- lib/fjord_boot_camp/resources/reports.rb
+- lib/fjord_boot_camp/resources/trainee_progresses.rb
+- lib/fjord_boot_camp/resources/users.rb
+- lib/fjord_boot_camp/version.rb
+homepage: https://github.com/fjordllc/fjord_boot_camp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/fjordllc/fjord_boot_camp
+  source_code_uri: https://github.com/fjordllc/fjord_boot_camp
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Ruby client for FJORD BOOT CAMP API
+test_files: []